# 变更审计记录：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`
