添加变更历史 添加ARD文档

Project/fonrey/DATA_MODEL/DATA_MODEL.md

@@ -2,13 +2,20 @@
 # Fonrey 房产经纪管理系统 — DATA MODEL 设计文档
 
 > **作者**: Backend Architect  
-> **版本**: v1.4  
-> **日期**: 2026-04-24（v1.1 修复 S1/S2/S4；v1.2 扩展 public schema；v1.3 §三 DDL 迁至 DATA_MODEL_PUBLIC.md，本文改为索引；v1.4 补充 LOGIN/PERMISSION 子文档引用、领域对象、租户 Schema 章节、Redis 缓存策略）  
+> **版本**: v1.5  
+> **日期**: 2026-04-30（v1.1 修复 S1/S2/S4；v1.2 扩展 public schema；v1.3 §三 DDL 迁至 DATA_MODEL_PUBLIC.md，本文改为索引；v1.4 补充 LOGIN/PERMISSION 子文档引用、领域对象、租户 Schema 章节、Redis 缓存策略；v1.5 新增 ADR 导航与治理联动）  
 > **技术栈**: Django 4.x + PostgreSQL + django-tenants + Redis  
 > **设计目标**: 支撑 89,000+ 房源、多租户隔离、sub-100ms 查询、合规审计
 
 ---
 
+## 变更历史
+
+| 日期 | 变更人 | 变更内容 |
+|---|---|---|
+| 2026-04-30 | Atlas | 新增 ADR 导航与治理联动规则（数据模型变更需 ADR 可追溯） |
+| 2026-04-30 | Atlas | 补充“变更历史”章节（文档治理） |
+
 ## 一、架构决策总览 (Architecture Decision Records)
 
 ### 1.1 多租户策略：Schema-per-Tenant
@@ -157,6 +164,7 @@ OrgUnit (组织架构)
 | [DATA_MODEL_LOGIN.md](./DATA_MODEL_LOGIN.md) | 登录与账号认证（user_accounts, login_attempts, password_reset_tokens, password_histories + Redis 登录缓存） | ✅ 完成 |
 | [DATA_MODEL_PERMISSION.md](./DATA_MODEL_PERMISSION.md) | 权限管理（permission_defs, roles, role_permissions, staff_roles, staff_permission_overrides, staff_data_scopes, permission_change_logs + Redis 权限缓存） | ✅ 完成 |
 | [ENUMS.md](./ENUMS.md) | 枚举字典（`public.enum_labels` 表设计 + 所有模块枚举定义 + 种子数据 SQL） | ✅ 完成 |
+| [ADR.md](../ADR.md) | 架构与需求决策记录（按日期/按模块/历史流水，append-only） | ✅ 完成 |
 
 ---
 
@@ -833,7 +841,14 @@ app.conf.beat_schedule["partition_maintenance_task"] = {
 | 跟进目的枚举 | 存 lookup_items 表，运营可维护 | 初始化数据需提前收集 |
 | 手机号加密算法 | AES-256-GCM，密钥存 Django settings（生产用 Vault） | 密钥管理需单独规划 |
 
+## 十、文档治理与 ADR 联动规则
+
+- 任何会影响数据模型边界的变更（新增/删除表、关键约束变更、索引策略调整、枚举口径变更）必须先在 `ADR.md` 记录为 `accepted`，再修改本文件与子文档。
+- 若既有数据决策被替代，必须在 `ADR.md` 增加 `superseded` 记录并指向新 ADR，禁止直接覆盖旧结论。
+- 提交 PR 时，凡涉及 `DATA_MODEL/*` 结构性变更，PR 描述必须包含 ADR ID（格式：`ADR-YYYYMMDD-XXX`）。
+- `DATA_MODEL.md` 只维护全局索引与规则；表级 DDL 以各子文档为权威源，避免双写漂移。
+
 ---
 
-*本文档为 Fonrey 系统 DATA MODEL v1.0，随 PRD 迭代同步更新。*
+*本文档为 Fonrey 系统 DATA MODEL v1.5，随 PRD 与 ADR 迭代同步更新。*
 *下一步建议：API 接口规范（URL 设计 + Request/Response Schema）*