diff --git a/Project/fonrey/客源详情_静态原型.html b/Project/fonrey/UI_DESIGN/客源详情_UI设计.html similarity index 100% rename from Project/fonrey/客源详情_静态原型.html rename to Project/fonrey/UI_DESIGN/客源详情_UI设计.html diff --git a/Project/fonrey/prompt/为 客源详情页生成模块 UI 设计文档.md b/Project/fonrey/prompt/为 客源详情页生成模块 UI 设计文档.md index 311e1ad8..65bae1df 100644 --- a/Project/fonrey/prompt/为 客源详情页生成模块 UI 设计文档.md +++ b/Project/fonrey/prompt/为 客源详情页生成模块 UI 设计文档.md @@ -19,8 +19,8 @@ ## 本次任务输入 ### 1. 目标模块 -**模块名称**:客源列表 -**模块描述**:客源列表 +**模块名称**:客源详情页 +**模块描述**:客源详情页 ### 2. PRD 功能文档路径 ``` 客源列表:`Project/fonrey/PRD/客源管理/客源管理模块PRD.md` 章节5.7 私客详情页 @@ -56,20 +56,14 @@ - 客源详情页Section6:客源信息概览 - `Project/fonrey/screenshots/客源/客源信息概览.png` - `Project/fonrey/screenshots/客源/编辑基础信息.png` - - `Project/fonrey/screenshots/客源/选择私客收藏夹.png` - - `Project/fonrey/screenshots/客源/创建私客收藏夹.png` - `Project/fonrey/screenshots/客源/改等级.png` - `Project/fonrey/screenshots/客源/改状态.png` - `Project/fonrey/screenshots/客源/转成交.png` - `Project/fonrey/screenshots/客源/选择成交房源.png` - - `Project/fonrey/screenshots/客源/转公客.png` - - `Project/fonrey/screenshots/客源/转无效.png` - 客源详情页Section7:联系人 - `Project/fonrey/screenshots/客源/联系人.png` - - `Project/fonrey/screenshots/客源/编辑联系人.png` - 客源详情页Section8:相关员工 - `Project/fonrey/screenshots/客源/相关员工.png` - - `Project/fonrey/screenshots/客源/编辑相关员工.png` ### 5. MVP 优先级参考 请参考 `Project/fonrey/PRD/PRD_MVP.md`,在设计文档中标注每个页面/功能的优先级(P0/P1/P2)。 diff --git a/Project/fonrey/客源详情_UI设计.md b/Project/fonrey/客源详情_UI设计.md deleted file mode 100644 index d9f9706d..00000000 --- a/Project/fonrey/客源详情_UI设计.md +++ /dev/null @@ -1,1743 +0,0 @@ -# 客源详情页 UI 设计文档 - -> **版本**:v1.0 · **日期**:2026-04-25 -> **依赖规范**:UI_SYSTEM.md v1.2 · 组件规范设计.md v1.0 -> **PRD 来源**:`Project/fonrey/PRD/客源管理/客源管理模块PRD.md` §5.7 私客详情页 -> **优先级**:P0 功能用 🔴 标注,P1 用 🟡,P2 用 ⚫ - ---- - -## 目录 - -1. [模块概述](#1-模块概述) - - 1.1 功能范围 - - 1.2 页面清单 - - 1.3 用户角色与权限差异 -2. [页面设计规范](#2-页面设计规范) - - 2.1 私客详情页 — 整体框架 - - 2.2 Section 左侧:需求信息 Tab - - 2.3 Section 左侧:跟进记录 Tab - - 2.4 Section 左侧:带看 Tab - - 2.5 Section 左侧:客源解读 Tab - - 2.6 Section 左侧:二手配房 Tab - - 2.7 Section 右侧:客源信息概览面板 - - 2.8 Section 右侧:联系人面板 - - 2.9 Section 右侧:相关员工面板 -3. [弹窗/抽屉设计规范](#3-弹窗抽屉设计规范) - - 3.1 编辑基础信息(Modal) - - 3.2 改等级(Modal) - - 3.3 改状态(Modal) - - 3.4 转成交(Modal) - - 3.5 选择成交房源(Modal 宽型) - - 3.6 写入跟进(Drawer) - - 3.7 新增带看(全页表单) - - 3.8 新增预约带看(全页表单) -4. [交互状态规范](#4-交互状态规范) - - 4.1 客源状态机 - - 4.2 权限控制矩阵 - - 4.3 HTMX 请求规范 -5. [关键数据字段说明](#5-关键数据字段说明) -6. [竞品截图对应关系](#6-竞品截图对应关系) -7. [实现优先级与工期估算](#7-实现优先级与工期估算) -8. [开放问题(待决策)](#8-开放问题待决策) - ---- - -## 1. 模块概述 - -### 1.1 功能范围 - -**P0 功能 🔴** -- 私客详情页整体框架(左右双栏布局 + Tab 导航) -- 需求信息查看与编辑 -- 跟进记录(全部/写入跟进/敏感信息跟进/修改跟进/其他跟进) -- 带看记录(预约带看 + 实际带看) -- 联系人查看与新增 -- 客源状态变更:改等级、改状态 -- 转公客 / 转成交 / 转无效 -- 右侧客源信息概览面板(基础字段展示 + 快捷操作) -- 相关员工查看 - -**P1 功能 🟡** -- 客源解读(AI 行为分析) -- 二手配房(录客配房 + 系统配房) -- 收藏功能 -- 待办提醒模块 -- 编辑基础信息(完整表单) - -**P2 功能 ⚫** -- 编辑信息来源 -- 查看操作日志 -- 名下房产修改 - ---- - -### 1.2 页面清单 - -| 页面名称 | URL 模式建议 | 优先级 | 对应 PRD 章节 | -|---|---|---|---| -| 私客详情页(主框架) | `/clients//` | P0 🔴 | §5.7.1 | -| 需求信息 Tab | `/clients//requirements/` (HTMX partial) | P0 🔴 | §5.7.2 | -| 跟进记录 Tab | `/clients//follow-logs/` (HTMX partial) | P0 🔴 | §5.7.2 | -| 带看 Tab | `/clients//viewings/` (HTMX partial) | P0 🔴 | §5.7.2 | -| 客源解读 Tab | `/clients//insights/` (HTMX partial) | P1 🟡 | §5.7.2 | -| 二手配房 Tab | `/clients//property-matches/` (HTMX partial) | P1 🟡 | §5.7.2 | -| 右侧信息面板 | `/clients//sidebar/` (HTMX partial) | P0 🔴 | §5.7.3 | -| 新增带看(全页) | `/clients//viewings/create/` | P0 🔴 | §5.7.2 | -| 新增预约带看(全页) | `/clients//viewings/appointment/create/` | P0 🔴 | §5.7.2 | - ---- - -### 1.3 用户角色与权限差异 - -| 功能/视图元素 | 经纪人(本人) | 经纪人(他人客源) | 店长 | 管理员 | -|---|---|---|---|---| -| 查看详情页 | ✅ | 受限(需权限) | ✅ | ✅ | -| 查看联系人号码明文 | ✅(有操作留痕) | ❌ | ✅ | ✅ | -| 写入跟进记录 | ✅ | ❌ | ✅ | ✅ | -| 编辑需求信息 | ✅ | ❌ | ✅ | ✅ | -| 改等级/改状态 | ✅ | ❌ | ✅ | ✅ | -| 转公客/转成交/转无效 | ✅ | ❌ | ✅ | ✅ | -| 编辑相关员工 | ❌ | ❌ | ✅ | ✅ | -| 查看操作日志 | 部分 | ❌ | ✅ | ✅ | -| 敏感信息跟进查看 | ✅(本人) | ❌ | ✅ | ✅ | -| 转公客后操作 | ❌ | ❌ | ✅ | ✅ | - -> 注:联系人号码查看必须留痕(自动写入 `log_type='sensitive_view'` 的 `client_follow_logs` 记录)。 - ---- - -## 2. 页面设计规范 - -### 2.1 私客详情页 — 整体框架(P0 🔴) - -#### 2.1.1 页面概述 - -- **URL**:`/clients//` -- **访问入口**:客源列表点击任意行 → 跳转详情页;面包屑返回列表 -- **页面职责**:集中展示私客的全量信息,提供跟进、带看、状态变更等核心操作入口 -- **竞品参考截图**:`Project/fonrey/screenshots/客源/私客详情.png` - -#### 2.1.2 布局结构 - -``` -┌────────────────────────────────────────────────────────────────────────┐ -│ 顶部导航栏(全局,来自 base.html,高度 48px) │ -├────────────────────────────────────────────────────────────────────────┤ -│ 面包屑导航(客源 / 客源管理 / {客源标题}) │ -├──────────────────────────────────────┬─────────────────────────────────┤ -│ │ │ -│ 左侧主内容区(约 68% 宽度) │ 右侧信息面板(约 32% 宽度) │ -│ ───────────────────────────── │ ───────────────────────── │ -│ [Tab 导航栏] │ [客源标题 Banner(橙色)] │ -│ 需求信息 | 跟进记录 | 带看 | │ [状态标签行] │ -│ 客源解读 | 智能配房 │ [基础字段列表] │ -│ │ [展开全部 链接] │ -│ [Tab 内容区(HTMX 动态加载)] │ [快捷操作按钮组] │ -│ │ [状态变更操作网格] │ -│ │ [待办提醒区块] │ -│ │ [联系人区块] │ -│ │ [相关员工区块] │ -│ │ │ -└──────────────────────────────────────┴─────────────────────────────────┘ -``` - -#### 2.1.3 区域详细规范 - -**[面包屑导航区]** - -| 属性 | 说明 | -|---|---| -| 组件 | 原生 HTML `