Files
Neo-ZQYY/docs/audit/changes/2026-03-22__ns4-ddl-merge-deleted-at.md
Neo 14a12342b5 chore(audit): 补追 96 份未入仓审计孤本 — 覆盖 2026-02-26 ~ 2026-04-08
这些审计记录原本堆积在 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>
2026-04-20 06:35:42 +08:00

3.1 KiB
Raw Blame History

变更审计记录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_adminsdeleted_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_deletedCREATE 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