docs: add comprehensive API documentation with Swagger

apps/api/app/api/router.py

@@ -8,9 +8,45 @@ from app.api.routes.projects import router as projects_router
 from app.api.routes.upload import router as upload_router
 
 api_router = APIRouter()
-api_router.include_router(health_router, prefix="/health", tags=["health"])
-api_router.include_router(projects_router, prefix="/projects", tags=["projects"])
-api_router.include_router(asset_libraries_router, prefix="/asset-libraries", tags=["asset-libraries"])
-api_router.include_router(assets_router, prefix="/assets", tags=["assets"])
-api_router.include_router(ingest_jobs_router, prefix="/ingest-jobs", tags=["ingest-jobs"])
-api_router.include_router(upload_router, prefix="/upload", tags=["upload"])
+
+# Health check
+api_router.include_router(
+    health_router,
+    prefix="/health",
+    tags=["健康检查"],
+)
+
+# Projects
+api_router.include_router(
+    projects_router,
+    prefix="/projects",
+    tags=["项目管理"],
+)
+
+# Asset Libraries
+api_router.include_router(
+    asset_libraries_router,
+    prefix="/asset-libraries",
+    tags=["资产库管理"],
+)
+
+# Assets
+api_router.include_router(
+    assets_router,
+    prefix="/assets",
+    tags=["素材资产"],
+)
+
+# Ingest Jobs
+api_router.include_router(
+    ingest_jobs_router,
+    prefix="/ingest-jobs",
+    tags=["导入任务"],
+)
+
+# Upload
+api_router.include_router(
+    upload_router,
+    prefix="/upload",
+    tags=["文件上传"],
+)