epic-018-disability-website-bug-fixes.md 12 KB
Epic 018: 残疾人网站Bug修复与功能优化
概述
本史诗旨在修复残疾人网站测试中发现的新Bug，包括照片上传保存失败、订单编辑功能不完整、地区选择卡顿、省市区显示异常等问题，以提升系统稳定性和用户体验。
业务目标
- 修复照片上传保存失败的核心功能Bug
- 完善订单管理编辑功能，解决订单详情显示不完整问题
- 优化地区选择功能，解决卡顿和特殊行政区划处理问题
- 修复省市区树形结构显示异常和编辑页面参数错误问题
- 优化系统界面和交互体验
范围
- 残疾人管理模块的照片上传功能修复
- 订单管理模块的编辑功能和详情显示优化
- 地区管理模块的性能优化和特殊行政区划处理
- 系统界面显示异常修复
成功标准
- 照片上传后能够成功保存并在再次查看时正常显示
- 订单信息能够完整编辑和保存，详情页显示完整的公司/平台名称
- 地区选择无卡顿，支持无市级行政区划地区填写
- 省市区树形结构显示正常，编辑页面参数传递正确
- 所有Bug修复通过测试验证
- 系统稳定性和用户体验得到提升
用户故事
残疾人管理模块
故事 018-01: 修复照片上传保存功能
作为 残疾人信息管理员 我希望 上传的残疾人照片能够成功保存 以便 下次查看时照片仍然存在，无需重复上传
验收标准:
- 首次上传残疾人照片后提交，照片能够成功保存
- 再次编辑残疾人信息时，已上传的照片能够正常显示
- 重新上传照片后能够成功保存
- 照片上传失败时能够显示明确的错误提示
- 支持常见的图片格式（JPG、PNG等）
- 照片文件大小限制合理
技术说明:
- 页面路径：搜索菜单 > 残疾人管理 > 编辑残疾人信息
- 需要检查：
- 前端照片上传组件（PhotoUploadField）
- 照片数据提交到后端API的逻辑
- 后端照片保存到数据库/文件存储的逻辑
- 照片数据回显逻辑
- 可能的问题点：
- 照片数据未正确提交到后端
- 后端未正确保存照片信息
- 照片文件存储失败
- 前端回显逻辑错误
完成情况:
- ✅ 已完成 (2025-12-31) - 经实际测试验证功能正常
订单管理模块
故事 018-02: 完善订单编辑功能
作为 订单管理员 我希望 能够完整编辑订单信息 以便 修正订单中的错误或更新订单信息
验收标准:
- 订单编辑功能正常工作，能够修改订单信息
- 订单详情页显示完整的公司名称（而非"公司29"）
- 订单详情页显示完整的平台名称（而非"平台3"）
- 订单详情页显示完整的渠道名称（而非"渠道4"）
- 订单关联信息（公司、平台、渠道）以可读的名称显示
- 订单编辑后保存成功，数据正确更新
技术说明:
- 页面路径：搜索菜单 > 订单管理
- 需要检查：
- 订单编辑对话框的实现
- 订单详情页的数据获取和显示逻辑
- 订单、公司、平台、渠道的关联查询
- API返回的数据结构
- 可能的问题点：
- 前端未实现编辑功能或编辑功能被禁用
- 详情页显示的是ID而非关联表的实际名称
- 后端API未返回关联对象的完整信息
- 缺少必要的JOIN查询
依赖关系:
- 史诗010-04已修复订单状态更新，本故事需要在此基础上完善完整编辑功能
完成情况:
- ⏳ 待开始
地区管理模块
故事 018-03: 优化地区选择性能
作为 残疾人信息管理员 我希望 选择地区时系统响应流畅 以便 快速完成地区信息填写
验收标准:
- 选择"市"选项时系统响应快速，无卡顿现象
- 市列表能够正常加载和显示
- 地区选择组件在大数据量下仍能保持流畅
- 地区选择支持搜索或过滤功能
技术说明:
- 页面路径：搜索菜单 > 残疾人管理 > 添加/编辑残疾人 > 地区选择
- 需要检查：
- 地区选择组件的实现（省市区级联选择器）
- 后端地区数据查询API性能
- 前端地区数据加载和缓存策略
- 地区数据量（市的数量）
- 可能的问题点：
- 一次性加载所有市级数据导致性能问题
- 未实现懒加载或分页加载
- 后端查询缺少索引优化
- 前端组件渲染性能问题
完成情况:
- ⏳ 待开始
故事 018-04: 支持特殊行政区划地区
作为 残疾人信息管理员 我希望 能够填写无市级行政区划的地区信息 以便 完整记录自治州、自治县等特殊地区的残疾人信息
验收标准:
- "市"字段支持为空或可选
- 支持自治州、自治县等特殊行政区划的填写
- 系统能正确处理和保存无市级行政区划的地区信息
- 地区信息显示和查询正常工作
技术说明:
- 页面路径：搜索菜单 > 残疾人管理 > 添加/编辑残疾人 > 地区选择
- 需要修改：
- 前端表单验证规则（市字段改为可选）
- 后端验证规则
- 数据库字段约束（如果有的话）
- 特殊行政区划数据结构
- 考虑点：
- 是否需要新增"地区类型"字段（普通市/自治州/自治县等）
- 是否需要调整数据模型支持更灵活的层级结构
完成情况:
- ⏳ 待开始
故事 018-05: 优化省市信息查询逻辑
作为 系统用户 我希望 系统不强制要求查询省市级信息 以便 减少不必要的操作步骤
验收标准:
- 系统不强制要求查询残疾人所在的省和市（除非必要）
- 系统不强制要求查询入职公司所在的省和市（除非必要）
- 相关功能在缺少省市级信息时仍能正常工作
- 系统性能得到提升（减少了不必要的数据库查询）
技术说明:
- 需要检查：所有涉及省市级信息查询的页面和功能
- 需要评估：哪些功能确实需要省市级信息，哪些不需要
- 需要优化：
- 延迟加载或按需加载省市级信息
- 移除不必要的省市级信息查询
- 优化数据库查询性能
完成情况:
- ⏳ 待开始
系统界面与显示
故事 018-06: 修复省市区树形结构显示异常
作为 系统管理员 我希望 省市区树形结构显示正确规范 以便 准确选择地区信息
验收标准:
- 省级行政区显示正确的名称（如"山东省"而非"SDS"）
- 所有省级行政区标识规范统一
- 省市区树形结构层级正确
- 地区选择器显示的地区信息准确无误
技术说明:
- 需要检查：
- 地区数据源（数据库中的地区信息表）
- 地区数据初始化脚本或导入逻辑
- 省市区树形结构组件的数据显示逻辑
- 可能的问题点：
- 地区数据导入时使用了错误的字段或编码
- 数据库中地区名称字段存储了错误的值
- 前端显示逻辑错误
完成情况:
- ⏳ 待开始
故事 018-07: 修复编辑页面参数错误
作为 残疾人信息管理员 我希望 能够正常进入编辑页面 以便 修改残疾人信息
验收标准:
- 点击编辑按钮后能够正常进入编辑页面
- 编辑页面不再提示"参数错误"
- 编辑页面能够正确加载和显示现有数据
- 页面路由参数传递正确
技术说明:
- 页面路径：搜索菜单 > 残疾人管理 > 编辑残疾人
- 需要检查：
- 编辑页面的路由定义和参数处理
- 从列表页传递到编辑页面的参数
- 编辑页面的参数验证逻辑
- API调用的参数
- 可能的问题点：
- 路由参数配置错误
- 页面参数验证规则过于严格
- 缺少必要的参数传递
- API调用参数不完整
完成情况:
- ⏳ 待开始
公司管理模块
故事 018-08: 优化公司创建表单验证
作为 系统管理员 我希望 创建公司时只需要填写可获取的信息 以便 快速完成公司信息录入
验收标准:
- 公司名称为必填项
- 公司联系人、联系电话、联系邮箱为可选项
- 法人信息为必填项（通常可从公开信息获取）
- 只填写必填项后能够成功创建公司
- 表单验证提示清晰明确
依赖关系:
- 史诗010-01已修复公司创建的可选字段问题，本故事需验证并进一步优化
技术说明:
- 需要验证：史诗010-01的修复是否完全解决了此问题
- 如果已解决，标记为已完成
- 如果未完全解决，继续优化
完成情况:
- ✅ 史诗010-01已修复，需验证
技术考虑
照片上传问题
- 需要检查照片数据是存储在数据库还是文件存储（MinIO）
- 如果使用文件存储，需要检查文件上传API和保存逻辑
- 需要确保照片数据正确关联到残疾人记录
- 需要检查前端组件的值绑定和提交逻辑
订单编辑和显示问题
- 需要确保后端API返回关联对象的完整信息（JOIN查询）
- 前端需要正确处理和显示关联对象的名称字段
- 可能需要添加或优化编辑对话框的实现
- 需要考虑订单编辑的业务规则（哪些字段可编辑，哪些不可编辑）
地区选择性能问题
- 考虑实现懒加载或分页加载市级数据
- 后端API可能需要添加分页和搜索支持
- 考虑在前端缓存地区数据
- 数据库查询优化（添加索引）
特殊行政区划问题
- 需要评估数据模型是否需要调整
- 可能需要添加地区类型字段
- 需要考虑现有数据的兼容性
- 表单验证和显示逻辑需要相应调整
省市区显示异常
- 需要检查地区数据的质量
- 可能需要数据清洗和修复脚本
- 需要验证数据导入逻辑
编辑页面参数错误
- 需要检查路由配置和参数定义
- 需要检查页面初始化逻辑
- 可能需要调整参数验证规则
依赖关系
外部依赖
- 史诗010（系统Bug修复）- 部分功能已修复
- 故事010-01：公司创建功能修复（关联018-08）
- 故事010-04：订单状态更新修复（关联018-02）
内部依赖
- 故事018-01（照片上传）相对独立，可优先处理
- 故事018-02（订单编辑）依赖史诗010-04
- 故事018-03/018-04/018-05（地区相关）相互关联，建议按顺序处理
- 故事018-06/018-07（系统界面）相对独立，可并行处理
风险与缓解
风险: 照片上传问题可能涉及文件存储系统，排查复杂 缓解: 详细分析日志，检查MinIO配置和API调用链路
风险: 地区数据质量差，修复工作量大 缓解: 编写数据清洗脚本，批量修复数据
风险: 性能优化可能需要重构现有组件 缓解: 评估现有实现，采用渐进式优化策略
风险: 订单编辑可能影响现有业务逻辑 缓解: 充分测试，进行回归测试
验收测试计划
功能测试
- 测试照片上传和保存功能
- 测试订单编辑和详情显示功能
- 测试地区选择功能（包括特殊行政区划）
- 测试编辑页面进入和数据加载
性能测试
- 测试地区选择性能（大数据量场景）
- 测试省市级信息查询优化效果
兼容性测试
- 测试现有数据的兼容性
- 测试特殊行政区划数据的处理
用户体验测试
- 验证操作流程的流畅性
- 验证错误提示的清晰性
时间估算
- 故事018-01（照片上传）：1-2人天
- 故事018-02（订单编辑）：1-2人天
- 故事018-03（地区性能）：2-3人天
- 故事018-04（特殊行政区划）：1-2人天
- 故事018-05（省市查询优化）：1-2人天
- 故事018-06（省市区显示）：1人天
- 故事018-07（编辑页面参数）：1人天
- 故事018-08（公司表单验证）：0.5人天（验证工作）
总工作量: 约10-15人天 预计完成时间: 2-3周
优先级
高 - 这些Bug直接影响系统核心功能的正常使用和用户体验
史诗创建时间: 2025-12-31 状态: 进行中 🔄 (1/8 故事已完成)
更新记录:
- 2025-12-31: 史诗创建，基于残疾人网站问题反馈清单
- 2025-12-31: 故事018-01完成 - 照片上传保存功能修复，经实际测试验证功能正常