银行端口添加客户拜访功能

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

@@ -0,0 +1,95 @@
+# 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 要求至少上传一张拜访场景图
+