在前后端开发联调前 的提交20260223

.kiro/steering/structure.md

@@ -31,12 +31,14 @@ NeoZQYY/
 │   │   ├── tests/              # 后端测试
 │   │   └── pyproject.toml
 │   ├── miniprogram/            # 微信小程序
-│   │   ├── miniapp/            # 小程序源码（主包）
-│   │   ├── miniprogram/        # 小程序源码（分包）
+│   │   ├── miniprogram/        # 小程序源码
 │   │   └── doc/                # 小程序文档
-│   └── admin-web/              # 管理后台
-│       ├── src/                # 前端源码（api/components/pages/store/types）
-│       └── src/__tests__/      # 前端测试
+│   ├── admin-web/              # 管理后台
+│   │   ├── src/                # 前端源码（api/components/pages/store/types）
+│   │   └── src/__tests__/      # 前端测试
+│   └── mcp-server/             # MCP Server（AI 工具集成）
+│       ├── server.py
+│       └── pyproject.toml
 ├── packages/shared/            # 跨项目共享包（enums, money, datetime_utils）
 ├── db/
 │   ├── etl_feiqiu/
@@ -53,6 +55,7 @@ NeoZQYY/
 │   │   └── audit_dashboard.md  # 审计一览表（自动生成）
 │   ├── database/               # 全局数据库文档
 │   ├── architecture/           # 架构设计
+│   ├── deployment/             # 部署文档（EXPORT-PATHS.md、LAUNCH-CHECKLIST.md）
 │   ├── prd/                    # 产品需求
 │   ├── contracts/              # 数据契约
 │   └── ...
@@ -60,8 +63,9 @@ NeoZQYY/
 ├── scripts/                    # 项目级运维脚本
 │   ├── audit/                  # 审计工具（gen_audit_dashboard.py）
 │   ├── ops/                    # 日常运维（init_databases、clone_to_test_db 等）
-│   └── migrate/                # 一次性迁移脚本
-├── pyproject.toml              # uv workspace 根配置
+│   ├── migrate/                # 一次性迁移脚本
+│   └── server/                 # 服务器部署脚本
+├── pyproject.toml              # uv workspace 根配置（4 成员）
 ├── .env.template
 └── README.md
 ```
@@ -70,18 +74,14 @@ NeoZQYY/
 - 任务模式：继承 `BaseTask`（Extract → Transform → Load），在 `orchestration/task_registry.py` 注册
 - 加载器模式：每张目标表一个 Loader，`upsert()` + 冲突处理
 - 配置分层：DEFAULTS → `.env` → CLI 覆盖
-- Flow：通过 `--pipeline` 参数指定（如 `api_full`），旧 `--pipeline-flow` 已弃用
+- Flow：通过 `--pipeline` 参数指定（如 `api_full`）
 - 多门店隔离：`site_id` + RLS（`app` schema 视图层）
 - 跨库访问：`zqyy_app` 通过 FDW 只读映射 `etl_feiqiu.app`
 
 ## 文件归属规则（展开说明）
 
 ### 模块内部（各 APP / Connector 自治）
-每个子模块的以下目录属于模块专属，只放该模块自身的内容：
-- `docs/` — 模块专属文档（API 参考、业务规则、任务说明、运维指南等）
-- `tests/` — 模块专属测试（单元测试、集成测试）
-- `scripts/` — 模块专属脚本（数据检查、修复、导出等）
-
+每个子模块的 `docs/`、`tests/`、`scripts/` 属于模块专属，只放该模块自身的内容。
 禁止将项目级内容放入模块内部目录，也禁止将模块专属内容放到根目录。
 
 ### 项目级（根目录统管）
@@ -96,7 +96,7 @@ NeoZQYY/
 - 审计一览表：`docs/audit/audit_dashboard.md`（自动生成，勿手动编辑）
 - Prompt 日志：`docs/audit/prompt_logs/`
 - 一览表生成脚本：`scripts/audit/gen_audit_dashboard.py`
-- 禁止将审计产物写入子模块内部（如 `apps/etl/connectors/feiqiu/docs/audit/`）
+- 禁止将审计产物写入子模块内部
 
 ### 速查表