diff --git a/services/api-docs/server.js b/services/api-docs/server.js index f5d74aa..9ba8310 100644 --- a/services/api-docs/server.js +++ b/services/api-docs/server.js @@ -156,7 +156,7 @@ async function generateUnifiedSpec () { // Fetch specs from all services for (const [serviceKey, service] of Object.entries(SERVICES)) { const spec = await fetchServiceSpec(serviceKey, service) - + // Collect original tags before modifying them const subCategories = new Set() if (spec.paths) { @@ -176,13 +176,13 @@ async function generateUnifiedSpec () { for (const [path, methods] of Object.entries(spec.paths)) { const prefixedPath = `/${serviceKey}${path}` const updatedMethods = {} - + for (const [method, operation] of Object.entries(methods)) { // Use only the main service name as the primary tag // Store original category in metadata for internal organization const originalTags = operation.tags || ['General'] const category = originalTags[0] || 'General' - + updatedMethods[method] = { ...operation, tags: [service.name], // Only main service tag for top-level grouping @@ -193,7 +193,7 @@ async function generateUnifiedSpec () { 'x-category': category } } - + unifiedSpec.paths[prefixedPath] = updatedMethods } } @@ -351,11 +351,11 @@ app.get('/', swaggerUi.setup(null, { filter: true, showExtensions: true, showCommonExtensions: true, - operationsSorter: function(a, b) { + operationsSorter: function (a, b) { // Sort by summary (which includes category tags) - const summaryA = a.get('summary') || ''; - const summaryB = b.get('summary') || ''; - return summaryA.localeCompare(summaryB); + const summaryA = a.get('summary') || '' + const summaryB = b.get('summary') || '' + return summaryA.localeCompare(summaryB) }, tagsSorter: 'alpha' },