feat: batch update - gift card breakdown spec, backend APIs, miniprogram pages, ETL finance recharge, docs & migrations

apps/backend/app/main.py

@@ -9,6 +9,13 @@ from contextlib import asynccontextmanager
 
 from fastapi import FastAPI
 from fastapi.middleware.cors import CORSMiddleware
+from starlette.exceptions import HTTPException as StarletteHTTPException
+
+from app.middleware.response_wrapper import (
+    ResponseWrapperMiddleware,
+    http_exception_handler,
+    unhandled_exception_handler,
+)
 
 from app import config
 # CHANGE 2026-02-19 | 新增 xcx_test 路由（MVP 验证）+ wx_callback 路由（微信消息推送）
@@ -19,7 +26,10 @@ from app import config
 # CHANGE 2026-02-27 | 新增 xcx_tasks / xcx_notes 路由（小程序核心业务）
 # CHANGE 2026-03-09 | 新增 xcx_ai_chat 路由（AI SSE 对话 + 历史对话）
 # CHANGE 2026-03-09 | 新增 xcx_ai_cache 路由（AI 缓存查询）
-from app.routers import auth, execution, schedules, tasks, env_config, db_viewer, etl_status, xcx_test, wx_callback, member_retention_clue, ops_panel, xcx_auth, admin_applications, business_day, xcx_tasks, xcx_notes, xcx_ai_chat, xcx_ai_cache
+# CHANGE 2026-03-18 | 新增 xcx_customers 路由（CUST-1 客户详情、CUST-2 客户服务记录）
+# CHANGE 2026-03-19 | 新增 xcx_coaches 路由（COACH-1 助教详情）
+# CHANGE 2026-03-19 | 新增 xcx_board / xcx_config 路由（RNS1.3 三看板 + 技能类型配置）
+from app.routers import auth, execution, schedules, tasks, env_config, db_viewer, etl_status, xcx_test, wx_callback, member_retention_clue, ops_panel, xcx_auth, admin_applications, business_day, xcx_tasks, xcx_notes, xcx_ai_chat, xcx_ai_cache, xcx_performance, xcx_customers, xcx_coaches, xcx_board, xcx_config
 from app.services.scheduler import scheduler
 from app.services.task_queue import task_queue
 from app.ws.logs import ws_router
@@ -103,6 +113,14 @@ app.add_middleware(
     allow_headers=["*"],
 )
 
+# ---- 全局响应包装中间件（在 CORS 之后添加，执行顺序在 CORS 内层） ----
+# CHANGE 2026-03-16 | RNS1.0 T0-1: 全局响应包装 + 异常处理器
+app.add_middleware(ResponseWrapperMiddleware)
+
+# ---- 全局异常处理器 ----
+app.add_exception_handler(StarletteHTTPException, http_exception_handler)
+app.add_exception_handler(Exception, unhandled_exception_handler)
+
 # ---- 路由注册 ----
 app.include_router(auth.router)
 app.include_router(tasks.router)
@@ -123,6 +141,11 @@ app.include_router(xcx_tasks.router)
 app.include_router(xcx_notes.router)
 app.include_router(xcx_ai_chat.router)
 app.include_router(xcx_ai_cache.router)
+app.include_router(xcx_performance.router)
+app.include_router(xcx_customers.router)
+app.include_router(xcx_coaches.router)
+app.include_router(xcx_board.router)
+app.include_router(xcx_config.router)
 
 
 @app.get("/health", tags=["系统"])