功能名：影像资料
原始需求
为事故处理或任务执行提供“资料收集中心”，支持人员/车辆/事故三类资料的三栏式导航上传、车辆关联切换、暂存进度、置灰不可用状态、进度条与完成状态展示，并保证底部操作栏悬浮不遮挡内容。
现有功能分析
功能/模块 | 可复用功能/组件 | 需修改的现有功能 | 与本次需求的关联 | 新旧功能边界 |
|---|---|---|---|---|
文件上传基础能力 | sa-base FileService（本地/云存储）、SecurityFileService、内容审核ScanService | 需要支持批量图片上传预览/删除接口返回格式，校验规则可扩展 | 用于三级目录图片上传、预览、删除、暂存保存文件key | 复用上传存储与安全校验，新开发前端三栏导航与业务字段映射 |
车辆业务 | CarController/CarService 查询车辆、车辆属性、本方/三者标识 | 提供任务维度的“关联车辆”查询/写入接口或桥接现有车辆列表 | Action Sheet车辆列表、Tab标题显示车牌号、置灰逻辑依赖车辆关联状态 | 车辆基础数据复用；任务与车辆关联、Tab控制为新增 |
档案/附件存储 | CommunityArchiveService 上传文件到档案（文件信息入库） | 扩展支持任务资料分类（人员/车辆/事故）的目录/分组 | 可复用存储与文件元数据结构，承载上传记录 | 存储层复用；资料分组、进度计算为新增 |
内容安全与图片场景 | 投诉/工单/审批等模块已集成图片上传与内容审核流程 | 提炼通用“图片列表+状态”返回结构，复用审核拦截 | 上传时复用审核；删除二次确认可复用通用交互模式 | 审核与拦截复用；三栏导航状态、进度计算新增 |
权限与登录 | 统一的权限校验与登录态 | 为服务商角色授权“资料收集中心”入口 | 限制入口角色、记录操作人 | 权限体系复用；入口与菜单配置新增 |
5W2H 需求发散分析
维度 | 核心问题 | 分析结论 | 发散思考/潜在需求 |
|---|---|---|---|
What做什么 | - 核心功能是什么？- 包含哪些子功能？- 不包含什么（边界）？ | 构建资料收集中心：三栏导航上传、车辆关联切换、进度展示、暂存。子功能：Tab切换/置灰、二级导航进度、三级卡片上传/预览/删除、关联车辆Action Sheet、暂存校验与保存。 | 是否需要批量上传/拖拽；是否支持视频/文档；是否支持AI质检、自动分类；是否支持一键提醒缺失项。 |
Why为什么 | - 解决什么问题？- 业务价值是什么？- 不做会怎样？ | 提升服务商收集事故资料效率，降低漏传风险，支撑后续理赔/稽核。若不做，资料收集分散、进度不透明、误关联车辆导致审核退件。 | 上线后可统计缺项率、上传时长；后续可与质检/智能表单联动。 |
Who谁 | - 目标用户是谁？- 涉及哪些角色？- 各角色权限差异？ | 服务商操作员；审核人员只读查看；系统管理员配置目录和必传项。 | 是否支持客户/车主自助上传；是否有多角色协同编辑、并发锁。 |
When何时 | - 什么场景下使用？- 触发条件是什么？- 有时间限制吗？ | 任务处理过程中；从任务列表进入或关联车辆后自动跳转；暂存可多次，提交前不强制全量。 | 是否需要超时提醒；是否支持离线缓存/弱网续传。 |
Where何处 | - 在哪个模块/页面？- 入口在哪里？- 多端支持？ | 任务列表进入“资料收集中心”主页面，底部Action Sheet弹窗；主要为Web/H5。 | 是否需要小程序/APP端；是否支持任务详情页快捷入口。 |
How如何做 | - 操作流程是什么？- 关键交互是什么？- 异常如何处理？ | 入口→自动定位Tab（有车选车，无车置灰至人员）→左侧二级导航→右侧卡片上传/预览/删→底部关联车辆/暂存。异常：未关联车辆点击Tab提示；上传失败重试；删除二次确认；底部遮挡留padding。 | 弱网分片/断点续传；上传前压缩；进度计算和Toast提示落库。 |
How Much多少 | - 数据量级预估？- 性能要求？- 开发成本评估？ | 单任务约10-50张图片；需秒级上传反馈，进度计算O(n)；开发约2-3人天（前端2，后端1）。 | 需CDN加速与图片压缩；存储成本预估与清理策略；并发编辑冲突处理。 |
需求边界
类型 | 说明 |
|---|---|
✅ 包含 | 三栏式导航上传、车辆Tab置灰/激活、Action Sheet关联车辆、进度条/完成状态、图片预览/删除确认、暂存校验与保存、底部操作栏悬浮+内容padding |
❌ 不包含 | 视频/文档上传、AI质检、多人协同实时冲突处理、正式提交与审核流程 |
⚠️ 待确认 | 无车场景是否允许选择“行人”；暂存后是否回到列表；图片大小/数量上限；是否需要水印/脱敏 |
📋 后续迭代 | 缺项提醒、批量上传/拖拽、离线缓存、AI自动分类、跨端（小程序/APP）支持 |
页面设计
主页面：资料收集中心
布局：顶部Tab + 左侧二级导航 + 右侧三级卡片内容 + 底部通栏操作。
搜索条件字段
字段名称 | 字段类型 | 是否必填 | 默认值 | 说明 |
|---|---|---|---|---|
任务ID | 文本 | 是 | - | 进入页面的唯一标识 |
关联车辆ID | 下拉/只读 | 否 | 预设车辆或空 | 用于初始化车辆Tab状态 |
当前Tab | 下拉 | 否 | 根据是否有车自动设置 | 人员/车辆/事故 |
列表展示字段
字段名称 | 字段来源 | 显示格式 | 是否排序 | 说明 |
|---|---|---|---|---|
一级Tab名称 | 数据字典-资料类型 | 文本+进度条/完成标签 | 否 | 显示人员/车辆/事故及完成状态 |
二级目录名称 | 任务配置 | 文本+已传/总数 | 否 | 左侧导航，必传显示红* |
三级项名称 | 任务配置 | 卡片标题 | 否 | 证件/资料项 |
必填标识 | 任务配置 | 红* | 否 | 必传提示 |
上传状态 | 上传记录 | 待上传/选填/已上传X张（绿色） | 否 | 显示当前项完成度 |
预览缩略图 | 文件服务 | 图片列表 | 否 | 支持点击大图 |
操作按钮
操作名称 | 显示条件 | 使用条件 | 操作说明 |
|---|---|---|---|
拍照上传 | 三级卡片始终显示 | 授权摄像头 | 调用拍照并上传当前项 |
相册上传 | 三级卡片始终显示 | 选择图片 | 多选上传，更新状态 |
删除 | 已有图片时显示 | 二次确认 | 删除单张并更新进度 |
预览 | 已有图片时显示 | 点击缩略图 | 打开大图 |
关联车辆 | 底部固定栏左侧 | 无 | 唤起车辆Action Sheet |
暂存 | 底部固定栏右侧 | 无 | 校验格式后保存进度 |
弹窗：关联车辆 Action Sheet
弹窗字段
字段名称 | 字段类型 | 是否必填 | 默认值 | 校验规则 | 说明 |
|---|---|---|---|---|---|
当前关联车辆 | 只读文本 | 否 | 当前车牌/无关联 | - | 显示当前状态 |
车辆列表 | 列表选择 | 否 | 事故车辆集合 | 必须选一项或保持原值 | 显示车牌+属性（本方/三者） |
设为无车/行人 | 单选按钮 | 否 | - | 确认二次提示 | 切换为无关联 |
操作按钮
操作名称 | 显示条件 | 使用条件 | 操作说明 |
|---|---|---|---|
选择车辆 | 列表存在 | 点击单个车辆 | 保存关联并跳转车辆Tab |
设为无关联 | 始终显示 | 确认二次弹窗 | 置灰车辆Tab并回人员Tab |
关闭 | 始终显示 | 无 | 关闭Action Sheet |
弹窗：删除确认
弹窗字段
字段名称 | 字段类型 | 是否必填 | 默认值 | 校验规则 | 说明 |
|---|---|---|---|---|---|
提示文案 | 文本 | 是 | 确定删除该图片？ | - | 确认删除提示 |
操作按钮
操作名称 | 显示条件 | 使用条件 | 操作说明 |
|---|---|---|---|
确认 | 始终 | 无 | 删除图片并更新进度 |
取消 | 始终 | 无 | 关闭弹窗 |
用户旅程
从任务列表点击“资料收集中心”进入。
系统检测车辆关联：有车则选中车辆Tab并加载车牌；无车则车辆Tab置灰，默认人员Tab。
在左侧二级目录选择类别，右侧查看各三级项状态。
对必传/选填项点击拍照或相册上传，预览、删除确认。
若需切换车辆，点击底部“关联车辆”唤起Action Sheet选择或设为无车。
随时点击“暂存”进行格式校验并保存进度，Toast提示成功。
用户故事
作为服务商，我希望在无车辆时自动定位人员Tab，避免误点车辆导致无效操作。
作为服务商，我希望在切换关联车辆后自动跳转车辆Tab并刷新车牌，以便继续上传该车辆资料。
作为服务商，我希望暂存不强制填写所有必填项，以便分次补充。
作为审核人员，我希望看到必传项完成状态，便于判断是否可提交审核（后续）。
实现逻辑
复用现有：调用 FileService+SecurityFileService 完成上传与安全校验；复用车辆查询接口获取车辆列表及属性；复用内容审核 ScanService；复用权限/登录及通用弹窗/Toast组件。新开发：三栏导航前端组件、Tab置灰与跳转逻辑；任务与车辆关联状态管理（接口或任务字段）；上传记录与进度计算（已传/总数、必传完成状态）；暂存接口（保存上传记录与关联关系）；底部通栏悬浮样式与内容区域padding处理。
功能细节
输入：任务ID、可选车辆ID、上传图片文件（多张）、二级/三级目录配置、必传标识。
输出：上传记录fileKey、预览URL、已传张数、目录完成状态、车辆关联状态。
边界：未关联车辆禁用车辆Tab并提示；图片超限/违规时拦截；删除后进度回退；底部栏遮挡通过padding-bottom保障最后一项可见。
性能：单次上传≤5张，单张≤5MB（待确认），秒级响应；进度计算在前端聚合，后端返回目录配置与已传记录。