# 变更审计记录（Change Audit Record）

- 日期/时间：2026-03-22 19:30:00
- Prompt-ID：P20260322-DDL-BD-CONSISTENCY
- 原始原因（Prompt）：用户要求对比 10 个主 DDL 与当前数据库结构是否完全契合，并修复数据库手册和文档中的遗漏，要求"从头审核走查"。
- 直接原因：DDL 基线文件与实际数据库存在 2 处字段级差异；BD 手册存在 6 处文档错误/遗漏（旧表名引用、字段缺失、计数错误等）。

## 变更范围（Changed）

### DDL 文件修复
- `docs/database/ddl/zqyy_app__auth.sql`：`auth.tenant_admins` 表定义补充 `deleted_at` 字段 + `idx_tenant_admins_active_not_deleted` 部分索引

### 数据库迁移执行
- `test_zqyy_app.biz.ai_run_logs`：执行 P15 迁移（`alert_status` 字段 + CHECK 约束 + 2 索引），使测试库与 DDL 一致

### BD 手册修复
- `docs/database/BD_Manual_auth_tables.md`：3 处旧表名 `auth.site_code_mapping` → `auth._archived_site_code_mapping`
- `docs/database/BD_Manual_fdw_etl_setup.md`：快捷别名视图计数 "6 张" → "7 张"
- `docs/database/BD_Manual_member_retention_clue.md`：验证 SQL 步骤 3 列数 "10 列" → "11 列"，字段列表补充 `is_hidden`
- `apps/etl/connectors/feiqiu/docs/database/DWS/main/BD_manual_cfg_area_category.md`：字段说明表补充 `sort_order`（第 14 字段），更新时间 → 2026-03-20，历史变更表补充 2026-03-20 条目

## 风险与回滚（Risk & Rollback）
- 风险点：均为文档/DDL 基线修复，不影响运行时逻辑。测试库 P15 迁移为追加字段+索引，不影响已有数据。
- 回滚要点：DDL 文件和 BD 手册通过 git revert 即可回滚。测试库 P15 迁移可通过 `ALTER TABLE biz.ai_run_logs DROP COLUMN alert_status` + 删除索引回滚。

## 验证（Verification）
- DDL vs DB 一致性：对 10 个 DDL 文件重新执行字段级比对脚本，确认 0 差异
- BD 手册：逐文件检查修改点与实际数据库结构一致
- `test_zqyy_app.biz.ai_run_logs`：`SELECT count(*) FROM information_schema.columns WHERE table_schema='biz' AND table_name='ai_run_logs'` 预期 15 列

## 文件清单（Files changed）
- `docs/database/ddl/zqyy_app__auth.sql`（DDL 补字段+索引）
- `docs/database/BD_Manual_auth_tables.md`（旧表名修正 ×3）
- `docs/database/BD_Manual_fdw_etl_setup.md`（视图计数修正）
- `docs/database/BD_Manual_member_retention_clue.md`（验证 SQL 列数+字段列表修正）
- `apps/etl/connectors/feiqiu/docs/database/DWS/main/BD_manual_cfg_area_category.md`（补 sort_order 字段+更新时间+历史变更）
