Neo
14a12342b5
这些审计记录原本堆积在 docs/audit/changes/changes/ 嵌套误产物目录下（由开发机迁移
79d3c2e 前后的不明批量操作产生）。由于同期 .gitignore 屏蔽了 docs/audit/ 全目录，
它们从未入过 git 任何分支 history。删除即永久丢失。
按 docs/specs/audit-gap-recovery/tasks.md 阶段 1 执行，将全部 96 份 D 类孤本
（主目录无同名、git history 亦无记录）复制到 docs/audit/changes/ 主目录入仓。
涵盖主题: P1-P18 全栈集成 / 多模块累积变更 / ETL bug 修复 / 业务日切 /
召回与任务引擎改造 / 租户管理与审批 / 董事会财务 / 客户与助教详情 /
DDL 基线合并 / Kiro 到 Claude Code 迁移
阶段 2（B 类内容漂移 1 份）和阶段 4（嵌套目录删除）独立推进。
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
58 lines
3.1 KiB
Markdown
58 lines
3.1 KiB
Markdown
# 变更审计记录：NS4 DDL 合并 — deleted_at 字段并入主迁移脚本
|
||
|
||
| 字段 | 值 |
|
||
|------|-----|
|
||
| 日期 | 2026-03-22 17:52:39 |
|
||
| Prompt-ID | P20260322-173709 |
|
||
| Session-ID | 8d92cd0c |
|
||
| Session 路径 | docs/audit/session_logs/2026-03/22/50_4945f994_173026 |
|
||
|
||
## 操作摘要
|
||
|
||
将 `auth.tenant_admins` 的 `deleted_at` 软删除字段从独立迁移脚本（`2026-03-22__add_deleted_at_to_tenant_admins.sql`）合并到主迁移脚本（`2026-03-20__ns4_tenant_admin_tables.sql`）中，使 DDL 定义保持单一来源。同步更新 BD 手册文档，补充字段说明和索引信息。
|
||
|
||
## 风险标签
|
||
|
||
`root-file` · `dir:admin-web` · `dir:backend` · `dir:etl` · `dir:miniprogram` · `dir:db` · `db-schema-change`
|
||
|
||
## 本次对话文件变更
|
||
|
||
### 新增文件
|
||
- `docs/audit/prompt_logs/prompt_log_20260322_173709.md` — Prompt 日志
|
||
- `docs/audit/session_logs/2026-03/22/50_4945f994_173026/main_01_10805755.md` — Session 日志
|
||
|
||
### 删除文件
|
||
- `db/zqyy_app/migrations/2026-03-22__add_deleted_at_to_tenant_admins.sql` — 独立迁移脚本（已合并入主 DDL）
|
||
- `docs/audit/session_logs/2026-03/22/50_4945f994_173026/main_01_e1cf6056.md` — Session 日志（被替换）
|
||
|
||
## 改动注解
|
||
|
||
### `db/zqyy_app/migrations/2026-03-20__ns4_tenant_admin_tables.sql`
|
||
- 变更类型：修改
|
||
- 原始原因：用户要求将 `deleted_at` 字段的 DDL 合并到主迁移脚本中，避免多个迁移脚本定义同一张表的结构，保持 DDL 单一来源
|
||
- 思路分析：将原本通过 `ALTER TABLE ADD COLUMN` 添加的 `deleted_at TIMESTAMPTZ DEFAULT NULL` 直接写入 `CREATE TABLE` 语句中；同时将部分索引 `idx_tenant_admins_active_not_deleted` 的 `CREATE INDEX` 也移入主脚本。注释中标注 `（2026-03-22 新增）` 保留变更溯源
|
||
- 修改结果：`auth.tenant_admins` 表定义从 10 列扩展为 11 列（含 `deleted_at`），索引从 2 个增加到 3 个。独立迁移脚本 `2026-03-22__add_deleted_at_to_tenant_admins.sql` 不再需要，已删除
|
||
|
||
### `db/zqyy_app/migrations/2026-03-22__add_deleted_at_to_tenant_admins.sql`
|
||
- 变更类型：删除
|
||
- 原始原因：该脚本的内容已合并入 `2026-03-20__ns4_tenant_admin_tables.sql`，保留会导致重复执行 DDL
|
||
|
||
### 其他修改文件（session 日志索引更新）
|
||
- `docs/audit/session_logs/2026-02/*/` 及 `docs/audit/session_logs/2026-03/*/` 下的 `_day_index.json` / `_day_index_full.json` — 批量重建 session 日志索引，非业务变更
|
||
|
||
## DDL/迁移检查
|
||
|
||
- 迁移文件：`db/zqyy_app/migrations/2026-03-20__ns4_tenant_admin_tables.sql`
|
||
- ⚠️ DDL 基线待合并（`compliance.has_ddl_baseline = false`）
|
||
- 迁移执行状态：待验证（测试库连接未执行）
|
||
|
||
## BD 手册同步
|
||
|
||
已更新 `docs/database/BD_Manual_tenant_admin_tables.md`：
|
||
- `auth.tenant_admins` 表结构新增 `deleted_at` 字段行
|
||
- 索引表新增 `idx_tenant_admins_active_not_deleted` 部分索引
|
||
- 验证 SQL 预期列数从 10 更新为 11
|
||
- 索引预期数从 2 更新为 3
|
||
- NS4.1 变更补充段落更新，说明 `deleted_at` 已合并入主 DDL
|
||
- 迁移脚本路径修正为 `2026-03-20__ns4_tenant_admin_tables.sql`
|