chore: sync local project changes
This commit is contained in:
Shen Wei
@@ -2,7 +2,7 @@
|
||||
|
||||
> **For AI assistants**: Read this entire file before writing any code. All decisions here are final. Do not suggest alternatives unless asked.
|
||||
|
||||
**版本**: 2.0 ｜ **最后更新**: 2026-04-25
|
||||
**版本**: 2.1 ｜ **最后更新**: 2026-04-27
|
||||
**定位**: 本文档是 Fonrey 项目技术栈的**总索引**。所有跨模块的技术决策、版本约束、目录规范、禁止项在此定稿；**单一模块的具体技术方案**（数据模型、服务层、HTMX 交互、Celery 任务等）见各自子文档（见 §9 索引）。
|
||||
|
||||
---
|
||||
@@ -133,10 +133,10 @@ apps/property/
|
||||
| 登录认证 | [`登录管理技术方案.md`](./登录管理技术方案.md) | `PRD/登录管理/` | `DATA_MODEL/DATA_MODEL_LOGIN.md` |
|
||||
| 权限管理 | [`权限管理系统技术方案.md`](./权限管理系统技术方案.md) | `PRD/权限管理/` | `DATA_MODEL/DATA_MODEL_PERMISSION.md` |
|
||||
| 房源管理 | [`房源管理技术方案.md`](./房源管理技术方案.md) | `PRD/房源管理/` | `DATA_MODEL/DATA_MODEL_PROPERTY.md` |
|
||||
| 客源管理 | _待补充_ | `PRD/客源管理/` | `DATA_MODEL/DATA_MODEL_CLIENT.md` |
|
||||
| 楼盘管理 | _待补充_ | `PRD/房源管理/`（含楼盘） | `DATA_MODEL/DATA_MODEL_COMPLEX.md` |
|
||||
| 组织人事 | _待补充_ | `PRD/组织人事管理/` | `DATA_MODEL/DATA_MODEL_ORG.md` |
|
||||
| 系统设置 | _待补充_ | `PRD/系统配置/`、`PRD/系统管理/` | `DATA_MODEL/DATA_MODEL_PUBLIC.md` |
|
||||
| 客源管理 | [`客源管理技术方案.md`](./客源管理技术方案.md) | `PRD/客源管理/` | `DATA_MODEL/DATA_MODEL_CLIENT.md` |
|
||||
| 楼盘管理 | [`楼盘管理技术方案.md`](./楼盘管理技术方案.md) | `PRD/房源管理/`（含楼盘） | `DATA_MODEL/DATA_MODEL_COMPLEX.md` |
|
||||
| 组织人事 | [`组织人事技术方案.md`](./组织人事技术方案.md) | `PRD/组织人事管理/` | `DATA_MODEL/DATA_MODEL_ORG.md` |
|
||||
| 系统设置 | [`系统设置技术方案.md`](./系统设置技术方案.md) | `PRD/系统配置/`、`PRD/系统管理/` | `DATA_MODEL/DATA_MODEL_SETTING.md` |
|
||||
| 客户端发布 | 见本文档 §7 | `PRD/发布管理/客户端发布管理模块PRD.md` | — |
|
||||
|
||||
**总览数据模型**：[`DATA_MODEL/DATA_MODEL.md`](../DATA_MODEL/DATA_MODEL.md)
|
||||
@@ -144,7 +144,51 @@ apps/property/
|
||||
|
||||
---
|
||||
|
||||
## 9. 测试策略
|
||||
## 9. 模块技术方案一致性矩阵（15 标准章节）
|
||||
|
||||
> 目的：确保各模块技术方案采用同构模板，便于 AI Agent 与开发同学横向查阅、执行与回归。
|
||||
|
||||
### 9.1 标准章节骨架（统一实现标准）
|
||||
|
||||
| 标准章节编号 | 标准章节名 |
|
||||
|---|---|
|
||||
| 1 | 文档定位与边界 |
|
||||
| 2 | 范围定义 |
|
||||
| 3 | 模块架构边界 |
|
||||
| 4 | API 设计原则 |
|
||||
| 5 | 端点清单（核心） |
|
||||
| 6 | 关键 API 规范（请求/响应） |
|
||||
| 7 | HTMX 交互约定 |
|
||||
| 8 | 权限与数据范围 |
|
||||
| 9 | 异步任务与缓存策略 |
|
||||
| 10 | 性能与可靠性约束 |
|
||||
| 11 | 安全与合规 |
|
||||
| 12 | 错误码建议 |
|
||||
| 13 | 测试映射 |
|
||||
| 14 | 落地顺序建议 |
|
||||
| 15 | 文档同步规则 |
|
||||
|
||||
### 9.2 模块覆盖情况（2026-04-27）
|
||||
|
||||
| 模块 | 技术方案文档 | 15 章节覆盖 | 备注 |
|
||||
|---|---|---:|---|
|
||||
| 登录认证 | `登录管理技术方案.md` | 15/15 | 完全覆盖 |
|
||||
| 权限管理 | `权限管理系统技术方案.md` | 15/15 | 完全覆盖 |
|
||||
| 房源管理 | `房源管理技术方案.md` | 15/15 | 完全覆盖 |
|
||||
| 客源管理 | `客源管理技术方案.md` | 15/15 | 完全覆盖 |
|
||||
| 楼盘管理 | `楼盘管理技术方案.md` | 15/15 | 完全覆盖 |
|
||||
| 组织人事 | `组织人事技术方案.md` | 15/15 | 完全覆盖 |
|
||||
| 系统设置 | `系统设置技术方案.md` | 15/15 | 完全覆盖 |
|
||||
|
||||
### 9.3 使用规则（对 AI Agent 生效）
|
||||
|
||||
- 新增模块技术方案时，必须按上表 15 章节骨架创建，不得自定义主结构。
|
||||
- 若模块存在特殊子节，可在对应主章节下扩展 `x.y`，但不得删除主章节。
|
||||
- PRD/TASK 范围变化后，先更新模块文档，再回填本矩阵覆盖状态。
|
||||
|
||||
---
|
||||
|
||||
## 10. 测试策略
|
||||
|
||||
> **完整测试规范**见：[`测试规范.md`](./测试规范.md)。本节仅列关键结论。
|
||||
|
||||
@@ -183,12 +227,13 @@ Fonrey 采用 AI vibe coding 模式开发，测试是保证每日迭代质量的
|
||||
|
||||
---
|
||||
|
||||
## 10. 文档维护原则
|
||||
## 11. 文档维护原则
|
||||
|
||||
- 本文档仅记录**跨模块共识**与**模块索引**，不展开模块细节
|
||||
- 模块技术方案在子文档中维护，并通过 §8 表格回链
|
||||
- 任何技术栈变更（替换组件、升级主版本、新增外部服务）须同步更新本文档 §2、§5、§6
|
||||
- 新增模块时，先在 §4 目录结构补位，再在 §8 索引登记子文档
|
||||
- 测试规范变更须同步更新 §9 关键结论，完整细节在 [`测试规范.md`](./测试规范.md) 中维护
|
||||
- 测试规范变更须同步更新 §10 关键结论，完整细节在 [`测试规范.md`](./测试规范.md) 中维护
|
||||
- 15 章节统一模板发生变更时，须先更新 §9 标准章节骨架，再同步各模块文档
|
||||
|
||||
|
||||
|
||||
Reference in New Issue
Block a user