Neo
2dfc926f96
Phase 2.3 chat 上下文捕获链路从未真正激活到完整工作: - 14 处 ai-float-button 补 sourcePage,chat.ts 三分支同步设 pageFilters.contextId - 后端 page_context 4 层 BUG 修(列名错位 + RLS site_id 未重设) - xcx_chat filters.pop 破坏 body.page_context 引用 — dict() 浅拷贝隔离 - chat 流式 markdown 实时解析(表格/标题/列表/加粗 + KPI 富卡) - reference_card KPI 富卡接入 SSE 路径,db 真写入 - 维客线索 source 显示规则:AI 来源用机器人 icon 替代长文字 数据库: - public.member_retention_clue 加 emoji + runtime_mode + sandbox_instance_id - biz.ai_run_logs 加 assistant_id + 复合索引 - chk_ai_cache_type CHECK 约束 8 类应用名 - cache_type / app_type 命名统一(app6_note / app7_customer / app8_consolidation) - 历史 emoji 抽取脚本 44/44 成功 后端 silent failure 修: - cleanup_service WHERE app_type → cache_type(90 天清理 + 20K 上限重新生效) - _build_ai_insight 字段错位修复(app4 → app7 + 字段对齐 prompt schema) - task_manager talkingPoints 改 app5_tactics + tactics 字段 - task_manager aiSuggestion 改取 one_line_summary - cache_service.CACHE_EXPIRY_DAYS 加 app2a_finance_area - WS /ws/ai-cache 加 token + JWT + site_id 校验(P0 信息泄露漏洞) - internal_ai token 改 hmac.compare_digest 工具/文档: - main.py 加 RotatingFileHandler logs/backend.log + uvicorn /health 过滤 - 新建 utils/clue_category.py(VI 6 类配色 + emoji fallback + source 显示规则) - 新建 utils/markdown.ts(轻量 md 转 rich-text 解析 + streaming 容错) - audit + 数据库变更说明 + backlog §七 #14 收口 + #15-#38 残余子任务 - backlog 追加 §十一 App1 参数/MCP/沙箱审计 + §十二 百炼/SQL MCP 主任务线 实地 MCP 走查:14 入口数据层 + 5 代表入口 sourcePage 注入 + customer-detail 全模块 + chat md 渲染 + reference_card 富卡 都已验证。9 项预先 BUG/UX 登记 §七 #29-#38 后续修复。 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
db/ — 数据库资产目录
当前状态（2026-04-06 更新）
项目 v1，DDL 不存在迭代更新。完整 schema 定义在 schemas/ 目录（按 schema 分文件，从测试库导出）。
同一份 DDL 也保留在 docs/database/ddl/（文档视角）。
目录结构
db/
├── etl_feiqiu/
│ ├── schemas/ — 六层完整 DDL（meta/ods/dwd/core/dws/app）
│ ├── migrations/ — 未来增量迁移（v1 已全部归档）
│ ├── ods/ — ODS 补充脚本
│ └── scripts/
│ └── create_test_db.sql
├── zqyy_app/
│ ├── schemas/ — 三层完整 DDL（public/auth/biz）
│ ├── migrations/ — 未来增量迁移（v1 已全部归档）
│ └── scripts/
│ └── create_test_db.sql
├── fdw/ — FDW 跨库映射配置
│ ├── setup_fdw.sql — 正向（zqyy_app → etl_feiqiu.app）
│ ├── setup_fdw_test.sql — 正向（测试环境）
│ ├── setup_fdw_reverse.sql — 反向（etl_feiqiu → zqyy_app.member_retention_clue）
│ └── setup_fdw_reverse_test.sql — 反向（测试环境）
└── _archived/ — 归档
├── ddl_baseline_2026-02-22/ — 旧基线
└── migrations_v1_merged/ — v1 全部迁移（39 个，已合并进 schemas/）
├── etl_feiqiu/ — 11 个迁移
└── zqyy_app/ — 28 个迁移
Schema 文件
db/etl_feiqiu/schemas/ 和 db/zqyy_app/schemas/ 是权威的完整 DDL，包含建表、索引、约束、种子数据。
| 文件 | 数据库 | Schema | 对象数 |
|---|---|---|---|
etl_feiqiu/schemas/meta.sql |
etl_feiqiu | meta | 3 表 |
etl_feiqiu/schemas/ods.sql |
etl_feiqiu | ods | 23 表 |
etl_feiqiu/schemas/dwd.sql |
etl_feiqiu | dwd | 42 表 |
etl_feiqiu/schemas/core.sql |
etl_feiqiu | core | 7 表（跨平台统一维度层，由 CORE_DIM_SYNC 任务从 DWD 同步） |
etl_feiqiu/schemas/dws.sql |
etl_feiqiu | dws | 38 表 |
etl_feiqiu/schemas/app.sql |
etl_feiqiu | app | 仅视图 |
zqyy_app/schemas/public.sql |
zqyy_app | public | 12 表 |
zqyy_app/schemas/auth.sql |
zqyy_app | auth | 9 表 |
zqyy_app/schemas/biz.sql |
zqyy_app | biz | 21 表 |
重新生成：PYTHONUTF8=1 python tools/db/gen_consolidated_ddl.py
迁移管理
v1 阶段的 39 个迁移已全部合并进 schemas/ 完整 DDL，原文件归档在 _archived/migrations_v1_merged/。
后续新增迁移放 migrations/，文件名格式 YYYY-MM-DD__描述.sql。
执行后重新运行 DDL 生成脚本刷新 schemas/ 基线。
文档分工
| 位置 | 管辖范围 |
|---|---|
docs/database/ |
业务库(zqyy_app) BD_Manual + 跨模块(FDW/RLS) + DDL 基线副本 |
apps/etl/connectors/feiqiu/docs/database/ |
ETL 专属(ODS/DWD/DWS 表级文档) |
db/（本目录） |
权威 DDL + 运行时资产(迁移/FDW/建库脚本) |
tools/db/ |
数据库工具(DDL 生成/验证/一致性检查) |