shop-toy/openspec/specs/bank-visit-plan/spec.md

bank-visit-plan Specification

Purpose

TBD - created by archiving change add-bank-visit-plan. Update Purpose after archive.

Requirements

Requirement: 创建拜访计划

银行端用户 SHALL 能够创建客户拜访计划，记录拜访的基本信息。

Scenario: 成功创建拜访计划

• WHEN 用户填写完整的拜访计划信息（日期、客户、拜访主题）
• THEN 系统 SHALL 保存拜访计划并返回成功提示

Scenario: 创建拜访计划时验证必填字段

• WHEN 用户提交拜访计划时缺少必填字段（日期、客户、拜访主题）
• THEN 系统 SHALL 显示相应的错误提示，阻止提交

Scenario: 选择营销产品

• WHEN 用户点击营销产品选择器
• THEN 系统 SHALL 显示可选产品列表，支持多选

Requirement: 拜访计划列表

银行端用户 SHALL 能够查看拜访计划列表，支持筛选和搜索。

Scenario: 查看拜访计划列表

• WHEN 用户进入拜访计划列表页面
• THEN 系统 SHALL 显示所有拜访计划，按日期倒序排列

Scenario: 按状态筛选拜访计划

• WHEN 用户选择状态筛选条件（待拜访、已完成、已取消）
• THEN 系统 SHALL 显示对应状态的拜访计划

Scenario: 搜索拜访计划

• WHEN 用户输入关键词搜索
• THEN 系统 SHALL 显示匹配的拜访计划（按客户名称或拜访主题）

Requirement: 拜访计划详情

银行端用户 SHALL 能够查看拜访计划的详细信息。

Scenario: 查看拜访计划详情

• WHEN 用户点击拜访计划列表项
• THEN 系统 SHALL 显示拜访计划的完整信息（日期、客户、营销产品、拜访主题、备注）

Scenario: 标记拜访完成

• WHEN 用户点击"标记完成"按钮
• THEN 系统 SHALL 弹出填写位置和上传照片的表单
• AND 用户填写位置信息（支持自动定位或手动输入，默认地址为"广东省茂名市"）
• AND 用户上传至少一张拜访场景图
• AND 系统 SHALL 验证位置和照片必填
• AND 验证通过后更新拜访状态为"已完成"

Scenario: 标记完成时验证必填字段

• WHEN 用户提交完成标记时缺少位置信息或照片
• THEN 系统 SHALL 显示相应的错误提示，阻止状态更新

Scenario: 编辑拜访计划

• WHEN 用户点击编辑按钮
• THEN 系统 SHALL 进入编辑模式，允许修改拜访计划信息（日期、主题、备注）

Requirement: 客户选择器

系统 SHALL 提供客户选择器，支持从客户列表中选择目标客户。

Scenario: 打开客户选择器

• WHEN 用户点击客户选择字段
• THEN 系统 SHALL 弹出客户列表页面

Scenario: 选择客户

• WHEN 用户从列表中选择一个客户
• THEN 系统 SHALL 返回并显示选中的客户信息

Requirement: 位置定位

系统 SHALL 支持获取当前位置或手动输入地址。

Scenario: 自动定位

• WHEN 用户点击定位按钮
• THEN 系统 SHALL 获取当前位置并显示地址信息

Scenario: 手动输入地址

• WHEN 用户手动输入地址
• THEN 系统 SHALL 保存用户输入的地址信息

Scenario: 使用默认地址

• WHEN 用户未填写位置信息
• THEN 系统 SHALL 使用默认地址"广东省茂名市"

Requirement: 上传拜访场景图

系统 SHALL 支持上传拜访场景照片。

Scenario: 上传拜访场景图

• WHEN 用户点击上传按钮
• THEN 系统 SHALL 提供拍照和从相册选择两种方式

Scenario: 验证照片数量

• WHEN 用户标记拜访完成时
• THEN 系统 SHALL 要求至少上传一张拜访场景图