const swaggerJsdoc = require('swagger-jsdoc'); const customCSS = ` /* ======================================== 云睿资产管理系统 - Swagger UI 翠竹绿风格定制 ======================================== */ /* 隐藏默认顶部栏 */ .swagger-ui .topbar { display: none; } /* 全局字体设置 */ .swagger-ui { font-family: 'Inter', 'PingFang SC', 'Microsoft YaHei', sans-serif; } /* 主容器背景 - 淡绿灰渐变 */ .swagger-ui .swagger-container { background: linear-gradient(180deg, #f8fafc 0%, #f1f5f9 50%, #e2e8e0 100%); } /* 标题区域 */ .swagger-ui .title { font-size: 24px !important; font-weight: 700 !important; color: #166534 !important; text-shadow: 0 2px 8px rgba(22, 101, 52, 0.1); } /* 描述文字 */ .swagger-ui .title small { background: linear-gradient(135deg, #22c55e, #16a34a) !important; border-radius: 4px; padding: 4px 8px; font-size: 12px !important; color: #fff !important; } /* 信息容器 */ .swagger-ui .info { margin: 30px 0 !important; padding: 24px !important; background: rgba(255, 255, 255, 0.9) !important; border-radius: 16px !important; border: 1px solid rgba(34, 197, 94, 0.2) !important; box-shadow: 0 4px 24px rgba(22, 101, 52, 0.08), 0 1px 2px rgba(0, 0, 0, 0.04) !important; } .swagger-ui .info .title { color: #166534 !important; font-size: 28px !important; } .swagger-ui .info p { color: #64748b !important; line-height: 1.7 !important; } /* 服务器选择器 */ .swagger-ui .servers { margin: 20px 0 !important; } .swagger-ui .servers > label { color: #64748b !important; font-size: 12px !important; font-weight: 600 !important; text-transform: uppercase !important; letter-spacing: 1px !important; } .swagger-ui .servers select { background: rgba(255, 255, 255, 0.95) !important; border: 1px solid rgba(34, 197, 94, 0.3) !important; border-radius: 8px !important; color: #166534 !important; padding: 10px 16px !important; font-size: 14px !important; cursor: pointer; transition: all 0.3s ease !important; } .swagger-ui .servers select:hover { border-color: rgba(34, 197, 94, 0.6) !important; box-shadow: 0 0 12px rgba(34, 197, 94, 0.15) !important; } /* 标签页导航 */ .swagger-ui .opblock-tag { background: rgba(255, 255, 255, 0.8) !important; border: none !important; border-bottom: 2px solid transparent !important; margin: 0 !important; padding: 16px 20px !important; transition: all 0.3s ease !important; } .swagger-ui .opblock-tag:hover { background: rgba(34, 197, 94, 0.08) !important; } .swagger-ui .opblock-tag .tag-header { color: #1e293b !important; font-size: 15px !important; font-weight: 600 !important; } .swagger-ui .opblock-tag .tag-header span { color: #94a3b8 !important; font-size: 13px !important; font-weight: 400 !important; } /* 展开的API块 */ .swagger-ui .opblock { background: rgba(255, 255, 255, 0.85) !important; border: 1px solid rgba(0, 0, 0, 0.06) !important; border-radius: 12px !important; margin: 8px 0 !important; box-shadow: 0 2px 8px rgba(22, 101, 52, 0.04) !important; transition: all 0.3s ease !important; } .swagger-ui .opblock:hover { border-color: rgba(34, 197, 94, 0.3) !important; box-shadow: 0 4px 16px rgba(34, 197, 94, 0.1) !important; transform: translateY(-1px) !important; } .swagger-ui .opblock.opblock-post { border-left: 4px solid #22c55e !important; } .swagger-ui .opblock.opblock-get { border-left: 4px solid #3b82f6 !important; } .swagger-ui .opblock.opblock-put { border-left: 4px solid #f59e0b !important; } .swagger-ui .opblock.opblock-delete { border-left: 4px solid #ef4444 !important; } .swagger-ui .opblock.opblock-patch { border-left: 4px solid #8b5cf6 !important; } /* 操作标题栏 */ .swagger-ui .opblock .opblock-summary { padding: 12px 16px !important; } .swagger-ui .opblock .opblock-summary .opblock-summary-path { color: #1e293b !important; font-size: 14px !important; font-weight: 500 !important; font-family: 'SF Mono', 'Consolas', monospace !important; } .swagger-ui .opblock .opblock-summary .opblock-summary-path:hover { color: #166534 !important; } /* HTTP方法标签 */ .swagger-ui .opblock .opblock-summary .opblock-summary-method { border-radius: 6px !important; font-size: 12px !important; font-weight: 700 !important; min-width: 60px !important; padding: 6px 10px !important; box-shadow: 0 2px 4px rgba(0, 0, 0, 0.1) !important; } .swagger-ui .opblock .opblock-summary .opblock-summary-method span { font-size: 12px !important; } /* GET 方法 - 静谧蓝 */ .swagger-ui .opblock-get .opblock-summary-method { background: linear-gradient(135deg, #60a5fa, #3b82f6) !important; border: none !important; box-shadow: 0 2px 8px rgba(59, 130, 246, 0.3) !important; } /* POST 方法 - 翠竹绿 */ .swagger-ui .opblock-post .opblock-summary-method { background: linear-gradient(135deg, #4ade80, #22c55e) !important; border: none !important; box-shadow: 0 2px 8px rgba(34, 197, 94, 0.3) !important; } /* PUT 方法 - 暖阳橙 */ .swagger-ui .opblock-put .opblock-summary-method { background: linear-gradient(135deg, #fbbf24, #f59e0b) !important; border: none !important; box-shadow: 0 2px 8px rgba(245, 158, 11, 0.3) !important; } /* DELETE 方法 - 胭脂红 */ .swagger-ui .opblock-delete .opblock-summary-method { background: linear-gradient(135deg, #f87171, #ef4444) !important; border: none !important; box-shadow: 0 2px 8px rgba(239, 68, 68, 0.3) !important; } /* PATCH 方法 - 梦幻紫 */ .swagger-ui .opblock-patch .opblock-summary-method { background: linear-gradient(135deg, #a78bfa, #8b5cf6) !important; border: none !important; box-shadow: 0 2px 8px rgba(139, 92, 246, 0.3) !important; } /* 参数区域 */ .swagger-ui .opblock .opblock-section-header { background: rgba(248, 250, 252, 0.8) !important; border-bottom: 1px solid rgba(0, 0, 0, 0.06) !important; padding: 12px 16px !important; } .swagger-ui .opblock .opblock-section-header h4 { color: #64748b !important; font-size: 12px !important; font-weight: 600 !important; text-transform: uppercase !important; letter-spacing: 1px !important; } /* 参数框 */ .swagger-ui .parameters .parameter { padding: 12px 0 !important; } .swagger-ui .parameters .parameter .parameter__name { color: #1e293b !important; font-weight: 500 !important; } .swagger-ui .parameters .parameter .parameter__name.required:after { color: #ef4444 !important; content: " *"; } .swagger-ui .parameters .parameter input, .swagger-ui .parameters .parameter textarea { background: rgba(255, 255, 255, 0.95) !important; border: 1px solid rgba(0, 0, 0, 0.1) !important; border-radius: 8px !important; color: #1e293b !important; padding: 10px 14px !important; font-size: 14px !important; transition: all 0.3s ease !important; } .swagger-ui .parameters .parameter input:focus, .swagger-ui .parameters .parameter textarea:focus { border-color: #22c55e !important; box-shadow: 0 0 0 3px rgba(34, 197, 94, 0.1) !important; outline: none !important; } /* 请求体编辑器 */ .swagger-ui .body-edit-area { background: rgba(255, 255, 255, 0.95) !important; border: 1px solid rgba(0, 0, 0, 0.1) !important; border-radius: 8px !important; color: #1e293b !important; font-family: 'SF Mono', 'Consolas', monospace !important; } .swagger-ui .body-edit-area:focus { border-color: #22c55e !important; box-shadow: 0 0 0 3px rgba(34, 197, 94, 0.1) !important; } /* 执行按钮 - 翠竹绿 */ .swagger-ui .btn { border-radius: 8px !important; font-weight: 600 !important; font-size: 14px !important; padding: 10px 20px !important; transition: all 0.3s ease !important; text-transform: uppercase !important; letter-spacing: 0.5px !important; } .swagger-ui .btn.execute { background: linear-gradient(135deg, #4ade80, #22c55e) !important; border: none !important; color: #fff !important; box-shadow: 0 4px 16px rgba(34, 197, 94, 0.3) !important; } .swagger-ui .btn.execute:hover { background: linear-gradient(135deg, #22c55e, #16a34a) !important; box-shadow: 0 6px 24px rgba(34, 197, 94, 0.4) !important; transform: translateY(-1px) !important; } /* 响应区域 */ .swagger-ui .responses-wrapper { background: rgba(248, 250, 252, 0.6) !important; border-top: 1px solid rgba(0, 0, 0, 0.06) !important; } .swagger-ui .response-col_status { color: #64748b !important; font-weight: 600 !important; } .swagger-ui .response-col_status.success { color: #22c55e !important; } .swagger-ui .response-col_status.error { color: #ef4444 !important; } /* 认证区域 */ .swagger-ui .auth-wrapper { background: rgba(255, 255, 255, 0.9) !important; border: 1px solid rgba(34, 197, 94, 0.2) !important; border-radius: 12px !important; padding: 16px !important; } .swagger-ui .auth-wrapper .authorize { background: rgba(34, 197, 94, 0.1) !important; border: 1px solid rgba(34, 197, 94, 0.3) !important; border-radius: 8px !important; color: #166534 !important; padding: 8px 16px !important; font-weight: 600 !important; transition: all 0.3s ease !important; } .swagger-ui .auth-wrapper .authorize:hover { background: rgba(34, 197, 94, 0.2) !important; box-shadow: 0 0 12px rgba(34, 197, 94, 0.15) !important; } /* 滚动条美化 */ .swagger-ui ::-webkit-scrollbar { width: 8px; height: 8px; } .swagger-ui ::-webkit-scrollbar-track { background: rgba(0, 0, 0, 0.04) !important; } .swagger-ui ::-webkit-scrollbar-thumb { background: rgba(34, 197, 94, 0.3) !important; border-radius: 4px !important; } .swagger-ui ::-webkit-scrollbar-thumb:hover { background: rgba(34, 197, 94, 0.5) !important; } /* 模型区域 */ .swagger-ui .model-container { background: rgba(255, 255, 255, 0.8) !important; border: 1px solid rgba(0, 0, 0, 0.06) !important; border-radius: 8px !important; padding: 16px !important; } .swagger-ui .model { color: #1e293b !important; } .swagger-ui .model .model-title { color: #166534 !important; font-weight: 600 !important; } .swagger-ui .model .prop { color: #64748b !important; } .swagger-ui .model .prop-type { color: #f59e0b !important; } .swagger-ui .model .prop-primitive { color: #22c55e !important; } /* Markdown 内容 */ .swagger-ui .markdown p, .swagger-ui .markdown li { color: #64748b !important; line-height: 1.7 !important; } .swagger-ui .markdown code { background: rgba(34, 197, 94, 0.1) !important; border-radius: 4px !important; color: #166534 !important; padding: 2px 6px !important; font-size: 13px !important; } /* Loading 状态 */ .swagger-ui .loading-container .loading { background: rgba(255, 255, 255, 0.95) !important; } .swagger-ui .loading-container .loading::after { border-color: #22c55e transparent transparent transparent !important; } /* 展开/折叠箭头 */ .swagger-ui .expand-operations { background: rgba(255, 255, 255, 0.8) !important; border-radius: 8px !important; } .swagger-ui .expand-operations button { color: #64748b !important; } .swagger-ui .expand-operations button:hover { color: #166534 !important; } /* 过滤器 */ .swagger-ui .filter-container .filter-wrapper { background: rgba(255, 255, 255, 0.9) !important; border: 1px solid rgba(0, 0, 0, 0.06) !important; border-radius: 8px !important; } .swagger-ui .filter-container input { background: rgba(255, 255, 255, 0.95) !important; border: none !important; color: #1e293b !important; padding: 8px 12px !important; border-radius: 6px !important; } .swagger-ui .filter-container input::placeholder { color: #94a3b8 !important; } /* 版本信息 */ .swagger-ui .version-stamp { background: linear-gradient(135deg, rgba(34, 197, 94, 0.15), rgba(22, 163, 74, 0.15)) !important; border: 1px solid rgba(34, 197, 94, 0.3) !important; border-radius: 6px !important; } .swagger-ui .version-stamp span { color: #166534 !important; font-weight: 600 !important; } /* 图标颜色 */ .swagger-ui .svg_assets { color: #64748b !important; } /* 角标/徽章 */ .swagger-ui .badge { border-radius: 4px !important; font-size: 11px !important; padding: 3px 8px !important; } .swagger-ui .badge--deprecated { background: rgba(245, 158, 11, 0.15) !important; color: #d97706 !important; border: 1px solid rgba(245, 158, 11, 0.3) !important; } /* Try it out 按钮 */ .swagger-ui .try-out-btn { background: rgba(34, 197, 94, 0.1) !important; border: 1px solid rgba(34, 197, 94, 0.3) !important; border-radius: 6px !important; color: #166534 !important; font-size: 12px !important; padding: 6px 12px !important; transition: all 0.3s ease !important; } .swagger-ui .try-out-btn:hover { background: rgba(34, 197, 94, 0.2) !important; } /* Copy 按钮 */ .swagger-ui .copy-to-clipboard { background: rgba(255, 255, 255, 0.9) !important; border: 1px solid rgba(0, 0, 0, 0.06) !important; border-radius: 6px !important; } .swagger-ui .copy-to-clipboard button { color: #64748b !important; } .swagger-ui .copy-to-clipboard button:hover { color: #166534 !important; } `; const options = { definition: { openapi: '3.0.0', info: { title: '云睿资产管理系统 API', version: '1.0.0', description: '数据中心设备管理平台后端服务 API 文档', contact: { name: 'API Support', }, }, servers: [ { url: 'http://localhost:8000', description: '开发环境服务器', }, ], components: { securitySchemes: { bearerAuth: { type: 'http', scheme: 'bearer', bearerFormat: 'JWT', description: '输入 JWT token', }, }, }, security: [ { bearerAuth: [], }, ], tags: [ { name: 'health', description: '健康检查' }, { name: 'auth', description: '认证接口' }, { name: 'rooms', description: '机房管理' }, { name: 'racks', description: '机柜管理' }, { name: 'devices', description: '设备管理' }, { name: 'deviceFields', description: '设备字段' }, { name: 'device-ports', description: '设备端口' }, { name: 'network-cards', description: '网卡管理' }, { name: 'cables', description: '线缆管理' }, { name: 'tickets', description: '工单管理' }, { name: 'ticket-categories', description: '工单分类' }, { name: 'ticket-fields', description: '工单字段' }, { name: 'consumables', description: '耗材管理' }, { name: 'consumable-categories', description: '耗材分类' }, { name: 'consumable-records', description: '耗材记录' }, { name: 'users', description: '用户管理' }, { name: 'roles', description: '角色管理' }, { name: 'system-settings', description: '系统设置' }, { name: 'background', description: '背景配置' }, { name: 'inventory', description: '盘点管理' }, { name: 'statistics', description: '统计接口' }, { name: 'operation-logs', description: '操作日志' }, { name: 'backup', description: '备份管理' }, ], }, apis: ['./routes/*.js', './swagger_docs.yaml'], }; const specs = swaggerJsdoc(options); module.exports = { specs, customCSS }; // 如需独立使用CSS文件,可导出: // module.exports = { specs, customCSS }; // 并在server.js中引入外部CSS文件