UY-1572: CR-1374: Rename "export" and "import" endpoints to "db-dump"

- Update REST API paths and documentation to use "/db-dump" for both export and import operations.
- Adapt scripts and unit tests to reflect the new endpoint naming.
- Adjust example requests and other references for consistency.

Author: rkrysinski

.claude/skills/unity-server/scripts/tstserver.sh

@@ -104,7 +104,7 @@ cmd_verify() {
 	fi
 
 	echo "Verifying server health..."
-	if curl -sk -o /dev/null -w "%{http_code}" -u "$AUTH" "$REST_ADMIN_URL/export?systemConfig=false&directorySchema=false&users=false&auditLogs=false&signupRequests=false&idpStatistics=false" | grep -q "200"; then
+	if curl -sk -o /dev/null -w "%{http_code}" -u "$AUTH" "$REST_ADMIN_URL/db-dump?systemConfig=false&directorySchema=false&users=false&auditLogs=false&signupRequests=false&idpStatistics=false" | grep -q "200"; then
 		echo "Server is healthy and responding at $SERVER_URL"
 	else
 		echo "Server is running but REST Admin API is not responding yet"
@@ -119,7 +119,7 @@ cmd_backup() {
 	local params="$*"
 
 	echo "Exporting backup to $output..."
-	local url="$REST_ADMIN_URL/export"
+	local url="$REST_ADMIN_URL/db-dump"
 	if [ -n "$params" ]; then
 		url="$url?$params"
 	fi
@@ -142,7 +142,7 @@ cmd_restore() {
 
 	echo "Restoring from $input..."
 	# Import may cause connection reset as server restarts endpoints — treat both as success
-	curl -sk -u "$AUTH" -X POST "$REST_ADMIN_URL/import" \
+	curl -sk -u "$AUTH" -X POST "$REST_ADMIN_URL/db-dump" \
 		-H "Content-Type: application/json" \
 		-d @"$input" || true
 	echo "Restore request sent. Server endpoints may restart."

documentation/src/main/rest-api/rest-api-v1.txt

@@ -1670,7 +1670,7 @@ Example input:
 
 === Export database backup
 
-+@Path("/export")+ +
++@Path("/db-dump")+ +
 +@QueryParam("systemConfig")+ +
 +@QueryParam("directorySchema")+ +
 +@QueryParam("users")+ +
@@ -1690,8 +1690,6 @@ Parameters:
 - +signupRequests+ (boolean, default: true) -- include pending registration requests
 - +idpStatistics+ (boolean, default: true) -- include IdP usage statistics
 
-Requires +maintenance+ authorization capability (System Manager role).
-
 Example response headers:
 
 ----
@@ -1702,21 +1700,19 @@ Content-Type: application/json
 
 === Import database backup
 
-+@Path("/import")+ +
++@Path("/db-dump")+ +
 +@POST+ +
 
 Imports (restores) the database from a JSON dump provided as the raw request body. The request body must be a valid Unity database dump in JSON format (as produced by the export endpoint). Older dump formats are automatically migrated during import.
 
-Requires +maintenance+ authorization capability (System Manager role).
-
 CAUTION: The import operation restarts internal server endpoints. The calling REST endpoint may be destroyed before the HTTP response is sent, causing the client to receive a connection reset instead of an HTTP 200. Clients should treat both a 200 response and a connection reset as a successful import.
 
 NOTE: Uploads exceeding the server's configured file size limit are rejected with HTTP 413 (Request Entity Too Large). When no static limit is configured, the limit is calculated dynamically as 70% of available JVM heap memory.
 
 Example request:
 
 ----
-POST /rest-admin/v1/import HTTP/1.1
+POST /rest-admin/v1/db-dump HTTP/1.1
 Content-Type: application/json
 
 {...database dump JSON content...}

rest-admin/src/main/java/pl/edu/icm/unity/restadm/BackupRestoreRESTAdmin.java

@@ -61,7 +61,7 @@ public class BackupRestoreRESTAdmin implements RESTAdminHandler
 	}
 
 	@GET
-	@Path("/export")
+	@Path("/db-dump")
 	public Response export(
 			@QueryParam("systemConfig") @DefaultValue("true") boolean systemConfig,
 			@QueryParam("directorySchema") @DefaultValue("true") boolean directorySchema,
@@ -108,7 +108,7 @@ private String createTimestampedFilename()
 	}
 
 	@POST
-	@Path("/import")
+	@Path("/db-dump")
 	@Consumes(MediaType.APPLICATION_JSON)
 	public Response importBackup(InputStream inputStream,
 			@HeaderParam("Content-Length") long contentLength) throws EngineException

rest-admin/src/test/java/pl/edu/icm/unity/restadm/TestBackupRestore.java

@@ -28,7 +28,7 @@ public class TestBackupRestore extends RESTAdminTestBase
 	public void shouldReturnExportDumpWithDefaultCategories() throws Exception
 	{
 		// given
-		HttpGet export = new HttpGet("/restadm/v1/export");
+		HttpGet export = new HttpGet("/restadm/v1/db-dump");
 
 		// when
 		try (ClassicHttpResponse response = client.executeOpen(host, export, getClientContext(host)))
@@ -51,7 +51,7 @@ public void shouldRespectCategorySelection() throws Exception
 	{
 		// given
 		HttpGet export = new HttpGet(
-			"/restadm/v1/export?directorySchema=false&users=false"
+			"/restadm/v1/db-dump?directorySchema=false&users=false"
 				+ "&auditLogs=false&signupRequests=false&idpStatistics=false");
 
 		// when
@@ -69,7 +69,7 @@ public void shouldReturnDumpWhenAllCategoriesExplicitlyEnabled() throws Exceptio
 	{
 		// given
 		HttpGet export = new HttpGet(
-			"/restadm/v1/export?systemConfig=true&directorySchema=true&users=true"
+			"/restadm/v1/db-dump?systemConfig=true&directorySchema=true&users=true"
 				+ "&auditLogs=true&signupRequests=true&idpStatistics=true");
 
 		// when
@@ -86,7 +86,7 @@ public void shouldReturnDumpWhenAllCategoriesExplicitlyEnabled() throws Exceptio
 	public void shouldImportDatabaseFromExportedDump() throws Exception
 	{
 		// given -- first export to get a valid dump
-		HttpGet export = new HttpGet("/restadm/v1/export");
+		HttpGet export = new HttpGet("/restadm/v1/db-dump");
 		String dumpContent;
 		try (ClassicHttpResponse exportResponse = client.executeOpen(host, export, getClientContext(host)))
 		{
@@ -96,7 +96,7 @@ public void shouldImportDatabaseFromExportedDump() throws Exception
 		}
 
 		// when -- import the exported dump back
-		HttpPost importRequest = new HttpPost("/restadm/v1/import");
+		HttpPost importRequest = new HttpPost("/restadm/v1/db-dump");
 		importRequest.setEntity(new StringEntity(dumpContent, ContentType.APPLICATION_JSON));
 		try (ClassicHttpResponse importResponse = client.executeOpen(host, importRequest, getClientContext(host)))
 		{
@@ -118,7 +118,7 @@ public void shouldRejectExportForNonPrivilegedUserWith403() throws Exception
 	{
 		// given
 		HttpClientContext unprivilegedContext = createNonPrivilegedUserContext();
-		HttpGet export = new HttpGet("/restadm/v1/export");
+		HttpGet export = new HttpGet("/restadm/v1/db-dump");
 
 		// when
 		try (ClassicHttpResponse response = client.executeOpen(host, export, unprivilegedContext))
@@ -133,7 +133,7 @@ public void shouldRejectImportForNonPrivilegedUserWith403() throws Exception
 	{
 		// given
 		HttpClientContext unprivilegedContext = createNonPrivilegedUserContext();
-		HttpPost importRequest = new HttpPost("/restadm/v1/import");
+		HttpPost importRequest = new HttpPost("/restadm/v1/db-dump");
 		importRequest.setEntity(new StringEntity("{}", ContentType.APPLICATION_JSON));
 
 		// when