# VISTA Link—活动配置需求 | 项目 | 内容 | |---|---| | 文档版本 | V0.12 | | 更新日期 | 2026-11-01 | | 适用总需求 | [VISTA Link 产品需求文档 V0.264](https://alidocs.dingtalk.com/i/nodes/N7dx2rn0Jb66LrvBTZkMPZN4JMGjLRb3) | ## 一、页面要完成什么 具有当前项目“来场预约”菜单和“配置活动”操作权限的成员，在新建活动或编辑已有活动时进入本页，填写活动名称、接待地址、可预约日期和时间，按需选择活动负责人，并设置顾客需要回答的问题。成员预览并保存后，指向该活动的预约入口使用最新配置。 新建与编辑共用本页。新建活动从来场预约模块的活动列表进入；编辑时，成员先在活动列表找到目标活动，再从该活动的编辑入口进入本页。顾客预约列表用于查看提交记录，活动配置从活动列表进入。 活动是可被预约的事情。活动配置保存名称、接待地点、可选时间、负责人和预约问题；顾客针对活动提交后，产生属于该活动的一条顾客预约记录。 每份分享材料是否显示预约入口，由材料配置决定。访客在Origin C 端展示页内填写活动预约，完整填写和提交规则由《展示页内预约表单说明》定义。营销链接及绑定顾客的分享链接均可提供预约入口，入口及访问资格使用[总需求§4.6.1、§4.7、§4.12.8](https://alidocs.dingtalk.com/i/nodes/N7dx2rn0Jb66LrvBTZkMPZN4JMGjLRb3)。 ## 二、页面组成 ### 2.1 活动名称 名称用于后台识别活动，并向顾客展示活动名称。只设置一份名称，必填；去除首尾空白后须有内容。允许同一项目内的活动重名，各活动分别保存配置和预约记录；名称不另设业务字数上限。 新建时名称为空；编辑时带入该活动最近保存的名称。 ### 2.2 接待地址 接待地址包含以下五项，保存在当前活动。新建时均为空，编辑时带入已保存内容。 | 字段 | 含义 | 填写要求 | |---|---|---| | 邮编 | 接待地点的邮政编码 | 必填 | | 都道府县 | 接待地点所属都道府县 | 必填 | | 市区町村 | 接待地点所属市区町村 | 必填 | | 町名、番地 | 町名及街道门牌等详细地址 | 选填 | | 建筑名、房号 | 建筑名称、楼层或房间号码 | 选填 | 各项去除首尾空白后保存；必填项须有内容。接待地址按上述顺序组合展示，选填项留空时省略该项。成员修改地址后，在页内预览中检查本次填写的接待地点。 ### 2.3 可预约日期 活动支持“指定日期”和“指定期间”两种设置方式。一次设置选择其中一种方式，并为这些日期设置第2.4节的可预约时间。 - 指定日期：逐个添加具体日期，可以设置多个日期。 - 指定期间：填写开始日期和结束日期，可以添加多个日期范围；同时选择星期一至星期日中的适用星期。日期范围包含首尾两天，实际可预约日期须同时属于日期范围及所选星期。 同一次设置中的日期使用相同的预约时间。需要为其他日期设置不同时间时，另加一组日期和时间设置。各组设置归属于当前活动，成员可修改或移除其中的日期、日期范围和时间项。 已添加的一组设置须有至少一个具体日期或完整日期范围，以及至少一个开始时间；成员可补齐该组或移除整组后保存。开始日期须早于或等于结束日期。指定期间时至少选择一个适用星期。日期显示为YYYY-MM-DD，按日本时间判断。 ### 2.4 可预约时间 成员为所设置的日期逐项添加可预约时间。每项包含开始时间及选填的结束时间；结束时间留空时，只表示可预约的到场时刻。每组日期可以配置多个时间项。 时间使用日本时间，格式为HH:mm，精确到分钟。开始时间及已填写的结束时间均在00:00至23:59内；填写结束时间时，须晚于同一天的开始时间。 访客选择成员已配置的时间项，所选日期和开始时间为希望来场时间。开始与结束之间的其他分钟不自动成为可预约时刻。访客可选条件使用本页基本字段的时间要求，提交时按第3.4节重新检查。 ### 2.5 基本字段 基本字段按下列顺序保留，名称、顺序及填写要求固定。姓名、手机号和电子邮箱的长度规则也固定。成员在活动配置中设置第2.3、2.4节的日期和时间、第2.6节的附加问题及第2.7节的附加文本答案长度。 | 字段 | 访客填写要求 | |---|---| | 姓名 | 必填，填写本次预约者姓名 | | 手机号 | 选填，填写时按联系电话格式检查 | | 电子邮箱 | 必填，按电子邮箱格式检查 | | 希望来场的日期和时间 | 必填，使用日本时间，从所属活动已配置的时间项中选择严格晚于当前时间的开始时刻 | ### 2.6 附加问题 附加问题来自当前项目中正在配置的活动。成员可增加、修改、删除问题，并调整其显示顺序。 | 配置项 | 内容与规则 | |---|---| | 问题名称 | 向访客提出的问题，去除首尾空白后须有内容 | | 回答类型 | 文本回答或选项回答；新增问题默认文本回答 | | 回答选项 | 选项回答使用单选；至少两个选项，各项去除首尾空白后须有内容，且互不重复 | | 是否必填 | 决定访客提交时是否必须回答；新增问题默认选填 | | 显示顺序 | 决定附加问题在访客表单中的先后顺序 | | 增加问题 | 将新问题加入本次编辑的表单 | | 删除问题 | 从本次编辑的表单中移除问题；历史保留见第3.6节 | 问题名称和选项文字采用本节的非空及选项不重复规则。答案长度设置用于访客的附加文本答案。 ### 2.7 附加文本答案长度 成员可为每道附加文本问题设置最少字符数和最多字符数。两项均选填，新增问题初始留空；留空表示该项未增加长度限制，问题的必填要求仍生效。 最少字符数为非负整数，最多字符数为正整数；同时设置时，最多字符数须大于或等于最少字符数。长度按首尾空白去除后的用户可见字符计算：汉字、英文字母、标点及一个完整表情各计一个字符。选填答案留空时按未填写处理，填写后检查长度。 ### 2.8 页内预览与保存 本页提供预览和保存操作。预览展示当前填写的活动名称、组合后的接待地址、可预约日期和时间、基本字段、附加问题、回答方式、必填要求、顺序及附加文本答案长度要求。 保存对象是当前活动的整份配置，内容见第3.4节。 ### 2.9 活动负责人 活动配置提供“负责人”选择项，选填。从当前项目成员中直接选择一位，随当前活动保存；每个活动最多设置一位负责人。 新建活动时负责人为空；编辑时显示该活动最近保存的负责人配置，可更换或清空。负责人留空时，仍可按第3.4节保存活动。 活动负责人用于负责该活动的接待，与顾客负责人分别保存。设置、更换或清空活动负责人后，顾客当前负责人保持原值；顾客预约列表中的“顾客当前负责人”及负责人筛选继续使用顾客负责人规则。 ## 三、操作规则 ### 3.1 新建和编辑活动 成员具备第3.8节的权限时，可从活动列表进入新建活动；编辑入口同时确定当前项目及要修改的活动。 新建时活动名称、地址及日期和时间设置为空，预约表单保留四个固定基本字段，附加问题从空列表开始。成员直接在活动中填写本次配置。 编辑时读取当前项目中选定活动最新保存的名称、地址、日期和时间、负责人、附加问题、显示顺序及文本答案长度。编辑期间，访客继续使用已保存配置。 读取失败时展示读取错误。已有活动须读取成功后才能编辑和保存，读取失败时保留原配置。 ### 3.2 修改活动配置 成员按第2章填写活动信息，添加或修改可预约日期和时间，选择、更换或清空活动负责人，并增加、修改、删除附加问题。选项回答使用第2.6节的选项规则，文本回答使用第2.7节的长度规则。 名称、地址、日期、时间、问题或长度校验未通过时，在对应位置说明需修改的内容，保留本次输入；修改后可再次保存。 ### 3.3 页内预览 成员预览当前编辑结果，检查顾客将看到的活动名称、地点、可预约时间、问题及填写要求。预览只使用本次配置，预览中的填写或提交用于查看效果，顾客预约记录保持原值。 预览后可继续编辑，或保存本次配置。没有未来可预约时间时，预览说明当前没有可预约时间，提交可用条件与第3.4节一致。 ### 3.4 保存与生效 保存时检查第2章的字段规则、第3.8节的有效权限，并按第3.5节检查是否存在他人更新。 活动允许尚未设置预约时段。名称、地址及其他已填写内容满足规则后，可保存活动；保存活动与当前是否存在可预约时间分别判断。无可选未来时间时，访客可以查看活动预约区域，但提交预约保持不可用。 保存成功时，一并保存活动名称、五项地址、日期和时间、负责人、附加问题、显示顺序及文本答案长度。新建时创建一份活动，编辑时更新原活动。保存成功后留在本页，显示该活动已保存的配置；返回活动列表时重新读取活动数据，新建活动进入列表，编辑活动显示最新保存结果。同一次保存的重复点击或重试保持一份保存结果。 指向该活动的入口读取最新配置。材料的入口开关、链接地址及其他配置保持原值；未保存的修改保留在本次编辑中。 访客已打开表单时，提交须重新检查活动最新的可预约时间及预约问题。原时间已过或已移除时，提示重新选择，保留其他填写内容；问题变化时按《展示页内预约表单说明》的更新规则处理。 保存失败时，已有活动保持原配置，新活动保持未创建成功。页面说明本次未保存成功，保留本次输入供重试；离开后的处理见第3.7节。 ### 3.5 处理配置冲突 编辑已有活动时，保存须检查该活动自本次读取后是否已被他人更新。存在更新时，保留他人已保存结果和当前成员未保存的输入，提示配置已变化并提供重新读取。 成员选择重新读取后，丢弃本次未保存配置，载入该活动最新保存的整份配置再编辑。重新读取前，本次配置保持未写入状态。 ### 3.6 保留已有顾客预约 活动名称或接待地址修改并保存后，已有顾客预约通过所属活动读取最新名称和地址。该规则适用于提交时间早于本次活动修改的预约，预约仍归属于原活动。 修改预约问题或可预约时间后，已提交的顾客预约继续保留提交时的问题、回答及希望来场时间。移除可预约时间用于调整后续可选项，已有顾客预约保持原保存结果。 全部分享材料关闭预约入口后，活动配置与已有顾客预约继续保留，有相应权限的成员仍可配置活动或查看顾客预约。入口再次开放时读取所属活动最新保存的配置。 ### 3.7 离开与切换项目 成员离开、关闭或刷新尚未保存的活动配置时，直接丢弃本次输入。新建活动尚未保存时，活动保持未创建状态。返回列表、返回项目列表及切换项目均按此处理。 再次编辑已有活动时重新读取最新保存配置。保存失败后留在当前页重试时，保留本次输入。 切换项目后重新读取目标项目的活动数据和有效权限。项目访问被停用时返回项目列表，按[总需求§4.12.8、§6.4](https://alidocs.dingtalk.com/i/nodes/N7dx2rn0Jb66LrvBTZkMPZN4JMGjLRb3)处理。 ### 3.8 配置权限 成员须同时具有当前项目“来场预约”菜单权限和“配置活动”操作权限，才可创建、打开编辑、预览及保存活动配置。“配置活动”统一覆盖活动名称、五项接待地址、可预约日期和时间、负责人、预约问题、显示顺序及附加文本答案长度。 销售推广人员和项目管理员默认拥有“配置活动”权限，实际操作按当前项目有效权限判断。打开配置和保存时均重新检查权限。缺少该操作权限时隐藏相应配置入口；无权操作请求提示“无权执行此操作”。 个人权限与角色默认权限的关系、无权页面、权限即时生效及无权请求提示使用[总需求§4.11.2、§6.2、§6.4](https://alidocs.dingtalk.com/i/nodes/N7dx2rn0Jb66LrvBTZkMPZN4JMGjLRb3)。当前页面权限被取消时停止展示无权内容，未保存配置保持未写入状态。 查看顾客预约和在链接内容中设置预约入口分别检查各自操作权限。 ### 3.9 记录配置变化 活动配置保存时记录操作人、时间及修改前后配置，内容覆盖名称、地址、可预约日期和时间、负责人及预约问题。新建活动记录本次保存内容；预览和未保存编辑保持原业务记录。 日志在独立操作日志模块按其权限查看。现有日志共用规则见[总需求§4.13](https://alidocs.dingtalk.com/i/nodes/N7dx2rn0Jb66LrvBTZkMPZN4JMGjLRb3)。 ### 3.10 语言与提示 界面按浏览器语言偏好顺序匹配日文或英文，均不匹配时使用英文。活动名称、地址、问题及回答选项保持输入语言。日期为YYYY-MM-DD，时间为HH:mm，按日本时间显示和判断。 字段校验错误在对应字段附近说明。读取和权限错误使用[总需求§5、§6.2](https://alidocs.dingtalk.com/i/nodes/N7dx2rn0Jb66LrvBTZkMPZN4JMGjLRb3)规定的状态。 ## 四、业务流程 ### 4.1 新建活动 成员需要接收某项来场预约时，先进入活动列表，从新建活动入口进入配置页，填写活动名称和接待地址，按需选择活动负责人，按需设置可预约日期、时间及附加问题。检查页内预览后保存，生成一份活动配置。 ```mermaid flowchart TB list["进入活动列表"] entry["进入新建活动配置"] info["填写活动名称和接待地址"] time["按需设置可预约日期和时间"] questions["设置活动的预约问题"] preview["预览本次配置"] save["保存并创建活动"] list --> entry entry --> info info --> time time --> questions questions --> preview preview --> save ``` 本流程以保存活动配置为完成结果。保存条件及当前没有可预约时间时的处理见第3.4节；材料使用哪个活动，由材料配置需求定义。 ### 4.2 修改已有活动 成员需要调整接待安排或预约问题时，先在活动列表找到要修改的活动，从该活动的编辑入口进入配置页，读取已有内容并修改。预览后保存，更新的是原活动。 ```mermaid flowchart TB entry["在活动列表找到要修改的活动"] edit["从编辑入口进入该活动配置"] update["修改活动信息、时间或问题"] preview["预览修改结果"] save["保存并更新原活动"] entry --> edit edit --> update update --> preview preview --> save ``` 修改对已有顾客预约的影响见第3.6节。校验未通过及保存失败时继续修改或重试，使用第3.2、3.4节的规则；配置冲突使用第3.5节，离开未保存配置使用第3.7节。