Netcracker
diff --git a/‎docs/api/APIHUB_API.yaml‎
Lines changed: 1336 additions & 903 deletions b/‎docs/api/APIHUB_API.yaml‎
Lines changed: 1336 additions & 903 deletions
diff --git a/‎docs/api/APIHUB_API_internal.yaml‎
Lines changed: 822 additions & 847 deletions b/‎docs/api/APIHUB_API_internal.yaml‎
Lines changed: 822 additions & 847 deletions
diff --git a/‎docs/api/Admin API.yaml‎
Lines changed: 781 additions & 124 deletions b/‎docs/api/Admin API.yaml‎
Lines changed: 781 additions & 124 deletions
diff --git a/‎docs/api/Admin_API_internal.yaml‎
Lines changed: 743 additions & 0 deletions b/‎docs/api/Admin_API_internal.yaml‎
Lines changed: 743 additions & 0 deletions
diff --git a/‎docs/postgres_useful_queries/apihub-postgresql_dev.sh‎
Lines changed: 1 addition & 1 deletion b/‎docs/postgres_useful_queries/apihub-postgresql_dev.sh‎
Lines changed: 1 addition & 1 deletion
diff --git a/‎qubership-apihub-service/Service.go‎
Lines changed: 17 additions & 9 deletions b/‎qubership-apihub-service/Service.go‎
Lines changed: 17 additions & 9 deletions
diff --git a/‎qubership-apihub-service/archive/BuildResultArchive.go‎
Lines changed: 64 additions & 32 deletions b/‎qubership-apihub-service/archive/BuildResultArchive.go‎
Lines changed: 64 additions & 32 deletions
@@ -5,7 +5,7 @@ kubectl config set-credentials admin/k8s-server --token="K8S_TOKEN_HERE"
 kubectl config set-context context-admin/k8s-server --user=admin/k8s-server --namespace=apihub-postgresql --cluster=k8s-server
 kubectl config use-context context-admin/k8s-server
 
-MAIN_POD_ID=$(kubectl get pods -l pgtype=master -o name 2>/dev/null | grep -Po "(pg-patroni-.*?-.*?-.*?\$)")
+MAIN_POD_ID=$(kubectl get pods -l pgtype=master -o name 2>/dev/null | grep -Po "(pg-patroni-.*?\$)")
 echo "main pod = $MAIN_POD_ID"
 
 kubectl port-forward $MAIN_POD_ID 15432:5432
@@ -329,16 +329,17 @@ func main() {
 	dataMigrationController := mController.NewTempMigrationController(dbMigrationService, roleService.IsSysadm)
 	activityTrackingController := controller.NewActivityTrackingController(activityTrackingService, roleService, ptHandler)
 	comparisonController := controller.NewComparisonController(operationService, versionService, buildService, roleService, comparisonService, monitoringService, ptHandler)
-	buildCleanupController := controller.NewBuildCleanupController(dbCleanupService, roleService.IsSysadm)
 	transitionController := controller.NewTransitionController(transitionService, roleService.IsSysadm)
 	businessMetricController := controller.NewBusinessMetricController(businessMetricService, excelService, roleService.IsSysadm)
 	transformationController := controller.NewTransformationController(roleService, buildService, versionService, transformationService, operationGroupService)
-	minioStorageController := controller.NewMinioStorageController(minioStorageCreds, minioStorageService)
+	minioStorageController := controller.NewMinioStorageController(minioStorageCreds, minioStorageService, roleService)
 	personalAccessTokenController := controller.NewPersonalAccessTokenController(personalAccessTokenService)
 	packageExportConfigController := controller.NewPackageExportConfigController(roleService, packageExportConfigService, ptHandler)
 	systemStatsController := controller.NewSystemStatsController(systemStatsService, roleService)
+	internalDocsController := controller.NewInternalDocumentController(publishedService, roleService)
 	mcpController := controller.NewMCPController(mcpService)
 	chatController := controller.NewChatController(chatService)
+	buildController := controller.NewBuildController(buildResultService, buildService, roleService.IsSysadm)
 
 	r.HandleFunc("/api/v1/system/info", security.Secure(systemInfoController.GetSystemInfo)).Methods(http.MethodGet)
 	r.HandleFunc("/api/v1/system/configuration", samlAuthController.GetSystemSSOInfo_deprecated).Methods(http.MethodGet) //deprecated
@@ -361,7 +362,7 @@ func main() {
 	r.HandleFunc("/api/v2/packages/{packageId}", security.Secure(packageController.GetPackage)).Methods(http.MethodGet)
 	r.HandleFunc("/api/v2/packages/{packageId}/status", security.Secure(packageController.GetPackageStatus)).Methods(http.MethodGet)
 	r.HandleFunc("/api/v2/packages", security.Secure(packageController.GetPackagesList)).Methods(http.MethodGet)
-	r.HandleFunc("/api/v2/packages/{packageId}/publish/availableStatuses", security.Secure(packageController.GetAvailableVersionStatusesForPublish)).Methods(http.MethodGet)
+	r.HandleFunc("/api/v2/packages/{packageId}/publish/availableStatuses", security.Secure(packageController.GetAvailableVersionStatusesForPublish_deprecated)).Methods(http.MethodGet) // deprecated
 
 	r.HandleFunc("/api/v4/packages/{packageId}/apiKeys", security.Secure(apihubApiKeyController.GetApiKeys)).Methods(http.MethodGet)
 	r.HandleFunc("/api/v4/packages/{packageId}/apiKeys", security.Secure(apihubApiKeyController.CreateApiKey)).Methods(http.MethodPost)
@@ -394,15 +395,15 @@ func main() {
 
 	r.HandleFunc("/api/v2/packages/{packageId}/versions/{version}/files/{slug}/raw", security.Secure(versionController.GetVersionedContentFileRaw)).Methods(http.MethodGet)
 	r.HandleFunc("/api/v2/sharedFiles/{sharedFileId}", security.NoSecure(versionController.GetSharedContentFile)).Methods(http.MethodGet)
-	r.HandleFunc("/api/v2/packages/{packageId}/versions/{version}/changes", security.Secure(versionController.GetVersionChanges)).Methods(http.MethodGet)
-	r.HandleFunc("/api/v2/packages/{packageId}/versions/{version}/problems", security.Secure(versionController.GetVersionProblems)).Methods(http.MethodGet)
+	r.HandleFunc("/api/v2/packages/{packageId}/versions/{version}/changes", security.Secure(versionController.GetVersionChanges_deprecated)).Methods(http.MethodGet)   // deprecated
+	r.HandleFunc("/api/v2/packages/{packageId}/versions/{version}/problems", security.Secure(versionController.GetVersionProblems_deprecated)).Methods(http.MethodGet) // deprecated
 	r.HandleFunc("/api/v2/sharedFiles", security.Secure(versionController.SharePublishedFile)).Methods(http.MethodPost)
 
 	r.HandleFunc("/api/v2/packages/{packageId}/versions/{version}/doc", security.Secure(exportController.GenerateVersionDoc)).Methods(http.MethodGet)           // deprecated
 	r.HandleFunc("/api/v2/packages/{packageId}/versions/{version}/files/{slug}/doc", security.Secure(exportController.GenerateFileDoc)).Methods(http.MethodGet) // deprecated
 
-	r.HandleFunc("/api/v2/auth/saml", security.NoSecure(samlAuthController.StartSamlAuthentication_deprecated)).Methods(http.MethodGet) // deprecated.
-	r.HandleFunc("/login/sso/saml", security.RefreshToken(samlAuthController.StartSamlAuthentication_deprecated)).Methods(http.MethodGet)
+	r.HandleFunc("/api/v2/auth/saml", security.NoSecure(samlAuthController.StartSamlAuthentication_deprecated)).Methods(http.MethodGet)   // deprecated
+	r.HandleFunc("/login/sso/saml", security.RefreshToken(samlAuthController.StartSamlAuthentication_deprecated)).Methods(http.MethodGet) // deprecated
 	r.HandleFunc("/saml/acs", security.NoSecure(samlAuthController.AssertionConsumerHandler_deprecated)).Methods(http.MethodPost)
 	r.HandleFunc("/saml/metadata", security.NoSecure(samlAuthController.ServeMetadata_deprecated)).Methods(http.MethodGet)
 
@@ -442,6 +443,7 @@ func main() {
 	r.HandleFunc("/api/v2/packages/{packageId}/versions/{version}/{apiType}/deprecated", security.Secure(operationController.GetDeprecatedOperationsList)).Methods(http.MethodGet)
 	r.HandleFunc("/api/v2/packages/{packageId}/versions/{version}/{apiType}/operations/{operationId}/deprecatedItems", security.Secure(operationController.GetOperationDeprecatedItems)).Methods(http.MethodGet)
 	r.HandleFunc("/api/v2/packages/{packageId}/versions/{version}/deprecated/summary", security.Secure(operationController.GetDeprecatedOperationsSummary)).Methods(http.MethodGet)
+	r.HandleFunc("/api/v2/packages/{packageId}/versions/{version}/{apiType}/operations/{operationId}/changes/summary", security.Secure(operationController.GetOperationChangesSummary)).Methods(http.MethodGet)
 
 	r.HandleFunc("/api/v3/packages/{packageId}/versions/{version}/documents/{slug}", security.Secure(versionController.GetVersionedDocument)).Methods(http.MethodGet)
 	r.HandleFunc("/api/v2/packages/{packageId}/versions/{version}/documents", security.Secure(versionController.GetVersionDocuments)).Methods(http.MethodGet)
@@ -479,14 +481,15 @@ func main() {
 	r.HandleFunc("/api/internal/migrate/operations/{migrationId}/suspiciousBuilds", security.Secure(dataMigrationController.GetSuspiciousBuilds)).Methods(http.MethodGet)
 	r.HandleFunc("/api/internal/migrate/operations/{migrationId}/perf", security.Secure(dataMigrationController.GetMigrationPerfReport)).Methods(http.MethodGet)
 	r.HandleFunc("/api/internal/migrate/operations/cancel", security.Secure(dataMigrationController.CancelRunningMigrations)).Methods(http.MethodPost)
-	r.HandleFunc("/api/internal/migrate/operations/cleanup", security.Secure(buildCleanupController.StartMigrationBuildCleanup)).Methods(http.MethodPost)
-	r.HandleFunc("/api/internal/migrate/operations/cleanup/{id}", security.Secure(buildCleanupController.GetMigrationBuildCleanupResult)).Methods(http.MethodGet)
 
 	r.HandleFunc("/api/v2/admin/transition/move", security.Secure(transitionController.MoveOrRenamePackage)).Methods(http.MethodPost)
 	r.HandleFunc("/api/v2/admin/transition/move/{id}", security.Secure(transitionController.GetMoveStatus)).Methods(http.MethodGet)
 	r.HandleFunc("/api/v2/admin/transition/activity", security.Secure(transitionController.ListActivities)).Methods(http.MethodGet)
 	r.HandleFunc("/api/v2/admin/transition", security.Secure(transitionController.ListPackageTransitions)).Methods(http.MethodGet)
 
+	r.HandleFunc("/api/v2/admin/builds/{buildId}/result", security.Secure(buildController.GetBuildResult)).Methods(http.MethodGet)
+	r.HandleFunc("/api/v2/admin/builds/{buildId}/sources", security.Secure(buildController.GetBuildSources)).Methods(http.MethodGet)
+
 	r.HandleFunc("/api/v2/admin/system/stats", security.Secure(systemStatsController.GetSystemStats)).Methods(http.MethodGet)
 
 	r.HandleFunc("/api/v2/compare", security.Secure(comparisonController.CompareTwoVersions)).Methods(http.MethodPost)
@@ -522,6 +525,11 @@ func main() {
 	r.HandleFunc("/api/v1/deleted/packages/{packageId}/versions", security.Secure(versionController.GetDeletedPackageVersionsList)).Methods(http.MethodGet)
 	r.HandleFunc("/api/v1/deleted/packages/{packageId}/versions/{version}", security.Secure(versionController.GetDeletedPackageVersionContent)).Methods(http.MethodGet)
 
+	r.HandleFunc("/api/v1/packages/{packageId}/versions/{version}/version-internal-documents", security.Secure(internalDocsController.GetVersionInternalDocuments)).Methods(http.MethodGet)
+	r.HandleFunc("/api/v1/version-internal-documents/{hash}", security.Secure(internalDocsController.GetVersionInternalDocumentData)).Methods(http.MethodGet)
+	r.HandleFunc("/api/v1/packages/{packageId}/versions/{version}/comparison-internal-documents", security.Secure(internalDocsController.GetComparisonInternalDocuments)).Methods(http.MethodGet)
+	r.HandleFunc("/api/v1/comparison-internal-documents/{hash}", security.Secure(internalDocsController.GetComparisonInternalDocumentData)).Methods(http.MethodGet)
+
 	//debug + cleanup
 	if !systemInfoService.GetSystemInfo().ProductionMode {
 		r.HandleFunc("/api/internal/users/{userId}/systemRole", security.Secure(roleController.TestSetUserSystemRole)).Methods(http.MethodPost)
 
@@ -25,47 +25,59 @@ import (
 )
 
 const (
-	InfoFilePath                 = "info.json"
-	DocumentsFilePath            = "documents.json"
-	ComparisonsFilePath          = "comparisons.json"
-	OperationsFilePath           = "operations.json"
-	BuilderNotificationsFilePath = "notifications.json"
-	ChangelogFilePath            = "changelog.json"
-
-	DocumentsRootFolder      = "documents/"
-	ComparisonsRootFolder    = "comparisons/"
-	OperationFilesRootFolder = "operations/"
+	InfoFilePath                        = "info.json"
+	DocumentsFilePath                   = "documents.json"
+	ComparisonsFilePath                 = "comparisons.json"
+	OperationsFilePath                  = "operations.json"
+	BuilderNotificationsFilePath        = "notifications.json"
+	ChangelogFilePath                   = "changelog.json"
+	VersionInternalDocumentsFilePath    = "version-internal-documents.json"
+	ComparisonInternalDocumentsFilePath = "comparison-internal-documents.json"
+
+	DocumentsRootFolder                   = "documents/"
+	ComparisonsRootFolder                 = "comparisons/"
+	OperationFilesRootFolder              = "operations/"
+	VersionInternalDocumentsRootFolder    = "version-internal-documents/"
+	ComparisonInternalDocumentsRootFolder = "comparison-internal-documents/"
 )
 
 type BuildResultArchive struct {
 	ZipReader *zip.Reader
 
-	InfoFile                 *zip.File
-	DocumentsFile            *zip.File
-	ComparisonsFile          *zip.File
-	OperationsFile           *zip.File
-	BuilderNotificationsFile *zip.File
-	ChangelogFile            *zip.File
-
-	DocumentsHeaders         map[string]*zip.File
-	OperationFileHeaders     map[string]*zip.File
-	ComparisonsFileHeaders   map[string]*zip.File
-	UncategorizedFileHeaders map[string]*zip.File
-
-	PackageInfo          view.PackageInfoFile
-	PackageDocuments     view.PackageDocumentsFile
-	PackageOperations    view.PackageOperationsFile
-	PackageComparisons   view.PackageComparisonsFile
-	BuilderNotifications view.BuilderNotificationsFile
+	InfoFile                        *zip.File
+	DocumentsFile                   *zip.File
+	ComparisonsFile                 *zip.File
+	OperationsFile                  *zip.File
+	BuilderNotificationsFile        *zip.File
+	ChangelogFile                   *zip.File
+	VersionInternalDocumentsFile    *zip.File
+	ComparisonInternalDocumentsFile *zip.File
+
+	DocumentsHeaders                   map[string]*zip.File
+	OperationFileHeaders               map[string]*zip.File
+	ComparisonsFileHeaders             map[string]*zip.File
+	VersionInternalDocumentsHeaders    map[string]*zip.File
+	ComparisonInternalDocumentsHeaders map[string]*zip.File
+	UncategorizedFileHeaders           map[string]*zip.File
+
+	PackageInfo                 view.PackageInfoFile
+	PackageDocuments            view.PackageDocumentsFile
+	PackageOperations           view.PackageOperationsFile
+	PackageComparisons          view.PackageComparisonsFile
+	BuilderNotifications        view.BuilderNotificationsFile
+	VersionInternalDocuments    view.VersionInternalDocumentsFile
+	ComparisonInternalDocuments view.ComparisonInternalDocumentsFile
 }
 
 func NewBuildResultArchive(zipReader *zip.Reader) *BuildResultArchive {
 	result := &BuildResultArchive{
-		ZipReader:                zipReader,
-		DocumentsHeaders:         map[string]*zip.File{},
-		OperationFileHeaders:     map[string]*zip.File{},
-		ComparisonsFileHeaders:   map[string]*zip.File{},
-		UncategorizedFileHeaders: map[string]*zip.File{},
+		ZipReader:                          zipReader,
+		DocumentsHeaders:                   map[string]*zip.File{},
+		OperationFileHeaders:               map[string]*zip.File{},
+		ComparisonsFileHeaders:             map[string]*zip.File{},
+		VersionInternalDocumentsHeaders:    map[string]*zip.File{},
+		ComparisonInternalDocumentsHeaders: map[string]*zip.File{},
+		UncategorizedFileHeaders:           map[string]*zip.File{},
 	}
 	result.splitFiles()
 	return result
@@ -91,6 +103,14 @@ func (a *BuildResultArchive) ReadBuilderNotifications(required bool) error {
 	return a.readFile(BuilderNotificationsFilePath, a.BuilderNotificationsFile, &a.BuilderNotifications, required)
 }
 
+func (a *BuildResultArchive) ReadVersionInternalDocuments(required bool) error {
+	return a.readFile(VersionInternalDocumentsFilePath, a.VersionInternalDocumentsFile, &a.VersionInternalDocuments, required)
+}
+
+func (a *BuildResultArchive) ReadComparisonInternalDocuments(required bool) error {
+	return a.readFile(ComparisonsFilePath, a.ComparisonInternalDocumentsFile, &a.ComparisonInternalDocuments, required)
+}
+
 func (a *BuildResultArchive) readFile(filePath string, file *zip.File, v interface{}, required bool) error {
 	if file == nil {
 		if required {
@@ -144,6 +164,10 @@ func (a *BuildResultArchive) splitFiles() {
 			a.BuilderNotificationsFile = zipFile
 		case ChangelogFilePath:
 			a.ChangelogFile = zipFile
+		case VersionInternalDocumentsFilePath:
+			a.VersionInternalDocumentsFile = zipFile
+		case ComparisonInternalDocumentsFilePath:
+			a.ComparisonInternalDocumentsFile = zipFile
 		default:
 			{
 				if strings.HasPrefix(filepath, DocumentsRootFolder) {
@@ -158,6 +182,14 @@ func (a *BuildResultArchive) splitFiles() {
 					zipFilePtr := zipFile
 					a.ComparisonsFileHeaders[strings.TrimPrefix(filepath, ComparisonsRootFolder)] = zipFilePtr
 					continue
+				} else if strings.HasPrefix(filepath, VersionInternalDocumentsRootFolder) {
+					zipFilePtr := zipFile
+					a.VersionInternalDocumentsHeaders[strings.TrimPrefix(filepath, VersionInternalDocumentsRootFolder)] = zipFilePtr
+					continue
+				} else if strings.HasPrefix(filepath, ComparisonInternalDocumentsRootFolder) {
+					zipFilePtr := zipFile
+					a.ComparisonInternalDocumentsHeaders[strings.TrimPrefix(filepath, ComparisonInternalDocumentsRootFolder)] = zipFilePtr
+					continue
 				} else {
 					a.UncategorizedFileHeaders[filepath] = zipFile
 				}