# VISTA Link—顾客预约列表需求

| 项目 | 内容 |
|---|---|
| 页面与范围 | VISTA Link · 来场预约 · 顾客预约列表；查看、筛选、分页及详情入口 |
| 版本与日期 | V0.8 · 2026-11-01 |
| 编写人 | Codex，根据独立需求及会话确认整理 |
| 资料来源 | [顾客预约列表原文 V0.6](https://alidocs.dingtalk.com/i/nodes/G1DKw2zgV222NAlxfd5PBgGBVB5r9YAn)、[顾客预约详情原文 V0.8](https://alidocs.dingtalk.com/i/nodes/vy20BglGWOrrDgLziDXvnbNB8A7depqY)，2026-11-01读取；采用2026-10-30已确认的系统自动登记或关联规则，2026-11-01用户确认列表移除来源链接、详情保留来源，以及简化列表字段名称 |

## 一、页面要完成什么

本页中的“顾客预约”指顾客针对某个活动提交的一次预约记录。活动保存名称、接待地址、可预约时段和预约问题；顾客预约保存本次提交的时间、联系方式及回答。

具有当前项目“来场预约”菜单及“查看来场预约”操作权限的成员，在来场预约模块中进入本页。成员查看项目预约，找到需要查看提交内容、安排负责人或准备接待的预约，再进入预约详情。

全部预约的查看范围为当前项目。成员通过当前顾客负责人筛选，查看指定成员负责顾客的预约。

系统管理员进入本页时，同样使用当前项目有效的成员关系、菜单及操作权限。权限变化立即生效。

## 二、页面组成

### 2.1 查看范围与查找

| 内容 | 含义与操作 |
|---|---|
| 预约日期范围 | 按预约填写的希望来场日期查找，日期使用日本时间 |
| 负责人 | 按关联顾客当前负责人查找，包含“未分配”条件 |
| 清除筛选 | 按第3.1节恢复全部预约范围 |

筛选只查找当前项目的预约。项目切换使用公共项目入口，本页数据随当前项目变化。

### 2.2 预约列表

| 字段 | 展示内容与数据来源 |
|---|---|
| 活动 | 本条预约所属活动当前保存的名称；活动改名后显示最新名称 |
| 预约者 | 本次预约提交时填写的姓名 |
| 预约时间 | 本次预约填写的日期和时间 |
| 顾客 | 系统自动登记或关联的顾客；原顾客已删除时显示“已删除顾客” |
| 顾客当前负责人 | 关联顾客资料中的当前负责人；负责人为空时显示“未分配” |

“预约时间”指预约提交时选择的希望来场日期和时间；“负责人”指关联顾客的当前负责人。来源链接、材料名称和链接类型在预约详情展示。

预约记录提供详情入口。预约者姓名和关联顾客分别表示提交时填写的人与已确定归属的顾客，展示时使用各自数据。

### 2.3 分页

列表按预约提交时间倒序排列，每页默认 10 条。分页区域显示总条数和当前范围，并提供每页条数选择。可选条数使用系统通用分页组件的既有选项。

### 2.4 与活动配置的关系

活动名称、接待地址、可预约时间及预约问题在活动配置中维护。有“来场预约”菜单及“配置活动”操作权限的成员，从活动列表进入新建或编辑活动配置；本页负责查找顾客已提交的预约。入口及配置规则见[活动配置需求](https://alidocs.dingtalk.com/i/nodes/93NwLYZXWy99vRDZC0zYkgw3WkyEqBQm)，采用本地 V0.12。

## 三、操作规则

### 3.1 查看与筛选预约

首次进入或重新进入本页时，重新读取当前项目全部预约，日期和负责人均不设条件，每页恢复默认10条，页码回到第一页。列表按第2.3节排列。日期和当前顾客负责人共同生效，结果须同时符合所有已选条件。选择或更改筛选条件后立即更新结果，并回到第一页；翻页保留当前条件。希望来场日期范围按日本时间计算，包含开始日期和结束日期当天。

点击“清除筛选”时，清除日期和负责人，回到第一页并显示当前项目全部预约。

“未分配”匹配关联顾客当前负责人为空的预约。顾客关联结果由系统自动登记或关联，列表读取已保存的顾客关系。

顾客负责人发生变化后，列表展示和负责人筛选使用新的当前负责人。预约提交时的姓名、联系方式、问题及回答保持原值。负责人分配、修改及通知见[总需求 §4.4.6、§4.7.5](https://alidocs.dingtalk.com/i/nodes/N7dx2rn0Jb66LrvBTZkMPZN4JMGjLRb3)。

### 3.2 打开预约详情

成员从一条预约进入该预约详情，查看当时的表单回答、来源及关联情况。提交内容、来源和关联顾客资料入口见[顾客预约详情需求](https://alidocs.dingtalk.com/i/nodes/vy20BglGWOrrDgLziDXvnbNB8A7depqY)。

从详情返回列表时，按第3.1节的重新进入规则恢复默认列表。

已删除顾客的预约保留原顾客标识、问题、回答和来源，顾客列按第2.2节显示。恢复原顾客后，预约归属保持原值。预约详情中的顾客资料入口按[总需求 §4.7.3](https://alidocs.dingtalk.com/i/nodes/N7dx2rn0Jb66LrvBTZkMPZN4JMGjLRb3)所指的顾客预约详情需求执行。

### 3.3 加载、空结果与读取失败

读取列表期间提供加载反馈，使用[总需求 §6.2](https://alidocs.dingtalk.com/i/nodes/N7dx2rn0Jb66LrvBTZkMPZN4JMGjLRb3)规定的加载状态。

当前项目没有预约时显示“暂无来场预约”。筛选后没有匹配预约时显示“没有符合条件的预约”。读取失败时说明错误并提供重试，使用错误状态表示读取失败。

全部分享材料关闭预约入口时，已有预约和本页继续保留，具有预约查看权限的成员仍可查看；活动配置按第2.4节办理。

### 3.4 权限与项目变化

查看预约同时检查菜单与查看操作权限。缺少菜单权限时隐藏菜单；直接打开无权地址时显示无权限及“返回上一页”。执行操作时重新检查权限，无权操作提示“无权执行此操作”。失去当前页面查看权限时停止展示预约内容，并显示无权限页面。

切换项目后读取目标项目权限和预约，原项目数据保持原值。项目访问关闭时返回项目列表。相关规则见[总需求 §4.11.2、§4.12.8、§6.2、§6.4](https://alidocs.dingtalk.com/i/nodes/N7dx2rn0Jb66LrvBTZkMPZN4JMGjLRb3)。

### 3.5 语言、日期与等待时间

界面按浏览器语言偏好使用日文或英文，均不匹配时使用英文；中文用于内部需求沟通。用户填写内容保持原语言。日期显示为 YYYY-MM-DD，时间为 HH:mm，使用日本时间。

列表首次打开至首屏默认 10 条及主要操作可用的目标为 2 秒内；提交筛选条件至结果可查看为 1 秒内。测量条件按[总需求 §5、§6.3](https://alidocs.dingtalk.com/i/nodes/N7dx2rn0Jb66LrvBTZkMPZN4JMGjLRb3)写入测试计划。

## 四、业务流程

### 4.1 查找预约并查看提交内容

成员需要查看某次预约、了解预约者填写的接待需求时，从当前项目顾客预约列表开始，按需使用日期及当前顾客负责人筛选，找到目标预约后进入详情，查看希望来场时间、当次回答与来源。

```mermaid
flowchart TB
    A["查看当前项目的顾客预约列表"] --> B{"是否需要筛选"}
    B -->|需要| C["按日期或当前顾客负责人设置条件"]
    B -->|不需要| D["查看全部预约"]
    C --> E{"是否有符合条件的预约"}
    E -->|没有| F["查看无匹配结果提示"]
    F --> G["调整或清除筛选条件"]
    G --> E
    E -->|有| H["在结果中找到目标预约"]
    D --> H
    H --> I["进入该预约详情"]
    I --> J["查看希望来场时间、当次回答与来源"]
```

查找条件、无匹配结果及读取失败按第3.1、3.3节处理。从详情返回列表时，按第3.2节恢复默认列表。详情中的顾客资料入口和接待准备使用该页需求。