# 客户签约看板 · 修订指令归档 V1

**归档日期**：2026-10-22
**用途**：逐轮保留用户原始指令，供溯源与复核
**使用规则**：本归档不作为并行需求重复执行；与《客户签约看板_标准提示词_V1.md》冲突时，以标准提示词第 14 章裁决为准。

**材料顺序说明**：用户提供的材料中，多轮修订指令在前，基础需求与数据结构在后。为便于阅读，本归档按「基础需求 → 修订轮次 R1–R14」重排，文字内容逐字保留，仅统一了标题层级与编号。

**脱敏说明**：基础需求中的数据库口令不在此重复记录；样例数据中的个人联系电话已省略，仅保留客户与业务字段，避免在文档中扩散个人联系方式。

---

## 第一部分　基础需求（原始构建指令）

### A0 任务声明

设计一个精美的网页，用户展示 mysql 数据表的数据；
网页名称：客户签约看板

### A1 版本管理

- 所有文件均采用版本后缀进行迭代，例如 V1、V2，以此类推。
- 每次修改必须生成新文件，严禁覆盖旧版本。
- 生成的文件内容中，除用户另有要求外，需明确标注版本修改记录，例如「V2 相对 V1 的差异」「V2 的修改位置与说明」等。

### A2 项目文档

- 在项目根目录下建立完整的项目说明文件（如 README 或 Manifest），用于记录项目概况与迭代历程。
- 目的是让其他 AI 或智能体在接手项目时，能够快速理解项目背景、结构与历史变更。

### A3 任务处理

- 每次新建空白对话开始新任务时，需在对应项目文件夹下新建一个子目录，用于存放本次对话生成的文件和处理记录。
- 例外情况：若用户明确约定将文件存放在其他位置，则优先按用户约定执行。

### A4 项目部署

1. 自动部署与访问（需要用户确认终稿后说上传指令再执行本项）
   - 使用 baota-mcp 部署到云服务器。
   1. 为项目自动分配一个访问域名或端口。

### A5 页面布局

1. 导航结构
   - 页面左侧配置可折叠/收起的二级目录，支持点击跳转，优化阅读时的空间利用率。
2. 响应式设计
   - 页面需完美适配移动端，确保在 PC 和手机端均能获得一致、清晰的视觉体验。
3. 视觉规范
   - 主色调统一为 `#1677FF`。
   - 设计需层次分明、极简直观。
   - 全页配色严格控制在 5 种以内（亮橙色、蓝色、浅蓝、灰色、白色）。

### A6 复杂任务处理

- 当任务过于复杂时，可将其拆解为多个步骤分步执行：完成上一步并校验成功后，再进入下一步。
- 某一步骤执行失败或存在问题时，可循环执行「修复 → 校验」流程，直至问题解决。
- 如果用户的输入存在歧义，或包含多个不明确的意图，可先询问用户确认具体意图，再进行后续处理。
- 本智能体每轮执行超过 60 分钟就会出现：OpenClaw run failed，所以需要进行拆分和自动化分步骤执行任务。

### A7 数字显示规范

- 当数值超过 10000 时，使用「万」作为单位进行展示，并保留 1 位小数。
- 示例：12345 → 1.2万；156789 → 15.7万；10001 → 1.0万。
- 若用户明确要求使用原始数字或其他单位展示，则优先按用户约定执行。

### A8 数据库连接

```
远程地址：tx.zhengl.vip
本机地址：127.0.0.1
端口：3306
用户名：zkcrm
密码：（按安全要求不在文档中记录，配置于服务端）
数据库名称：zkcrm
数据表：jdy_data_11
```

> 线上 1.0 实际使用 `jdy_data_20`（61 条），`jdy_data_11` 有 9 条，字段结构一致。表名已配置化，见标准提示词第 3.2 节与第 15 章 Q01。

### A9 字段说明

| 字段名称 | 字段 ID/字段别名 | 字段类型 | 说明 |
|---|---|---|---|
| 表单名称 | formName | string | |
| 数据 ID | _id | string | 数据的唯一 ID |
| 应用 ID | appId | string | 应用的唯一 ID |
| 表单 ID | entryId | string | 表单的唯一 ID |
| 提交人 | creator | json | status -1 表示离职；0 表示未加入；1 表示已加入 |
| 修改人 | updater | json | status -1 表示离职；0 表示未加入；1 表示已加入 |
| 删除人 | deleter | json | status -1 表示离职；0 表示未加入；1 表示已加入 |
| 提交时间 | createTime | string | 使用 UTC 时间戳，请根据所在时区处理 |
| 更新时间 | updateTime | string | 使用 UTC 时间戳，请根据所在时区处理 |
| 删除时间 | deleteTime | string | 使用 UTC 时间戳，请根据所在时区处理 |
| 流程状态 | flowState | number | 2 表示流程手动结束；1 表示流程已完成；0 表示流程进行中 |
| 选择连锁 | _widget_1791449342204 | json | |
| 连锁 ID | _widget_1791449342205 | string | |
| 销售 | _widget_1791449342208 | json | status -1 表示离职；0 表示未加入；1 表示已加入 |
| 区域 | _widget_1791449342211 | string | |
| 连锁名称 | _widget_1791449342206 | string | |
| 签约主体名称 | _widget_1791449342209 | string | |
| 门店数 | _widget_1792048325259 | number | |
| 连锁类型 | _widget_1792048325267 | string | |
| 连锁业务对接人姓名 | _widget_1791882979503 | string | |
| 连锁业务对接人联系电话 | _widget_1791882979504 | json | 格式为 `{"phone":"13800000000","verified":false}` |
| 连锁技术对接人姓名 | _widget_1791882979505 | string | |
| 连锁技术对接人联系电话 | _widget_1791882979506 | json | 格式为 `{"phone":"13800000000","verified":false}` |
| 签约时间 | _widget_1791510326270 | string | 使用 UTC 时间戳，请根据所在时区处理 |
| 服务开始时间 | _widget_1791449342217 | string | 使用 UTC 时间戳，请根据所在时区处理 |
| 服务结束时间 | _widget_1791449342218 | string | 使用 UTC 时间戳，请根据所在时区处理 |
| 客服 | _widget_1791509478932 | json | status -1 表示离职；0 表示未加入；1 表示已加入 |
| 培训人 | _widget_1791509478935 | json | status -1 表示离职；0 表示未加入；1 表示已加入 |
| 基础资料 | _widget_1791510696565 | array | |
| 优惠券 | _widget_1791510696561 | array | |
| 对接结果 | _widget_1792029306426 | string | |
| 对接备注 | _widget_1791596350260 | string | |
| 渠道信息 | _widget_1791509478941 | array | |
| 已开通策略 | _widget_1791964258708 | array | |
| 未开通策略原因 | _widget_1791964258722 | string | |
| 区域负责人手机号码 | _widget_1791453695943 | string | |
| 流程状态 | _widget_1791533061604 | string | |
| 是否开通 | _widget_1792072044675 | string | |

### A10 核心指标

- 合计的客户数
- 按区域汇总客户数
- 按连锁类型汇总客户数
- 按流程状态汇总客户数
- 按销售汇总客户数

### A11 支持筛选

通过右上角按钮：

- 日期：今日、昨日、本周、本月、上周、上月、自定义日期区间（默认为全部）（按签约时间）
- 区域：南区、北区

### A12 显示明细

- 默认显示：连锁 ID、连锁名称、连锁类型、门店数、销售、客服、培训人、当前状态、当前处理人
- 其他字段默认隐藏

### A13 明细筛选

- 按连锁类型：全国百强、区县百强、50+、50-
- 按流程状态：签约、开通、系统对接、系统测试、渠道费充值、使用培训、落地跟进、流程完成

### A14 字段设置

明细可以支持用户设置显示或隐藏字段。

### A15 视觉与适配

- 主色调：蓝色，默认为浅色调；右上角支持颜色切换
- 适应：分为 2 个页面，一个页面适应手机查看，一个页面适应 PC 查看

### A16 样例数据

原始指令附有 5 条 `jdy_data_11` 记录（贵州一树、湛江黄府、佛山佛心、广东日兴、重庆三江、养天和、安康国康等），用于字段结构示例。样例中的个人联系电话已省略。样例数据不作为统计口径依据，生产数据以数据库为准。

---

## 第二部分　修订轮次

### R1　明细弹窗与移动端重构

按照下面要求修改

PC 端：
修复点击明细没有弹出这个客户详细信息的问题

手机版：
重构整个页面，使其更加好看简洁

### R2　标题栏区隔与备案

按照下面要求修改

手机版：
修复标题栏与内容区域没有明显区别的问题，标题栏要有背景区隔出来
修复流程状态分布箭头不好看的问题，整个板块优化

PC 端：
修复明细表连锁类型中，50+ 数字没有标签和颜色的问题

全局：
取消底部的备案信息

### R3　间距与筛选能力

按照下面要求修改

手机版：
标题的 LOGO 向右移 20px，整个标题的 LOGO、名称、右侧按钮下移 15px；颜色切换左移 20px

电脑版：
修复明细表筛选列，没有在当页显示的数据，无法筛的问题；
明细表的筛选仅对以下列有：连锁类型、销售、客服、培训人、当前状态、区域、签约时间
明细表的筛选和搜索对没有数据生效而不是仅对当前页数据生效
修复明细表：连锁类型列的标签显示问题，4 个不同类型的标签，除了颜色不一致其他的长宽高都要一致

### R4　移动端贴边、密码与 PC 细节

按照下面要求修改

手机端：
修复 logo 过于靠上靠左的问题
修复颜色切换按钮过于靠上靠右问题
流程箭头错位问题

PC 端：
设置字段需要输入密码
流程箭头要高一些，大气一些
修复连锁类型分布的 4 个卡片下方空白太多问题
优化明细表每页条数切换使用下拉框
修复点击明细表的页码后，整个页面都要刷新的问题
修复点击明细表的筛选后没有生效的问题（明细的筛选只对明细生效，不影响上方卡片）
在明细标题的最右方显示搜索框，可以通过连锁名称搜索明细
标题栏的英文修改为：最新数据同步时间，底部就不需要这个信息

### R5　2.0 PC 端重构

按照下面要求修改：

2.0 的 PC 端：
筛选时按钮放在标题栏，而不是把所有内容都列出来放在标题栏下方
表格中的目标客户，实际为当前合作客户
省区卡片不需要显示客服的信息
每个的表示是当前已合作 X 家，已签约 X 家；各省的卡片没排显示 5 个；省份作为卡片标题，销售作为标签放在标题栏；总进去采用半圆图表；下面的全国百强，区县百强，50+ 采用进度条
不需要「### 南区 · 各省 × 连锁类型 明细」
销售开发进度用卡片呈现和省份结构一致，负责省份用标签表示
吉林省一笑堂大药房连锁有限公司的客户类型为 50-
流程状态分布采用和 1.0 一致的导航图方式呈现，但是把系统测试和渠道费充值调整为客服处理，再下方列出客服处理的 11 个步骤，并把客户分配进去
指标卡片，图表布局严格参考 1.0 的；只是在 1.0 的基础上增加内容

### R6　继承 1.0、本机备份与双看板

按照下面要求修改：

新看板要继承之前看板的所有功能包括指标和筛选等能力，是在原有看板基础上增加
省份卡片的上方要标注销售
客服的 1-10 步骤是继承之前看板流程的系统测试和渠道费充值
差异和异常数据放在最下方
后续所有产生的文件都需要在本机预留一份，各个版本更新的历史版本需要在本机留一份备份。
结合看板的数据和以下的表格重新输出以下内容：
- 一份智能体客户看板 2.0（仅 PC 端）
- 一份南区专属看板

### R7　LOGO 替换

按照下面要求修改

全局：
LOGO 替换为：`https://wenjian.zhengl.vip/zkkj/logof.png`

### R8　移动端筛选与流程状态

按照下面要求修改手机端：
修复顶部按钮和标题栏过度靠边的问题
底部的 4 个按钮分别为
- 日期：可以筛选日期
- 筛选：可以筛选区域、连锁类型、流程状态、销售人、日期（按顺序从上至下）
- 字段：可以设置明细显示的字段
- 刷新：可以刷新最新的数据
优化流程状态分布，使其 2 行显示，并且颜色和图标与 PC 版一致
顶部标题栏不需要电脑按钮，只需要切换颜色按钮即可；默认根据手机系统的深色或浅色切换
标题栏的英文修改为：最新数据同步时间，底部就不需要这个信息

### R9　明细排序、卡片对齐与排行榜

按照下面要求修改：
底部明细表按签约时间排序，最新的显示在最前面，支持用户按字段排序
底部明细表不要出现下拉条，默认显示 10 条，支持用户设置显示 10、20、50 条；拉高页面，不要在表格单独出现下拉进度条
调整第 3 排 3 个卡片的内容位置，不要出现大量的空白，确保内容顶部和底部对齐
明细表的连锁类型标签要与上方卡片保持一致的颜色
培育与落地中修改为培训与落地中
修复销售排行榜中 1、2、3 的数字没有在圆角矩形居中的问题

### R10　提示、进度图与排行榜样式

按照下面要求修改：
修复手机端黑底白字的提示信息不会自动销售的问题
手机端的任务完成进度也要使用半圆的进度图
修复 PC 端销售排行榜数字没有居中的问题
调整销售排行榜，标签值只显示 1 行最多 3 个，如果出现 4 个就隐藏 50-
修复销售排行榜，名字后面的 6 家客户与最右侧的 6 客户数重复
修复趋势图不好看的问题

### R11　排行、流程弹窗与全局配色

按照下面要求修改：
PC 版销售排版下方显示展示全部，点击后进行销售排行榜榜单
销售排行榜每个销售下方的连锁类型用标签形式显示，标签名称用一般字体，数量用加粗字体
- 全国百强：红底白字
- 区县百强：橙底白字
- 50+：蓝底白字
- 50-：灰底黑字
流程状态分布，不要使用太多花哨的颜色
PC 的日期选择日历设计的大气一些，点击自定义区间的日期输入框即弹出日历，一次性选择开始日期到结束日期
销售排行榜首页的颜色为：
- 第一名：红色
- 第二名：橙色
- 第三名：黄色
- 第 4-5 名：蓝色
- 第 5 名以后：黑色
整个页面的橙色和红色需要调整橙色的色调使其与红色拉开差异

### R12　半圆进度、备案与流程明细

按照下面要求修改：
任务完成进度使用半圆的进度图
PC 端的最下方不要显示手机版连接，显示备案号蜀 ICP 备 19008580 号和连接
PC 端的流程状态分布，点击对应状态弹窗显示这个状态的客户明细
全局页面中南北区的配送、连锁类型的配送要全局一致
手机端下方显示一个筛选按钮，与明细、字段、刷新放在一起；不要把筛选项目单独作为按钮显示

### R13　主数据、排行榜与移动端首屏

按照下面要求修改：
任务完成进度的主数据使用进度图
卡片右上角不需要点击查看明细和点击阶段可筛选明细的文字
销售排行榜显示前 5 位，PC 端点击后弹窗显示完整榜单，按门店数和按客户数按钮只有点开榜单后才显示，在首页不显示
签约趋势跳过非工作日
PC 端的签约明细存在问题请修复
手机端第一排显示签约客户和签约门店数 2 个卡片
手机端不需要流程完成卡片
手机端的筛选按钮放在下方，不在导航栏下方显示筛选按钮

### R14　移动端专项修复（16 条）

按照下面要求修复或优化手机版：
1. 手机版明细没有显示完整时销售排名下方的标签只统计显示明细的而不是全部的数据
2. 整个页面只需要蓝、绿、橙、红 4 种颜色和黑白灰
3. 不要再每个标签上方都重复显示 43 家
4. 筛选按钮的显示顺序为：区域、连锁类型、流程状态、销售人、日期
5. 不要在卡片下方添加当前筛选结果的描述
6. 参考 PC 版的布局和指标重新设计页面布局
7. 连锁类型的标签颜色为
   - 全国百强：红
   - 区县百强：橙
   - 50+：蓝
   - 50-：灰
8. 搜索连锁的搜索框放到明细下方
9. 手机版不要顶部不要有连锁类型筛选按钮，所有的筛选按钮都集中到底部，底部的 4 个按钮分别为
   - 日期：可以筛选日期
   - 筛选：可以筛选日期、区域、销售人、流程状态、连锁类型
   - 字段：可以设置明细显示的字段
   - 刷新：可以刷新最新的数据
10. 不要汇总统计区域数和销售人数；而是要通过卡片显示南区北区分别有多少客户数、门店数、各连锁类型多少家、各流程状态多少家
11. 按销售汇总要排名，按客户数排名，按门店数排名；并且显示每个销售签约的客户类型有多少家
12. 签约明细要显示签约时间，按日期显示格式为 XX 月 XX 日
13. 按连锁类型汇总、按流程状态汇总、按销售汇总不需要折叠
14. 网页底部不要显示数据源，显示最新一条数据同步时间
15. 点击刷新后，刷新不要弹窗显示正在刷新，而是刷新按钮旋转

> 原文编号从 10 直接跳到 12，缺第 11 条编号；本归档保留原编号空缺，实际条目共 15 条。

### R15　PC 端专项（11 条 + 布局与指标）

按照下面要求修改 PC 版：
1. 点击手机版显示二维码而不是直接跳转
2. 不要汇总统计区域数和销售人数；而是要通过卡片显示南区北区分别有多少客户数、门店数、各连锁类型多少家、各流程状态多少家
3. 按流程状态采用从左至右的一条导航图的方式显示，点击各个阶段可以显示对应阶段的连锁数
4. 所有的卡片点击后显示对应的连锁明细
5. 按销售汇总改为按销售排名，支持按客户数排名，按门店数排名；并且显示每个销售签约的客户类型有多少家；默认显示前 5 的销售；默认按客户数排名，同样客户数的按门店数排名
6. 签约明细要显示签约时间，按日期显示格式为 XX 月 XX 日；明细 1 行显示 1 条信息，点击每个列的表头都要能支持按本列筛选
7. 不要再多个卡片显示共 41 家
8. 网页底部不要显示数据源，显示最新一条数据同步时间
9. 最上方的筛选板块整理为按钮放置到导航栏中
10. 添加趋势图卡片，按日期汇总最近 7 日签约客户数和签约门店数

其他：
不要再页面中添加无关的描述如：mysql 实时同步、数据源等信息
明细默认显示 20 条，可以翻页和设置每页显示：20、50 条
访问主域名是通过识别设备自动跳转手机和 PC 版

11. 整体页面布局
- 顶部：导航栏
- 第 1 排：
  - 签约客户：按客户汇总，同时显示南区客户数和北区客户数；用圆环图显示；中间为汇总数，左右为北区数；南区用蓝色，北区绿色。
  - 门店总数：按客户汇总，下面是南区门店数和北区门店数
  - 任务完成进度：呈现进度条，总任务数 500 家，南区任务 220 家，北区任务 280 家
  - 进行中：流程状态不是流程完成的客户数，左边显示 4 行数据，策略处理中（流程状态为开通的客户数），实施处理中（流程状态为系统对接的客户数），客服处理中（流程状态为系统测试或渠道费充值的客户数），培育与落地中（流程状态为使用培训和落地跟进的客户数）
  - 流程完成：显示流程状态为流程完成的客户数
- 第 3 排：
  - 左侧（约 25）：连锁类型分布：显示全国连锁、区县百强、50+、50- 的客户数和门店数，以及南区客户数和北区客户数
  - 左侧（约 25）：销售排行榜：按客户数排名，按门店数排名；并且显示每个销售签约的客户类型有多少家；默认显示前 10 的销售；默认按客户数排名，同样客户数的按门店数排名
  - 右侧（约 50）：签约趋势图，近 7 个工作日签约趋势，可以通过点击关闭和打开指标
    - 指标 1：签约客户数（堆叠柱形图），南区蓝色，北区绿色
    - 指标 2：签约门店数（曲线图）
- 第 2 排：每个流程的客户数，用流程图的方式呈现
- 第 4 排：明细表

### A17 部署指令（原始）

完成后通过 baota-mcp 部署到云服务器，分配域名 zk1.zhengl.vip

---

## 第三部分　口径速查

完整口径见标准提示词第 4 章。以下为高频项速查。

| 项目 | 结论 |
|---|---|
| 任务目标 | 总 500、南区 220、北区 280 |
| 流程状态 | 签约、开通、系统对接、系统测试、渠道费充值、使用培训、落地执行、落地跟进、流程完成 |
| 导航节点 | 签约、开通、系统对接、客服处理、使用培训、落地执行、落地跟进、流程完成 |
| 连锁类型 | 全国百强=红、区县百强=橙、50+=蓝、50-=灰 |
| 区域色 | 南区=蓝、北区=绿 |
| 主色 | `#1677FF` |
| 明细默认条数 | 20，可切 50 |
| 排行榜首页条数 | 5，完整榜单在弹窗 |
| 趋势 | 最近 7 个工作日，跳过周末 |
| 日期格式 | `MM月DD日` |
| 大数 | ≥10000 用「万」，1 位小数 |
| 页脚 | 蜀ICP备19008580号 + 最新数据同步时间 |

---

**归档结束**