添加变更历史 添加ARD文档

Project/fonrey/TECH_STACK/TECH_STACK.md

@@ -2,11 +2,18 @@
 
 > **For AI assistants**: Read this entire file before writing any code. All decisions here are final. Do not suggest alternatives unless asked.
 
-**版本**: 2.3 ｜ **最后更新**: 2026-04-29
+**版本**: 2.5 ｜ **最后更新**: 2026-04-30
 **定位**: 本文档是 Fonrey 项目技术栈的**总索引**。所有跨模块的技术决策、版本约束、目录规范、禁止项在此定稿；**单一模块的具体技术方案**（数据模型、服务层、HTMX 交互、Celery 任务等）见各自子文档（见 §9 索引）。
 
 ---
 
+## 变更历史
+
+| 日期 | 变更人 | 变更内容 |
+|---|---|---|
+| 2026-04-30 | Atlas | 新增 ADR 导航入口与变更治理规则（README 缺失场景下接入 TECH_STACK / DATA_MODEL / AGENTS） |
+| 2026-04-30 | Atlas | 补充“变更历史”章节（文档治理） |
+
 ## 1. 项目概览
 
 **Fonrey（房睿）房产经纪管理系统** —— 面向房地产经纪公司的 B2B SaaS 平台，解决房源/客源信息散乱、跟进缺失、重复录入等痛点，支撑单租户 89,000+ 房源数据量级下的高效匹配。
@@ -115,11 +122,11 @@ apps/property/
 
 ## 7. 客户端发布技术栈（Desktop Client）
 
-> **完整方案**见 PRD：`PRD/发布管理/客户端发布管理模块PRD.md`。本节仅列最终结论。
+> **完整方案**见：`TECH_STACK/客户端发布管理技术方案.md`（实现口径）与 `PRD/发布管理/客户端发布管理模块PRD.md`（需求口径）。本节仅列最终结论。
 
 - **框架**：Electron（稳定版） + Chromium 内核（随版本固定，不依赖系统浏览器）
 - **渲染层**：直接加载 Fonrey Web URL，**100% 复用 HTMX + Alpine + Tailwind**，渲染层零新增框架
-- **自动更新**：`electron-updater`；更新包存 R2 / 经 CDN 分发；后端检测端点 `GET /api/client/updates/latest/`（公开）；启动时 + 每 4h 轮询；后台静默下载，下载完成提示重启；服务端可标记强制更新
+- **自动更新**：`electron-updater`；更新包存 R2 / 经 CDN 分发；后端检测端点 `GET /api/release/updates/latest/`（公开）；启动时 + 每 4h 轮询；后台静默下载，下载完成提示重启；服务端可标记强制更新
 - **构建**：`electron-builder` 输出 NSIS `.exe` + 便携版 `.zip`；目标 Windows x64（优先），ARM64 按需
 - **代码签名**：EV 证书，CI/CD 自动签名，消除 SmartScreen 警告
 - **完整性校验**：下载后必须校验 SHA256 与服务端返回一致才能安装
@@ -140,11 +147,12 @@ apps/property/
 | 楼盘管理  | [`楼盘管理技术方案.md`](./楼盘管理技术方案.md) | `PRD/房源管理/`（含楼盘）           | `DATA_MODEL/DATA_MODEL_COMPLEX.md`    | `tests/integration/complex/test_us_complex.py` | `v1.0` |
 | 组织人事  | [`组织人事技术方案.md`](./组织人事技术方案.md) | `PRD/组织人事管理/`              | `DATA_MODEL/DATA_MODEL_ORG.md`        | `tests/integration/org/test_us_org.py` | `v1.0` |
 | 系统设置  | [`系统设置技术方案.md`](./系统设置技术方案.md)         | `PRD/系统配置/`、`PRD/系统管理/`    | `DATA_MODEL/DATA_MODEL_SETTING.md`    | `tests/integration/setting/test_us_setting.py` | `v1.2` |
-| 客户端发布 | 见本文档 §7                            | `PRD/发布管理/客户端发布管理模块PRD.md` | —                                     | — | `§7（本文）` |
+| 客户端发布 | [`客户端发布管理技术方案.md`](./客户端发布管理技术方案.md) | `PRD/发布管理/客户端发布管理模块PRD.md` | `DATA_MODEL/DATA_MODEL_PUBLIC.md`（`client_releases` / `client_heartbeats`） | `tests/integration/release/test_us_release.py` | `v1.0` |
 
 **总览数据模型**：[`DATA_MODEL/DATA_MODEL.md`](../DATA_MODEL/DATA_MODEL.md)
 **全局 API 契约**：[`API_CONTRACT.md`](./API_CONTRACT.md)
 **MVP 范围与产品总览**：[`PRD/PRD_MVP.md`](../PRD/PRD_MVP.md)
+**ADR 动态决策记录**：[`ADR.md`](../ADR.md)
 
 ---
 
@@ -172,7 +180,7 @@ apps/property/
 | 14 | 落地顺序建议 |
 | 15 | 文档同步规则 |
 
-### 9.2 模块覆盖情况（2026-04-27）
+### 9.2 模块覆盖情况（2026-04-30）
 
 | 模块 | 技术方案文档 | 15 章节覆盖 | 备注 |
 |---|---|---:|---|
@@ -183,6 +191,7 @@ apps/property/
 | 楼盘管理 | `楼盘管理技术方案.md` | 15/15 | 完全覆盖 |
 | 组织人事 | `组织人事技术方案.md` | 15/15 | 完全覆盖 |
 | 系统设置 | `系统设置技术方案.md` | 15/15 | 完全覆盖 |
+| 客户端发布 | `客户端发布管理技术方案.md` | 15/15 | 新增，已覆盖 Electron/EV/Heartbeat/自动升级/R2/官网下载/便携版 |
 
 ### 9.3 使用规则（对 AI Agent 生效）
 
@@ -238,6 +247,9 @@ Fonrey 采用 AI vibe coding 模式开发，测试是保证每日迭代质量的
 - API 契约总则在 `API_CONTRACT.md` 维护；模块文档只做模块特化，不得覆盖全局契约
 - 任何技术栈变更（替换组件、升级主版本、新增外部服务）须同步更新本文档 §2、§5、§6
 - 新增模块时，先在 §4 目录结构补位，再在 §8 索引登记子文档
+- 涉及跨模块规则、接口口径、测试治理、范围边界的决策，必须先写入 `ADR.md`（新增 accepted 记录）再改 TECH_STACK/PRD/DATA_MODEL/TEST_CASES
+- 若已有决策被替代，必须在 `ADR.md` 新增 superseded 记录并显式关联新 ADR；禁止静默改文档覆盖历史
+- 提交 PR 时，若变更命中上述决策域，必须在描述中附 ADR ID（如 `ADR-20260430-011`）
 - 测试规范变更须同步更新 §10 关键结论，完整细节在 [`测试规范.md`](./测试规范.md) 中维护
 - 15 章节统一模板发生变更时，须先更新 §9 标准章节骨架，再同步各模块文档
 
@@ -448,5 +460,3 @@ class ScopedModel(models.Model):
 | own | 员工查自己负责的数据 | 返回数据 ✅ |
 | department | 店长查本部门数据 | 按角色返回 ✅ |
 | cross_department_denied | 普通员工跨部门查询 | 空集或 403 ✅ |
-
-