文档修改

This commit is contained in:
Shen Wei
2026-04-26 19:50:01 +08:00
parent d2ae5b3948
commit d42bc16120
28 changed files with 6697 additions and 2545 deletions

View File

@@ -737,21 +737,21 @@ HTMX loading 触发:在 `<div id="client-list-container">` 添加 `hx-indicato
表头行:`<thead class="bg-neutral-50">`,列头单元格统一样式:`px-4 py-3 text-left text-xs font-semibold text-neutral-500 uppercase tracking-wide whitespace-nowrap`
数据行:`<tr class="hover:bg-neutral-50 transition-colors" style="height:56px">`
| # | 列名 | 数据字段 | 列宽 | 对齐 | 可排序 | 特殊渲染说明 |
|---|---|---|---|---|---|---|
| 1 | (复选框) | — | `w-10`40px`px-4` | 居中 | 否 | 全选:表头 `<input type="checkbox" id="select-all">`;单选:行内 `<input type="checkbox" x-model="selected" :value="client.id">` |
| 2 | 姓名 | `contact_name` + `grade_display` + 活跃度标签 | `min-w-[160px] max-w-[200px]` | 左对齐 | 否 | 蓝色链接 `text-info-600 hover:underline`;下方渲染 Grade Badge + 活跃度 Tag见 §3.2 |
| 3 | 状态 | `status_display` | `w-20`80px | 左对齐 | 否 | Status Badge见 §3.2 |
| 4 | 需求类型 | `requirement_type_display` | `w-20`80px | 左对齐 | 否 | 纯文字:二手 / 新房 / 租房 |
| 5 | 需求/解读 | `budget_area_display` | `min-w-[180px]` | 左对齐 | 否 | 截断 `truncate`Tooltip 展示完整内容(`title` 属性) |
| 6 | 智能配房 | `match_count` | `w-24`96px | 左对齐 | 否 | `N套` + Heroicon `information-circle``w-4 h-4 text-neutral-400 ml-1 cursor-pointer`);点击弹出配房预览 Popover |
| 7 | 意向商圈/小区 | `intent_location_display` | `min-w-[120px]` | 左对齐 | 否 | 多值逗号分隔;`-` 表示未填;截断 `truncate max-w-[160px]` |
| 8 | 归属人 | `owner_display` | `min-w-[140px]` | 左对齐 | 否 | 格式:`姓名-门店组``text-sm text-neutral-700` |
| 9 | 带看进度 | `viewing_progress_display` | `w-20`80px | 左对齐 | 否 | 「未带看」灰色文字;「一看」`bg-warning-50 text-warning-600 px-2 py-0.5 rounded-full text-xs`;「二看」`bg-info-50 text-info-600`;「复看」`bg-success-50 text-success-600` |
| 10 | 带看次数 | `viewing_count` | `w-[72px]` | 左对齐 | 是 | `N次`;点击列头触发 HTMX 排序 |
| 11 | 委托日期 | `commission_date` | `w-24`96px | 左对齐 | 是 | `YYYY-MM-DD`;未填显示 `-` |
| 12 | 最近时间 | `last_follow_display` / `last_contact_display` | `w-24`96px | 左对齐 | 是(默认降序) | `N天前` / `今天`;超过 30 天字色 `text-danger-600` |
| 13 | 操作 | — | `w-16`64px | 居中 | 否 | 见 §3.3 |
| # | 列名 | 数据字段 | 列宽 | 对齐 | 可排序 | 特殊渲染说明 |
| --- | ------- | ---------------------------------------------- | ----------------------------- | --- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| 1 | (复选框) | — | `w-10`40px`px-4` | 居中 | 否 | 全选:表头 `<input type="checkbox" id="select-all">`;单选:行内 `<input type="checkbox" x-model="selected" :value="client.id">` |
| 2 | 姓名 | `contact_name` + `grade_display` + 活跃度标签 | `min-w-[160px] max-w-[200px]` | 左对齐 | 否 | 蓝色链接 `text-primary-600 hover:underline`;下方渲染 Grade Badge + 活跃度 Tag见 §3.2 |
| 3 | 状态 | `status_display` | `w-20`80px | 左对齐 | 否 | Status Badge见 §3.2 |
| 4 | 需求类型 | `requirement_type_display` | `w-20`80px | 左对齐 | 否 | 纯文字:二手 / 新房 / 租房 |
| 5 | 需求/解读 | `budget_area_display` | `min-w-[180px]` | 左对齐 | 否 | 截断 `truncate`Tooltip 展示完整内容(`title` 属性) |
| 6 | 智能配房 | `match_count` | `w-24`96px | 左对齐 | 否 | `N套` + Heroicon `information-circle``w-4 h-4 text-neutral-400 ml-1 cursor-pointer`);点击弹出配房预览 Popover |
| 7 | 意向商圈/小区 | `intent_location_display` | `min-w-[120px]` | 左对齐 | 否 | 多值逗号分隔;`-` 表示未填;截断 `truncate max-w-[160px]` |
| 8 | 归属人 | `owner_display` | `min-w-[140px]` | 左对齐 | 否 | 格式:`姓名-门店组``text-sm text-neutral-700` |
| 9 | 带看进度 | `viewing_progress_display` | `w-20`80px | 左对齐 | 否 | 「未带看」灰色文字;「一看」`bg-warning-50 text-warning-600 px-2 py-0.5 rounded-full text-xs`;「二看」`bg-info-50 text-info-600`;「复看」`bg-success-50 text-success-600` |
| 10 | 带看次数 | `viewing_count` | `w-[72px]` | 左对齐 | 是 | `N次`;点击列头触发 HTMX 排序 |
| 11 | 委托日期 | `commission_date` | `w-24`96px | 左对齐 | 是 | `YYYY-MM-DD`;未填显示 `-` |
| 12 | 最近时间 | `last_follow_display` / `last_contact_display` | `w-24`96px | 左对齐 | 是(默认降序) | `N天前` / `今天`;超过 30 天字色 `text-danger-600` |
| 13 | 操作 | — | `w-16`64px | 居中 | 否 | 见 §3.3 |
> **自定义列**P1 🟡用户通过「自定义列表」弹窗§4.1)选择显示字段后,后端将用户配置存入 `UserColumnPreference`Django 模板根据配置动态渲染列头和列单元格。可选字段见截图 `客源列表-自定义字段.png`:录入日期、最近通话日期、用途、来源、客源编号、首录人、成交人等。