新增笔记

2026-04-29 07:08:27 +08:00
parent faf3aa51bb
commit 15cd44b2ca
11 changed files with 2684 additions and 23 deletions
--- a/Project/fonrey/prompt/REVIEW
+++ b/Project/fonrey/prompt/REVIEW
@@ -6,7 +6,7 @@
 你的核心方法论：**以终为始**——从用户需求出发，验证每一层设计决策是否正确传导，找出断层、矛盾和遗漏。
 你的 Review 不是挑错，而是帮助团队在编码前发现最高代价的问题。

-**工作目录**：`~/Workspace/nexus`
+**工作目录**：`/mnt/d/Workspace/nexus`

 **你的职责边界**：
 - ✅ 负责：跨文档一致性检查、设计风险识别、遗漏场景挖掘、改进建议输出
@@ -29,54 +29,80 @@
 请读取以下文档，作为本次 Review 的全部输入：

 **产品文档（PRD）**：
+- PRD_MVP: `Project/fonrey/PRD/PRD_MVP.md`
 - 房源管理PRD: `Project/fonrey/PRD/房源管理/房源管理模块PRD.md`
 - 楼盘管理PRD: `Project/fonrey/PRD/房源管理/楼盘管理模块PRD.md`
 - 客源管理PRD: `Project/fonrey/PRD/客源管理/客源管理模块PRD.md`
 - 权限管理PRD: `Project/fonrey/PRD/权限管理/权限管理模块PRD.md`
 - 组织人事管理PRD: `Project/fonrey/PRD/组织人事管理/组织人事管理模块PRD.md`
- 系统管理PRD: `Project/fonrey/PRD/系统管理/系统管理模块PRD`
+- 系统管理PRD: `Project/fonrey/PRD/系统管理/系统管理模块PRD.md`
 - 登录管理PRD: `Project/fonrey/PRD/登录管理/用户登录管理模块PRD.md`
 - 发布管理PRD: `Project/fonrey/PRD/发布管理/客户端发布管理模块PRD.md`

 **技术文档**：
- TECH_STACK：`Project/fonrey/TECH_STACK/TECH_STACK.md`
+- 项目总TECH_STACK：`Project/fonrey/TECH_STACK/TECH_STACK.md`
 - 登录管理技术方案：`Project/fonrey/TECH_STACK/登录管理技术方案.md`
 - 权限管理技术方案：`Project/fonrey/TECH_STACK/登录管理技术方案.md`
- 测试规范：`Project/fonrey/TECH_STACK/测试规范`
+- 房源管理技术方案：`Project/fonrey/TECH_STACK/房源管理技术方案.md`
+- 楼盘管理技术方案：`Project/fonrey/TECH_STACK/楼盘管理技术方案.md`
+- 客源管理技术方案：`Project/fonrey/TECH_STACK/客源管理技术方案.md`
+- 系统管理技术方案:  `Project/fonrey/TECH_STACK/系统管理技术文档.md`
+- 系统设置技术方案：`Project/fonrey/TECH_STACK/系统设置技术方案.md`
+- API契约规范：`Project/fonrey/TECH_STACK/API_CONTRACT.md`
+- 测试规范：`Project/fonrey/TECH_STACK/测试规范.md`

 **数据模型**
- DATA_MODEL：`Project/fonrey/DATA_MODEL/DATA_MODEL.md`
+- 项目总DATA_MODEL：`Project/fonrey/DATA_MODEL/DATA_MODEL.md`
+- 登录DATA_MODEL: `Project/fonrey/DATA_MODEL/DATA_MODEL_LOGIN`
 - 房源 DATA_MODDL: `Project/fonrey/DATA_MODEL/DATA_MODEL_PROPERTY.md`
 - 客源 DATA_MODEL: `Project/fonrey/DATA_MODEL/DATA_MODEL_CLIENT.md`
 - 楼盘 DATA_MODEL: `Project/fonrey/DATA_MODEL/DATA_MODEL_COMPLEX.md`
 -  组织人事DATA_MODEL: `Project/fonrey/DATA_MODEL/DATA_MODEL_ORG.md`
 - 权限DATA_MODEL:`Project/fonrey/DATA_MODEL/DATA_MODEL_PERMISSION.md`
 - 系统管理DATA_MODEL: `Project/fonrey/DATA_MODEL/DATA_MODEL_PUBLIC.md`
+- 系统设置DATA_MODEL: `Project/fonrey/DATA_MODEL/DATA_MODEL_SETTING`
+- 统一枚举字典：`Project/fonrey/DATA_MODEL/ENUMS.md`
 	
 **UI 设计文档**：
 - UI SYSTEM：`Project/fonrey/UI_SYSTEM/UI_SYSTEM.md`
 - 组件清单：`Project/fonrey/UI_SYSTEM/组件清单.md`
+- 组件设计规范：`Project/fonrey/UI_SYSTEM/组件规范设计.md`
 - 模块UI Design:
-	- `Project/fonrey/UI_DESIGN/客源列表_UI.md`
-	- `Project/fonrey/UI_DESIGN/客源详情_UI.md`
-	- `Project/fonrey/UI_DESIGN/客源管理/新增客源_UI`
-	- `Project/fonrey/UI_DESIGN/客源管理/编辑客源_UI`
-	- `Project/fonrey/UI_DESIGN/房源管理/房源列表_UI`
+	- `Project/fonrey/UI_DESIGN/登录管理/登录_UI.md`
+	- `Project/fonrey/UI_DESIGN/房源管理/房源列表_UI.md`
+	- `Project/fonrey/UI_DESIGN/房源管理/房源详情_UI.md`
+	- `Project/fonrey/UI_DESIGN/房源管理/新增房源_UI.md`
+	- `Project/fonrey/UI_DESIGN/客源管理/编辑客源_UI.md`
+	- `Project/fonrey/UI_DESIGN/客源管理/客源列表_U.mdI
+	- `Project/fonrey/UI_DESIGN/客源管理/客源详情_UI.md`
+	- `Project/fonrey/UI_DESIGN/客源管理/新增客源_UI.md`
+	- `Project/fonrey/UI_DESIGN/楼盘管理/楼盘列表_UI.md`
+	- `Project/fonrey/UI_DESIGN/楼盘管理/楼盘详情_UI.md`
+	- `Project/fonrey/UI_DESIGN/UI_设计任务总表.md`

 **UI 原型页面**：
- UI SYSTEM: `Project/fonrey/UI_DESIGN/preview.html`
+- 总体页面预览: `Project/fonrey/UI_DESIGN/preview.html`
+- Tenant登录：`Project/fonrey/UI_DESIGN/登录_UI.html`
+- 经纪人登录：`Project/fonrey/UI_DESIGN/登录_账号密码_UI.html`
 - 客源列表：`Project/fonrey/UI_DESIGN/客源列表_UI.html`
 - 客源详情：`Project/fonrey/UI_DESIGN/客源详情_UI.html`
 - 编辑客源：`Project/fonrey/UI_DESIGN/编辑客源_UI.html`
 - 新增客源：`Project/fonrey/UI_DESIGN/新增客源_UI.html`
 - 房源列表：`Project/fonrey/UI_DESIGN/房源列表_UI.html`
+- 房源详情：`Project/fonrey/UI_DESIGN/房源详情_UI.html`
+- 楼盘列表：`Project/fonrey/UI_DESIGN/楼盘列表_UI.html`
+- 楼盘详情：`Project/fonrey/UI_DESIGN/楼盘详情_UI.html`

 **任务汇总**
 - TASK：`Project/fonrey/PRD/TASK.md`
+- 任务总表(优化提示词)：`Project/fonrey/PRD/TASK_AGENT_READY.md`
+- P0任务总表(优化提示词)：`Project/fonrey/PRD/TASK_AGENT_READY_P0.md`


 **其他参考文档**：
-
+- 历史Review报告：
+	- `Project/fonrey/REVIEW/REVIEW_全局_2026-04-25.md`
+	- `Project/fonrey/REVIEW/REVIEW_全局_2026-04-26.md`

 ---

--- a/Project/fonrey/prompt/提示词模板/API_CONTRACT_冲突提报模板_v1.md
+++ b/Project/fonrey/prompt/提示词模板/API_CONTRACT_冲突提报模板_v1.md
@@ -0,0 +1,78 @@
+# API_CONTRACT 冲突提报模板（可复用）
+
+> 版本：v1.0（2026-04-28）
+> 适用范围：`PRD/TASK_AGENT_READY*.md`、模块级 Agent 执行提示词、代码交付回执
+
+---
+
+## 1) 目的
+
+当实现与 `Project/fonrey/TECH_STACK/API_CONTRACT.md` 存在差异时，统一使用本模板提报，确保：
+
+- 冲突可审计（知道“哪里不一致”）
+- 影响可评估（前端/后端/测试/数据）
+- 处置可回滚（不阻断主干稳定性）
+
+> 约束：**不得擅自修改 API_CONTRACT**。先按契约实现；若确需调整，必须先提报并待确认。
+
+---
+
+## 2) 可直接粘贴到任务提示词的交付片段
+
+将以下段落放入每条任务的 `【交付格式】`：
+
+```md
+- API 契约核对清单（逐条对应 API_CONTRACT：已对齐/偏差项）
+- API 契约冲突说明（如无冲突写“无”）
+  - 冲突接口（Method + Path）
+  - 当前契约要求（来自 API_CONTRACT）
+  - 实现差异 / 建议改动
+  - 影响面（前端/后端/测试/存量数据）
+  - 回滚方案
+```
+
+---
+
+## 3) API 契约冲突提报单（标准格式）
+
+> 若“无冲突”，填写：`API 契约冲突说明：无`
+
+```md
+### API 契约冲突提报单
+- 任务ID：<US-XXX>
+- 关联模块：<登录/楼盘/房源/客源/...>
+- 冲突接口（Method + Path）：
+  - <GET|POST|PUT|PATCH|DELETE> <path>
+
+- 当前契约要求（来自 API_CONTRACT）：
+  - 请求参数：<必填/可选/类型/约束>
+  - 响应结构：<字段、类型、是否可空>
+  - 错误码：<code + 含义>
+
+- 实现差异 / 建议改动：
+  - 差异点1：<描述>
+  - 差异点2：<描述>
+  - 建议：<保持契约 / 调整契约（需审批）>
+
+- 影响面：
+  - 前端：<页面/组件/调用方>
+  - 后端：<视图/序列化器/服务层>
+  - 测试：<需新增/需修正的用例>
+  - 存量数据：<是否需要迁移/回填>
+
+- 风险等级：<低/中/高>
+- 临时兜底方案：<可选>
+- 回滚方案：<可执行步骤>
+- 需要确认人：<产品/后端负责人/前端负责人>
+- 期望确认时限：<YYYY-MM-DD HH:mm>
+```
+
+---
+
+## 4) 最小核对清单（提交前自检）
+
+- [ ] 已逐条对照 API_CONTRACT 的路径/方法/参数/响应/错误码
+- [ ] 已明确“无冲突”或填写完整冲突提报单
+- [ ] 已写明影响面（前端/后端/测试/数据）
+- [ ] 已给出可执行回滚方案
+- [ ] 未直接修改 API_CONTRACT 文档内容