1

docs/DOCUMENTATION-MAP.md

@@ -24,38 +24,25 @@
 
 ### 2.2 数据库变更手册 `docs/database/`
 
-每个 `BD_Manual_*.md` 是一次数据库结构变更的完整审计文档，包含：变更说明、字段定义、影响分析、回滚策略、验证 SQL。
+业务库（zqyy_app）相关的 BD 手册。ETL 专属表级文档已迁移至 `apps/etl/connectors/feiqiu/docs/database/`（见 3.2 节）。
 
 | 文件 | 记录内容 |
 |------|----------|
 | `BD_Manual_auth_tables.md` | auth Schema 8 张认证表（users、roles、permissions、user_applications 等） |
-| `BD_Manual_biz_tables.md` | biz Schema 4 张核心业务表（coach_tasks、coach_task_history、notes、trigger_jobs） |
+| `BD_Manual_biz_tables.md` | biz Schema 核心业务表（coach_tasks、coach_task_history、notes、trigger_jobs、AI 表等） |
 | `BD_Manual_auth_biz_schemas.md` | auth + biz Schema 创建 |
 | `BD_Manual_fdw_etl_setup.md` | FDW 跨库访问配置（zqyy_app → etl_feiqiu） |
 | `BD_Manual_app_schema_rls_views.md` | app Schema RLS 视图 |
-| `BD_Manual_dws_assistant_order_contribution.md` | DWS 助教订单贡献表 |
-| `BD_Manual_dws_goods_stock_summary.md` | DWS 商品库存汇总表 |
-| `BD_Manual_dws_member_spending_power_index.md` | DWS 会员消费力指数表 |
-| `BD_Manual_member_balance_changes.md` | 会员余额变动表 |
-| `BD_Manual_recharge_settlements.md` | 充值结算表 |
-| `BD_Manual_goods_stock_movements.md` | 商品库存流水表 |
-| `BD_Manual_goods_stock_summary.md` | 商品库存汇总表 |
-| `BD_Manual_goods_stock_warning_info.md` | 商品库存预警表 |
-| `BD_Manual_store_goods_master.md` | 门店商品主表 |
-| `BD_Manual_store_goods_sales_records.md` | 门店商品销售记录 |
-| `BD_Manual_tenant_goods_master.md` | 租户商品主表 |
-| `BD_Manual_assistant_accounts_master.md` | 助教账户主表 |
-| `BD_Manual_assistant_service_records.md` | 助教服务记录表 |
-| `BD_Manual_site_tables_master.md` | 门店台桌主表 |
-| `BD_Manual_20260301_cleanup_and_fixes.md` | 已删除表残留清理 + ODS 商品销售窗口修复 + dim_staff_ex 列名修复 |
+| `BD_Manual_ai_tables.md` | AI 相关表（ai_chat_sessions、ai_chat_messages 等） |
+| `BD_Manual_member_retention_clue.md` | 会员留存线索表 |
 | `README.md` | 数据库文档目录说明 |
 
 子目录：
 
 | 目录 | 内容 |
 |------|------|
-| `ddl/` | 10 个 DDL 基线文件，覆盖 etl_feiqiu 六层 Schema（meta/ods/dwd/core/dws/app）+ zqyy_app 三个 Schema（auth/biz/public）+ FDW |
-| `_archived/` | 10 个已归档的历史变更文档（已废弃的表、已回滚的变更等） |
+| `ddl/` | 10 个 DDL 基线文件（含种子数据），覆盖 etl_feiqiu 六层 Schema（meta/ods/dwd/core/dws/app）+ zqyy_app 三个 Schema（auth/biz/public）+ FDW |
+| `_archived/` | 已归档的历史变更文档（已废弃的表、已回滚的变更、已合并入 DDL 基线的迁移记录） |
 
 ### 2.3 审计记录 `docs/audit/`
 
@@ -66,7 +53,7 @@
 | `audit_dashboard.md` | 审计仪表盘，汇总所有变更审计记录 |
 | `README.md` | 审计目录说明 |
 | `SESSION-LOG-GUIDE.md` | Session 日志使用指南：索引字段说明、查询方法、典型场景、与其他审计产物的关系 |
-| `changes/` | 38 份变更审计文档（`YYYY-MM-DD__<slug>.md` 格式），每份包含：变更原因、影响范围、回滚策略、验证 SQL |
+| `changes/` | 39 份变更审计文档（`YYYY-MM-DD__<slug>.md` 格式），每份包含：变更原因、影响范围、回滚策略、验证 SQL |
 | `prompt_logs/` | ~500 份 Prompt 日志（`prompt_log_YYYYMMDD_HHMMSS.md`），记录每次 AI 交互的输入输出 |
 | `session_logs/` | 全量会话记录（按 `YYYY-MM/DD/` 分层），含双索引（`_session_index.json` / `_session_index_full.json`）、每轮 execution 的完整 Markdown 记录、LLM 生成的操作摘要 |
 
@@ -109,14 +96,39 @@ H5 静态原型页面，用于小程序 UI 设计参考。
 | `js/` | 8 个交互脚本 |
 | `img/` | 图片资源 |
 
-### 2.8 参考资料 `docs/reference/`
+### 2.8 小程序前端开发指南 `docs/miniprogram-dev/`
+
+微信小程序前端页面开发与 H5 原型迁移的统一文档中心。覆盖批量自动迁移、用户指定半自动开发、新页面从零开发三种模式。
+
+| 路径 | 内容 |
+|------|------|
+| `README.md` | 入口索引：快速导航、目录结构、Power 依赖、关联资源 |
+| `01-orchestration/batch-auto-playbook.md` | 批量自动模式：89 单元编排 + 4 代理流水线 |
+| `01-orchestration/user-guided-playbook.md` | 半自动模式：对话触发 + 按需执行 |
+| `01-orchestration/new-page-playbook.md` | 新页面开发：有原型 / 无原型两条路径 |
+| `02-action/screenshot-agent.md` | 截图代理：H5/MP 双端截图执行手册 |
+| `02-action/audit-agent.md` | 审计代理：结构化审计执行手册 |
+| `02-action/fix-agent.md` | 修正代理：P0-P7 分级修正执行手册 |
+| `02-action/verify-agent.md` | 验证代理：回归校验执行手册 |
+| `02-action/page-dev-agent.md` | 页面开发代理：新页面完整开发执行手册 |
+| `03-reference/wxss-rules.md` | WXSS 规范 + rpx 换算 + 颜色/字号/圆角标准值 |
+| `03-reference/page-structure-map.md` | 各页面特殊结构速查 |
+| `03-reference/css-risk-features.md` | CSS 风险特性 + 替代方案 |
+| `03-reference/power-integration.md` | Power 集成指南（4 个 Power 的调用方式） |
+| `03-reference/benchmark-history.md` | 基准测试历史记录 |
+| `04-audit/PROGRESS.md` | 89 单元进度跟踪（实时更新） |
+| `04-audit/CHANGELOG.md` | 文档体系版本变更记录 |
+| `05-lessons/pitfalls.md` | 踩坑速查 + 页面迁移经验 |
+| `05-lessons/convergence-patterns.md` | 收敛模式 + 不可消除差异白名单 |
+
+### 2.9 参考资料 `docs/reference/`
 
 | 文件 | 内容 |
 |------|------|
 | `bailian-agent-guide.md` | 百炼 Agent 集成参考指南（由 v1 + v2 合并） |
 | `bailian-dashscope-api.md` | 百炼 DashScope API 参考 |
 
-### 2.9 数据分析报告 `docs/reports/`
+### 2.10 数据分析报告 `docs/reports/`
 
 一次性数据分析、调研产出的报告文档。与 `prd/specs/` 的区别：specs 是需求规格，reports 是基于数据的分析结论。
 
@@ -125,13 +137,13 @@ H5 静态原型页面，用于小程序 UI 设计参考。
 | `complex-orders-analysis.md` | 复杂订单结构分析（ODS 全量扫描，关联键与复杂度定义） |
 | `dwd-amount-duration-calibration.md` | DWD 层金额·绩效·时长字段口径全景（置信度与存疑项标注） |
 
-### 2.10 架构文档 `docs/architecture/`
+### 2.11 架构文档 `docs/architecture/`
 
 | 文件 | 内容 |
 |------|------|
 | `etl-feiqiu-architecture.md` | ETL Connector 整体架构说明（数据流、DWS/INDEX 任务、调度编排、CLI） |
 
-### 2.11 其他项目级文档目录
+### 2.12 其他项目级文档目录
 
 | 路径 | 内容 |
 |------|------|
@@ -166,7 +178,7 @@ H5 静态原型页面，用于小程序 UI 设计参考。
 | `docs/api-reference/` | 上游飞球 API 接口文档（字段映射、请求参数、响应结构） |
 | `docs/architecture/` | 架构设计文档（数据流、分层设计、SCD 策略） |
 | `docs/business-rules/` | 业务规则文档（金额精度、时区处理、去重逻辑） |
-| `docs/database/` | ETL 数据库文档（Schema 设计、表结构、索引策略） |
+| `docs/database/` | ETL 数据库文档：按 Schema 层分目录（ODS/DWD/DWS/ETL_Admin），含表结构、索引策略、跨层映射（cross_layer）、变更记录 |
 | `docs/etl_tasks/` | ETL 任务文档（每个任务的输入输出、依赖、调度配置） |
 | `docs/operations/` | 运维文档（监控、告警、故障排查） |
 | `docs/requirements/` | 需求文档（功能需求、非功能需求） |
@@ -204,10 +216,10 @@ H5 静态原型页面，用于小程序 UI 设计参考。
 |------|------|
 | `README.md` | 数据库目录总览、四库架构说明 |
 | `zqyy_app/README.md` | 业务库文档：auth Schema 8 张表字段说明、迁移顺序、FDW 跨库访问 |
-| `zqyy_app/migrations/` | 业务库迁移脚本（日期前缀命名） |
+| `zqyy_app/migrations/` | 业务库迁移脚本（已合并入 DDL 基线，目录保留 .gitkeep） |
 | `etl_feiqiu/README.md` | ETL 库文档：六层 Schema 说明、表清单 |
-| `etl_feiqiu/migrations/` | ETL 库迁移脚本（日期前缀命名） |
-| `fdw/` | FDW（Foreign Data Wrapper）跨库访问配置脚本 |
+| `etl_feiqiu/migrations/` | ETL 库迁移脚本（已合并入 DDL 基线，目录保留 .gitkeep） |
+| `fdw/` | FDW（Foreign Data Wrapper）跨库访问配置脚本（4 个，运行时资产） |
 | `scripts/` | 数据库运维脚本 |
 | `_archived/` | 已归档的历史数据库文件 |
 
@@ -277,6 +289,7 @@ H5 静态原型页面，用于小程序 UI 设计参考。
 | 迁移记录 | `migrate/` | 仓库迁移总结、配置迁移记录 |
 | MCP 相关 | `mcp/` | AI 工具集成文档 |
 | UI 原型 | `h5_ui/` | H5 静态原型页面 |
+| 小程序前端开发指南 | `miniprogram-dev/` | 页面开发流程、代理手册、规范参考、进度审计、经验教训 |
 | 运维手册 | `ops/` | 故障排查、日常运维流程 |
 | 权限矩阵 | `permission_matrix/` | 角色-资源权限映射 |