LLZQ-XCX/doc/prd.md

一、文档信息

• 产品名称：球房运营助手（微信小程序）
• 版本：V1.0（原型版，全权限视角）
• 撰写日期：YYYY-MM-DD
• 适用平台：微信小程序（iOS / Android 手机竖屏）
• 文档范围：仅描述小程序前端界面与交互行为，不包含后端服务和接口字段定义。

---

二、背景与目标

本小程序用于提升台球厅经营管理效率，为店长、助教管理、助教等内部人员提供任务管理、业绩查看、运营看板和智能助手对话能力。

当前阶段目标：

• 交付一套基于“全功能、全权限角色视角”的微信小程序前端原型。
• 明确各页面布局、组件及交互行为，便于前端和原型工具直接实现。
• 角色权限控制、数据口径、字段来源均由后端与后续迭代处理，原型仅展示有权限时的页面样式。

---

三、范围与约束说明

1. 设备与环境

   • 仅面向手机端微信小程序（iOS / Android），竖屏使用。
   • 暂不考虑 iPad 等大屏适配。

2. 门店范围

   • 当前仅支持一个店铺场景，后端如扩展多门店，在后续版本处理。

3. 权限与角色

   • 原型以“全功能视角”展示所有模块与入口。
   • 实际上线时，不同角色（店长/管理层/助教管理/助教）的权限由后端接口控制，对无权限功能采取“入口隐藏”的方式。
   • 原型中不绘制模块级“无权限访问”占位状态。

4. 接口与数据

   • 本文不描述具体接口、字段名、数据结构。
   • 各类展示字段以接口实际返回为准，本文若举例字段，仅为示意，不代表完整字段列表。

5. 登录/申请流程的权限提示

   • 登录后如账号未通过审核或无访问权限，将展示对应状态页（审核中、无权限），这属于整体访问控制，不属于“模块权限占位”，在原型中需要体现。

---

四、角色说明（仅用于理解，不做权限逻辑）

• 店长 / 公司管理层：实际场景中拥有全功能权限。
• 助教管理：看板中财务板块不可见（上线时通过隐藏入口实现）。
• 助教：看板中财务板块和助教板块不可见（上线时通过隐藏入口实现）。

原型中统一以“全功能视角”展示，不做差异。

---

五、全局设计规范

5.1 语言与格式

• 语言：简体中文。

• 金额单位：

  • 元：取整，不显示小数。
  • 万元：保留两位小数。

• 时间显示格式：

  • 标准格式：YYYY-MM-DD HH:mm:ss
  • 在不影响理解情况下，可根据页面需要简化为 YYYY-MM-DD 或 MM-DD HH:mm 等，具体由设计与前端协商。

5.2 导航与返回规则

• 底部一级导航（TabBar）：

  • Tab 顺序：任务 / 看板 / 我的

  • 文字：任务、看板、我的

  • 每个 Tab 对应一个一级页面，点击 Tab 时：

    • 若当前已在该 Tab 内的子页面，点击 Tab 返回该 Tab 的根页面，并滚动至顶部。

• 顶部导航：

  • 除特别说明外，二级/详情页隐藏微信原生导航栏，使用自定义头部，左上角为返回图标，行为为返回上一页面。

• 弹窗与浮层：

  • 使用标准底部弹出或中部弹窗，与微信交互习惯一致。

5.3 悬浮助手按钮

• 悬浮按钮在所有业务页面（任务、看板、我的及其子页面）显示，不在“登录/申请/审核中/无权限”页面显示。
• 默认位置：页面右下角（不遮挡底部 TabBar），随页面滚动悬浮。
• 点击行为：进入“助手对话页面”，默认打开最近一次会话（若有）。

5.4 提示、错误与加载状态

• 网络异常 / 接口错误（列表/卡片区域）

  • 在对应数据区域显示文字：加载失败，请点击重试
  • 下方提供“重试”按钮，点击重新请求该区域数据。
  • 作为所有列表/卡片区域的统一错误样式。

• 空数据状态

  • 统一使用简单文字：

    • 列表类统一为：暂无数据 或根据场景显示 暂无任务 等。

  • 不使用插画或占位图。

• 加载状态

  • 使用区域加载：在列表或卡片区域显示文字：加载中...
  • 不做骨架屏和复杂动画。

---

六、信息架构与页面列表

6.1 顶层结构

• 登录相关

  • 登录页
  • 账号申请页
  • 审核中页
  • 无权限页

• Tab 1：任务

  • 任务列表页（默认首页）
  • 任务详情页
  • 业绩详情页

• Tab 2：看板

  • 看板首页（含：财务 / 客户 / 助教 三级视图）
  • 客户详情页
  • 助教详情页

• Tab 3：我的

  • 我的首页
  • 备注记录页
  • 助手对话记录页
  • 首页设置页
  • 退出账号（确认弹窗）

• 全局

  • 助手对话页

---

七、关键流程说明

7.1 登录与申请流程

1. 用户打开小程序 → 登录页。

2. 点击“使用微信登录”，完成微信授权。

3. 登录后：

   • 若查无此用户，也无此用户提交过申请 → 进入账号申请页。
   • 若查到该用户提交过申请，状态为“审核中” → 进入“审核中”状态页。
   • 若查到该用户提交过申请，状态为“拒绝/未通过” → 进入“无权限”状态页。
   • 若查到该用户申请已通过 → 跳转至用户设置的默认首页（初始为“任务”页）。

7.2 默认首页配置流程

• 初始默认首页为“任务”。
• 用户可在“我的 → 首页设置”中将首页设置为：任务 / 看板。
• 设置为“切换即保存”，与账号绑定（不因退出登录而重置）。

---

八、页面级需求

以下各页面按【页面名称 / 入口 / 布局结构 / 功能与交互 / 状态】描述。

---

8.1 登录与访问控制相关

8.1.1 登录页

入口

• 小程序启动未登录状态。

布局结构

• 顶部：App Logo 占位 + 应用名称（球房运营助手）。

• 中部：一句产品描述文案，例如：

  • 为台球厅提升运营效率的内部管理工具

• 底部区域：

  • 主按钮：使用微信登录（微信授权登录入口）。

  • 下方文案 + 勾选框：

    • 复选框 + 文案：我已阅读并同意《用户协议》和《隐私政策》
    • 协议名称为可点击文本（具体跳转页面可后续补充）。

功能与交互

• 用户必须勾选协议复选框才能点击“使用微信登录”，否则按钮为禁用态。
• 点击“使用微信登录”调用微信授权流程，登录成功后进入流程 7.1 所述分支。
• 登录失败时，在底部弹出错误提示（Toast），重试留在本页。

---

8.1.2 账号申请页

入口

• 登录成功后，系统查无该用户及其申请记录时。

布局结构

• 顶部：标题 申请访问权限。

• 主体：

  • 文本说明：简单说明需要申请原因，例如：

    • 请填写申请说明，审核通过后即可使用小程序功能。

  • 表单区：

    • 字段 1：

      • 标签：申请说明，带红色星号（必填）。
      • 多行文本输入框，用于填写自我介绍、岗位、所属门店等说明（具体内容由用户自由填写）。

• 底部：

  • 主按钮：提交申请

功能与交互

• “申请说明”为必填，如为空则点击“提交申请”时在输入框下方显示错误提示：申请说明不能为空。
• 提交成功后，进入“审核中”页。
• 接口错误时，弹出错误提示，停留在本页。

---

8.1.3 审核中页

入口

• 登录后发现该用户有申请记录，状态为“审核中”。

布局结构

• 居中展示：

  • 图标（等待/审核中占位图标）。
  • 标题文案：申请审核中
  • 说明文案：例如：您的访问申请正在审核中，请稍后再试或联系管理员。

• 不提供其他操作按钮，保持不可操作状态。

功能与交互

• 用户可关闭小程序或退出；再次进入时仍按登录逻辑判断状态。

---

8.1.4 无权限页

入口

• 登录后发现该用户申请状态为“拒绝/未通过”，或无访问权限。

布局结构

• 居中展示：

  • 图标（禁止/无权限占位图标）。
  • 标题文案：无访问权限
  • 说明文案：例如：您的访问申请未通过，或当前账号无访问权限。如需使用，请联系管理员。

• 不提供操作按钮，不可操作状态。

功能与交互

• 用户可关闭小程序或退出；如后续权限变更，再次登录时可进入首页。

---

8.2 Tab：任务

8.2.1 任务列表页（默认首页）

入口

• 底部 TabBar 点击“任务”。
• 登录通过后，如未设置其他默认首页，则默认进入本页。

整体布局

• 顶部：自定义导航栏（标题：任务），左侧无返回按钮。
• Banner 区：当前用户信息与业绩概览。
• 任务列表：按紧急程度排序的任务列表。
• 悬浮助手按钮：右下角。

Banner 区内容

• 展示内容示例：

  • 第一行：用户名 + 身份（例如：张三 / 助教）
  • 第二行：一句聚合文案，例如： 本月目标 5 万，已完成 3 万，任务 50 个，完成进度 60%
  • 第三行：X 月预计收入：12345 元（单位为元，取整）

• Banner 整块区域可点击，跳转至“业绩详情页”。

任务列表结构

• 列表为单列列表，不按任务类型分组，仅通过排序和颜色区分。

• 排序规则：按紧急程度从高到低排序，类型依次为：

  • 高优先召回（红）
  • 优先召回（橙）
  • 关系构建（粉）
  • 客户回访（蓝）

单条任务卡片布局

• 第一行（标题行）：

  • 左侧：任务类型标签（带背景色的颜色块或 icon），颜色按类型区分（红/橙/粉/蓝）。
  • 紧随其后：客户姓名。
  • 右侧：> 箭头图标，提示可点击进入详情。

• 第二行（补充行）：

  • 核心信息 + 召回说明，具体字段根据当前任务类型与接口返回内容展示，例如：最近到店时间、召回原因、优先级说明等。

• 其他：

  • 不提供搜索框和筛选组件，任务集合由接口控制。

交互说明

• 点击整条任务卡片：进入“任务详情页”。

• 长按任务卡片：在长按位置上方弹出黑底浮层菜单，样式类似微信对话长按菜单，菜单项：

  • 任务置底
  • 问问助手
  • 备注

• “任务置底”：前端仅调用接口，排序规则由后端控制；前端不单独维护生命周期状态。

• “问问助手”：跳转至“助手对话页”，以该任务信息为引用，开启新对话主题。

• “备注”：弹出底部浮层，输入备注内容并保存，备注按时间排序纳入“备注记录”。

空状态

• 当列表为空时，在列表区域居中显示文案：暂无任务。

---

8.2.2 任务详情页

入口

• 任务列表页点击某条任务。

布局结构

• 顶部：自定义导航栏

  • 左：返回按钮 <
  • 中：标题，例如 任务详情

• 主体内容区：

  • 模块一：客户基本信息

    • 示例字段：姓名、手机号、会员编号、性别、标签（如 VIP/新客）、所属门店等（以接口为准）。

  • 模块二：消费习惯

    • 文本描述形式，例如：“偏好晚间 21:00 后到店，喜欢中式台球，平均消费 300 元/月”等。

  • 模块三：与我的关系

    • 等级：很好 / 好 / 一般 / 较陌生
    • 每个等级附带一段文字说明（例如“最近 3 个月每周均有1次课程”等）。

  • 模块四：任务建议

    • 纯文本内容，给出执行建议、沟通话术提示等。

• 底部固定操作栏：

  • 左按钮：问问助手
  • 右按钮：备注

交互说明

• 问问助手：

  • 跳转至助手对话页。
  • 以当前任务的关键信息（任务类型、客户名、任务说明等）作为引用内容，显示为灰底卡片，用户在其下输入文本发送。
  • 通过此入口固定新建一个新对话主题。

• 备注：

  • 底部弹出浮层，包含备注输入框和“保存”按钮。
  • 保存后生成一条备注记录，类型标记为“任务备注”，记入“备注记录”，按照创建时间倒序展示。

---

8.2.3 业绩详情页

入口

• 任务列表页 Banner 区点击。

布局结构

• 顶部 Banner：

  • 展示：用户名 + 身份 + 本月业绩进度 + 本月预计收入。

  • 示例：

    • 第一行：张三（助教）
    • 第二行：本月目标：5 万，已完成：3 万，任务：50 个，完成进度：60%
    • 第三行：本月预计收入：1.23 万元

• 下方内容区：多组指标，以两列卡片布局展示。

指标分组示意

• 分组一：收入构成
• 分组二：台球助教业绩
• 分组三：充值业绩
• 分组四：酒水业绩

每组都有组标题一行，下面为两列卡片网格。

单个指标卡片内容

• 布局：

  • 卡片内上下两行，可视为“名称行 + 数据行”。

• 字段：

  • 指标名称
  • 当前值
  • 目标值
  • 完成度（百分比）

• 对齐与单位：

  • 数值区居中对齐。

  • 单位规则：

    • 元：整数，无小数。
    • 万元：保留 2 位小数。
    • 完成度：使用 %。

交互

• 页面整体可滚动。
• 卡片本身无需额外交互（本期不跳转、不长按）。

时间范围

• 本页仅展示当前“本月”的业绩数据，不提供时间周期切换。

---

8.3 Tab：看板

8.3.1 看板首页（含财务/客户/助教）

入口

• 底部 TabBar 点击“看板”。

顶部区域

• 一级标签（顶部 Tab）：

  • 财务 / 客户 / 助教
  • 默认选中：财务（原型中展示全功能视角）

筛选区域

• 位置：一级标签下方。

• 展示方式：多标签筛选按钮，每个按钮点击后展开下拉菜单，交互类似外卖/点评类应用。

• 联动规则：

  • 更改任一筛选条件后，立即刷新当前视图数据（无需额外“确定”按钮）。
  • 不提供“重置筛选”按钮。

滚动行为

• 当用户向上滚动列表内容时，筛选区域保持吸顶显示。
• 当用户向下快速滚动时，可自动收起/隐藏筛选区域，仅保留一级 Tab，增强可视区域。
• 向上滚动时再次展示筛选区域。

---

8.3.2 看板 – 财务视图

入口

• 看板顶部 Tab 选择“财务”（默认）。

筛选条件

• 条件 1：时间月份

  • 选项：

    1. 本月（默认）
    2. 上个月
    3. 最近 3 个月
    4. 最近半年
    5. 本季度
    6. 上个季度
    7. 本周
    8. 上周
    9. 指定时间周期

  • 选择“指定时间周期”时：

    • 打开日期区间选择组件，可选择开始日期与结束日期。
    • 最大跨度：366 天。
    • 当用户选择的时间跨度超过 366 天时，非模态提示：例如 时间跨度不可超过 366 天，并阻止该选择生效。

• 条件 2：区域

  • 选项：

    1. 全部（默认）
    2. 大厅（子级：A 区、B 区、C 区）
    3. 麻将房
    4. 团建房
    5. 具体房间台桌

  • 选择“具体房间台桌”时：

    • 弹出选择弹窗，列表单选。
    • 列表按“大厅 / 麻将房 / 团建房”分组展示具体房间或台桌。
    • 如接口获取失败或为空，在弹窗中显示：网络错误，请重试，并提供“重试”入口。

财务汇总行

• 展示位置：筛选区域下方第一行。

• 分为三列：

  • 当前筛选条件下实际收入
  • 当前筛选条件下实际支出
  • 当前筛选条件下净利润

• 显隐与“预计”字样：

  • 某些筛选条件下不显示支出与净利润，由接口控制。
  • 某些时间维度（例如本月、本周等）可显示“预计”字样：12345 元（预计），由接口在数据中标记。

内容分区

分为四个部分，依次：

1. 营业数据
2. 收入构成
3. 支出构成
4. 利润构成

每一部分包含：

• 标题行：如 营业数据
• 指标卡片区：每行 3 个卡片，自动换行。

指标卡片结构

• 每个卡片：

  • 第一行（标题行）：左侧图标（简单占位）、右侧为指标名称（例如“总流水”、“客单价”等）。

  • 第二行（详情行）：文字 + 数值，或文字 / 数值单独展示：

    • 例如：本期：12345 元，或 毛利率：35%。

• 指标列表（示意，实际由接口控制）：

  • 营业数据：总流水、客单价、开台数、场次、平均停留时长等。
  • 收入构成：桌费、助教费、酒水、餐饮、包房费、其他。
  • 支出构成：房租、水电、人工、耗材、推广等。
  • 利润构成：毛利、净利、毛利率、净利率等。

交互

• 长按任意指标卡片：

  • 启动助手对话，跳转至“助手对话页”，以该指标为引用内容（来源：财务看板 + 指标名 + 当前数值等），开启新对话主题。

• 列表下拉刷新，重新拉取数据。

---

8.3.3 看板 – 客户视图

入口

• 看板顶部 Tab 选择“客户”。

筛选条件

• 条件 1：客户类型

  • 最近到店：按最近到店时间由近到远。
  • 最应召回：按当天召回因子由高到低（默认）。
  • 最近充值：按充值时间由近到远。
  • 最高消费：最近 60 天到店消费金额由高到低（不含充值）。
  • 最高余额：按单个客户所有会员卡金额总计由高到低。
  • 最频繁：最近 60 天到店次数由多到少。
  • 潜力股：最近 60 天到店间隔有缩短趋势的客户。
  • 最专一：最近 60 天使用助教服务 ≥10 次，且 ≥8 次为同一助教，最近 2 次均为该助教。

• 条件 2：偏爱项目

  • 不限（默认）
  • 中式/追分
  • 斯诺克
  • 麻将
  • 团建

助教身份默认筛选（后台行为，前端不显式展示）

• 当登录用户身份为“助教”时，后台默认增加过滤条件：仅显示最近 14 天内该助教提供过课程服务的客户。
• 前端不提供取消或修改该条件的开关，也不在 UI 中单独标识。

客户列表卡片布局

• 第一行：

  • 左侧：

    • 客户名称
    • 等级标（如等级图标或字母 A/B/C）
    • VIP 标识（如“VIP”标签），有则显示。

  • 右侧：最喜欢的助教列表，文字形式展示，例如：

    • 💖 助教A、💖 助教B、💛 助教C...
    • 最多展示前三，超过则以省略号表示。

• 第二行：

  • 当前排序条件对应的核心指标（如召回因子、储值金额、累计消费等）。
  • 最近到店时间（副文案）。
  • 可在末尾增加一句简短说明，例如：最近 30 天到店 5 次 等。

其他字段

• 在“最高余额”等维度时，应显示该客户当前余额字段（由接口提供），格式按金额规则显示。

交互

• 点击客户卡片：进入“客户详情页”。
• 长按客户卡片（可选）：可考虑后续扩展为快速备注或助手入口，本期可不实现。

---

8.3.4 客户详情页

入口

• 看板 – 客户视图列表点击某客户。

布局

• 顶部导航：标题 客户详情，左侧返回按钮。

• 模块一：客户基本信息

  • 示例字段：姓名、手机号、会员编号、性别、等级、VIP 标识、所属门店等。
  • 手机号可支持点击拨号（后续实现时决定）。

• 模块二：消费习惯

  • 标签 + 文本说明的形式：

    • 标签示例：常来夜场、偏爱中式、高客单价 等。
    • 文本说明：简要描述消费偏好、时段、频率等。

• 模块三：与我的关系

  • 等级：很好 / 好 / 一般 / 较陌生。
  • 等级下附文字说明，描述互动频率、最近服务情况等。

• 底部固定操作栏：

  • 问问助手
  • 备注

交互

• 问问助手：

  • 跳转到助手对话页。
  • 引用当前客户的关键信息（客户名、ID、最近消费等）作为灰底引用卡片。
  • 开启新对话主题。

• 备注：

  • 底部弹出备注输入浮层，类型标记为“客户备注”，保存后进入“备注记录”。

---

8.3.5 看板 – 助教学视图

入口

• 看板顶部 Tab 选择“助教”。

筛选条件

• 条件 1：排序维度

  • 创收最多（默认）：按该助教带来的球房流水由高到低。
  • 创收最低：按球房流水由低到高。
  • 业绩最高：按业绩完成百分比由高到低。
  • 业绩最低：按业绩完成百分比由低到高.
  • 工资最高：按工资由高到低。
  • 工资最低：按工资由低到高。
  • 潜在客源储值：按该助教客户关系 >0.7 的所有客户储值金额总和由高到低。

• 条件 2：擅长项目

  • 不限（默认）
  • 中式/追分
  • 斯诺克
  • 麻将
  • 团建

• 条件 3：时间月份

  • 同财务视图：本月（默认）、上月、最近 3 个月、最近半年、本季度、上个季度、本周、上周、指定时间周期。
  • “指定时间周期”同样使用日期区间选择组件，并限制最大跨度 366 天，超出时非模态提示。

助教列表卡片布局

• 第一行：

  • 左侧：

    • 助教姓名
    • 等级标（如星级/等级）
    • 擅长项目（标签形式，展示主擅长方向）。

  • 右侧：

    • 关系最好的客户列表，展示客户名称和关系指数（例如：客户A 0.98、客户B 0.92、客户C 0.89...），最多展示前三，超过以省略号表示。

• 第二行：

  • 当前排序维度对应的数值信息，附单位/说明：

    • 如创收最多：本期流水：12345 元
    • 业绩最高：完成度：87%
    • 工资：本期工资：8000 元
    • 上课时长等（小时）。

• 不显示头像。

交互

• 点击助教卡片：进入“助教详情页”。

---

8.3.6 助教详情页

入口

• 看板 – 助教视图列表点击某助教。

布局

• 顶部导航：标题 助教详情，左侧返回按钮。

• 模块一：助教基本信息

  • 字段示例：姓名、工号、所属门店、擅长项目、等级等。

• 模块二：流水与业绩

  • 本月带来的球房流水（数值，单位元或万元）。
  • 最近 3 个月带来的球房流水（数值）。
  • 综合业绩完成度（一个总进度百分比）。

• 模块三：工资与上课时长

  • 本月工资总额。
  • 对应时间段的上课总时长（小时）。

• 模块四：前 10 个客户指数最高的客户列表

  • 列表项字段：客户名 + 指数数值（0～1 或百分比展示）。

• 底部固定操作栏：

  • 问问助手
  • 备注

交互

• 问问助手：以助教信息和主要指标为引用，开启新对话主题。
• 备注：对该助教添加备注记录，类型为“助教备注”。

---

8.4 Tab：我的

8.4.1 我的首页

入口

• 底部 TabBar 点击“我的”。

布局

• 顶部：用户信息区域

  • 用户名、身份（店长/助教等）、所属门店等信息。

• 列表菜单项：

  • 备注记录
  • 助手对话记录
  • 首页设置
  • 退出账号

交互

• 点击各行进入对应子页面或触发弹窗。

---

8.4.2 备注记录页

入口

• “我的”首页点击 备注记录。

布局

• 标题：备注记录

• 列表按时间倒序（由近到远）平铺，不按日期分组。

• 每条记录显示：

  • 备注全文（不做截断或只做必要的单行/多行控制）。
  • 关联对象：例如 客户：张三 / 任务：XXX / 助教：李四。
  • 创建时间。

交互

• 点击备注记录：不进入详情页（即本页即为详情展示），不支持编辑/删除。
• 列表为空时：显示 暂无数据。

---

8.4.3 助手对话记录页

入口

• “我的”首页点击 助手对话记录。

布局

• 标题：助手对话记录

• 列表项字段：

  • 对话标题：由接口返回（一般为首条消息摘要）。
  • 最近一次对话时间。
  • 消息条数概览（例如：共 25 条消息）。

• 列表按最近更新时间倒序。

交互

• 点击某条记录：

  • 进入“助手对话页”，直接打开该会话。
  • 默认滚动到该对话的最后一条消息位置。

• 不提供删除对话能力。

• 列表为空时：显示 暂无数据。

---

8.4.4 首页设置页

入口

• “我的”首页点击 首页设置。

布局

• 标题：首页设置

• 内容：

  • 单选列表：

    • 任务
    • 看板

  • 每项前有单选圆点，当前选中项高亮。

• 底部：返回按钮。

交互

• 用户点击某一选项后立即生效，作为新的默认首页设置（切换即保存，不需要额外保存按钮）。
• 退出账号不会清除该设置，再次登录仍使用该默认首页。

---

8.4.5 退出账号（确认弹窗）

入口

• “我的”首页点击 退出账号。

交互

• 弹出确认弹窗：

  • 标题：确认退出

  • 文案：确认退出当前账号吗？

  • 按钮：

    • 取消
    • 退出

• 点击“退出”：

  • 清除登录态。
  • 不清理由于当前账号相关的本地配置（如首页设置、筛选条件等）。
  • 跳转回“登录页”。

• 点击“取消”：关闭弹窗，留在“我的”页。

---

8.5 全局：助手对话页

8.5.1 入口

• 悬浮助手按钮。
• 任务详情页底部按钮“问问助手”。
• 客户详情页底部按钮“问问助手”。
• 助教详情页底部按钮“问问助手”。
• 看板各视图中长按指标启动助手。
• “助手对话记录”页点击某一条历史记录。

8.5.2 聊天形式

• 对话双方：用户（“我”）与“助手”。

• UI 全面仿微信对话界面：

  • 左侧：助手气泡，显示助手头像（固定）和名称。
  • 右侧：用户气泡，显示用户头像和名称。

• 对话记录：

  • 最近 50 条消息默认加载。
  • 上拉加载更早记录。

8.5.3 引用内容展示

• 从任务/客户/助教/看板等入口进入助手时，将引用上下文：

  • 引用内容显示为一块灰底小卡片，位于即将发送的消息气泡上方。

  • 卡片内容包括：

    • 来源类型：任务 / 客户 / 助教 / 看板（具体子模块如财务/客户看板等）。
    • 标题或名称（例如客户名、任务标题、指标名）。
    • 部分摘要文案或关键数据。

• 引用内容不可编辑，用户只能在下方输入框中补充自己的提问文本后发送。

8.5.4 会话管理

• 每个“新对话主题”形成一个独立会话，出现在“助手对话记录”列表中。

• 来源：

  • 从“助手对话记录”进入：

    • 直接打开对应会话，加载历史记录，滚动到最后一条消息。

    • 如距最后一条消息超过 1 小时，在输入框区域上方显示横条提示，提供两个按钮：

      • 新对话主题
      • 继续对话

    • 选择“新对话主题”：清空当前对话展示区域，开始新的对话会话，该会话作为新条目记录在“助手对话记录”中，历史对话仍保留在原会话条目中。

    • 选择“继续对话”：在当前会话中继续发送消息，对话标题不变。

  • 从任务/客户/助教/看板入口的“问问助手”或长按启动：

    • 固定开启“新对话主题”，不受 1 小时规则影响，始终新建会话，并带入引用内容。

8.5.5 输入与发送

• 输入区包含：

  • 文本输入框。
  • “按住说话”按钮（语音转文字）。
  • 发送按钮。

语音转文字交互

• 点击“按住说话”按钮并按住：

  • 显示录音状态动画，松开后结束录音并开始识别。

• 识别结果展示在输入框中，用户可编辑后再点击“发送”。

• 识别失败时，弹出提示：识别失败，请重试，不发送消息。

键盘与滚动行为

• 键盘弹出时，列表自动滚动到底部，确保最新消息和输入框可见。
• 发送消息后，自动滚动到底部。

---

九、非功能性要求

• 关键页面（任务列表、看板页、助手对话页）首次可接受加载时间：≤ 10 秒（在普通网络环境下）。

• 看板页面数据：

  • 各数据块采用懒加载策略，优先加载当前视图及首屏必要数据，其他部分可在滚动时或后台加载，避免一次性加载过多影响首屏体验。

• 本阶段不做埋点与统计需求设计。