x

AGENTS.md

@@ -34,13 +34,13 @@
 
 ```
 src/
-  entrypoints/                  # 独立部署入口（均为 create_app 组装，含 sys.path 修正）
+  entrypoints/                  # 独立部署入口（纯组装：sys.path 修正 + create_app + startup_hooks/register_routers）
     moldinsight.py              # moldinsight-only 入口：/api 前缀挂 moldinsight router，端口 8000
     inventory.py                # inventory-only 入口：inventory_router，端口 8001
     unified.py                  # 双模块统一入口：/api 挂 moldinsight + inventory，当前推荐后端
   moldinsight/                  # 【模具分析模块】
     api/
-      __init__.py               # router 聚合：ROUTE_MODULES 清单 + _safe_include 挂载，失败登记 route_registry（/api/health 呈现 degraded，DEBUG 下 fail fast）；debug_router 仅 settings.DEBUG 挂载
+      __init__.py               # router 聚合：ROUTE_MODULES 清单 + _safe_include 挂载，失败登记 route_registry（/api/health 呈现 degraded，DEBUG 下 fail fast）；register_moldinsight_routers 入口单点调用（/api 聚合 + HTML 报告根路径挂载）；debug_router 仅 settings.DEBUG 挂载
       route_registry.py         # 路由装载注册表（loaded / failed / disabled，health_router 引用）
       health_router.py          # /api/health 模块健康检查（含真实 pythonocc 探测与路由装载状态）
       upload_router.py          # /api/upload STEP/STP 上传
@@ -93,7 +93,7 @@ src/
     models/                     # moldinsight 域 ORM（stp_analysis.py：stp_files 及各阶段产物 + processing_tasks，共 9 表）
     storage/
       rustfs_storage.py         # RustFS/MinIO 客户端封装
-      init_storage.py           # 存储初始化
+      init_storage.py           # RustFS 连接初始化 + rustfs_startup_hook（入口经 startup_hooks 注入）
   inventory/                    # 【进销存模块】
     api/                        # 每域一个 routes 文件：product / supplier / customer / warehouse / inventory / stock_movement / purchase_order / sales_order / purchase_demand / finance / dashboard / material
     schemas/                    # 每域一个 Pydantic schema 文件（与 api 一一对应）
@@ -101,7 +101,7 @@ src/
     models/                     # inventory 域 ORM（catalog / warehouse / trading / finance 四文件，共 15 表）
     utils.py
   shared/                       # 【共享平台层：只放真正跨模块复用的基础能力，勿堆业务】
-    app_factory.py              # create_app：request_id 日志中间件 / auth_router / /health / SPA fallback / connect_rustfs 开关（D11 后 /html 由 moldinsight 代理路由提供，不再挂本地 StaticFiles）
+    app_factory.py              # create_app：纯平台引导（CORS / 请求日志 / /health / SPA fallback / db+Redis 启动）；模块专属接线经 startup_hooks 注入（D3 收敛，原 connect_rustfs 已移除）
     config/settings.py          # Settings 单例：dotenv + os.getenv；DB_*/SECRET_KEY 惰性校验无默认
     database/database.py        # async engine / session / get_db_session
     database/init_db.py         # 建表与管理员种子