已完成用户APP首期功能开发

交付用户端首期页面、配套接口、后台资源及测试文档。用户APP构建、静态分析和三个管理后台构建通过;完整测试仍有2项失败,后端模型注释检查未通过,详见交付记录。
This commit is contained in:
czl231
2026-09-13 00:57:32 +08:00
parent a0a4bb1218
commit 3ef33b531d
793 changed files with 40959 additions and 1204 deletions

View File

@@ -0,0 +1,37 @@
# 合同申请与个人中心复核
操作时间:2026-09-08。操作类型:扩展、修复。影响模块:用户合同、气站工单、平台工单、个人资料。
## 实际差异
已打开图25、图32原稿,与390宽运行页面及截图逐项核对。个人中心仍缺认证、押金、优惠券、设置、消息、紧急联系人、家庭共享等完整能力,分组密度和图标素材未达到1:1。设计中的示例头像不能替代登录用户的真实头像;无头像账户使用姓名占位。图32仍缺共享授权协议签署、地址快照、续签提醒及原稿合同服务布局。
头像可从个人中心资料区域进入“更换头像”,真实浏览器已核对拍照、相册和取消入口。既有上传成功证据保留在此前日志,本次没有重复改写远程用户头像。新增修复:服务端清空头像后下拉刷新,编辑页清除旧图片缓存。个人中心消息、联系人、家庭和收藏图标按原稿语义调整。
## 合同申请行为
原来只有合同正文、PDF和状态历史。现在每份本人合同可填写变更内容,提交至所属气站工单队列,读取状态、取消申请、查看答复并确认处理完成。申请不会直接变更合同条款或产生电子签名。
同账户锁、稳定请求号和同合同进行中申请检查防止重复待办。转出用户不能继续向原气站新申请条款变更。气站只能答复本站关联合同申请,待受理/处理中可答复,答复后待用户确认;相同答复可幂等重试。平台和气站普通工单编辑不得改换关联申请的用户或业务分类。普通维修工单原接口保持兼容,App报修列表不混入合同申请。
## 文件与接口
- `backend/api/internal/models/cs_ticket.go`:可选内部合同关联字段,0表示普通工单。
- `backend/api/cmd/cli/address_migration.go`、`main.go`:`migrate-ticket-contract`只增加远程`cs_ticket.gasorder_contract_id`、索引及中文注释,已执行;未运行全库迁移或本机数据库。
- `backend/api/internal/logic/client/user/gas_contract_request.go`:CreateGasContractRequest、ListGasContractRequests;GET/POST `/heqi/client/v1/user/gas/contracts/:identity/requests`。
- `backend/api/internal/logic/gas/contract_request.go`、`ticket.go`:气站答复、原气站权限范围、处理按钮状态投影;POST `cs_ticket/:identity/resolve-contract-request`。
- `backend/api/internal/logic/platform/contract_ticket_guard.go`、`routers/platform.go`:保留普通CRUD行为,保护关联申请归属。
- `frontend/gas_admin/src/api/resources.ts`、资源契约:合同变更分类及“答复合同申请”详情操作。
- `apps/user_app/lib/ui/features/orders/contract_change_requests.dart`:申请表单、状态、答复、确认/取消及错误重试;`gas_contracts_page.dart`增加入口。
- `apps/user_app/lib/domain/models/gas_order_detail.dart`、`data/repositories/client_repository.dart`:类型适配、会话校验及请求方法。
- `apps/user_app/lib/ui/features/profile/profile_edit_page.dart`:头像刷新清理;`profile_page.dart`:图标调整。
## 验证与风险
Go全量测试、vet、API构建通过。Flutter全量105项测试及analyze通过,包含头像清空刷新、申请失败重试保持请求号、取消二次确认。图25/32共16组宽度及文字缩放截图检查通过,已查看390图片并更新并排对照,截图生成不等于视觉验收。
气站管理端contract同步/检查及构建通过,平台48资源契约检查通过。远程数据库回滚测试验证提交、气站两次幂等答复、用户确认,原合同未变化,测试申请整体回滚无残留。正常测试运行默认跳过该远程用例,显式HEQI_REMOTE_CONTRACT_REQUEST_TEST=1才启用。
新Web及Android调试包构建通过,API已切换至本次构建并继续连接远程数据库/缓存。浏览器390×844实际完成登录→合同→申请提交→待受理→取消二次确认→已取消,测试单`TK1788877123489796400`保留已取消审计记录,无待办残留。气站答复本次为真实远程回滚事务验证,未声称气站浏览器人工处理已经验收。浏览器预览地址为 http://127.0.0.1:18571/。
新增列旧记录默认0,普通工单继续按既有服务关系授权;关联申请保留原气站归属。数据库结构与新API需一同发布。Android/iOS真实相机、相册和文件保存对话框仍待真机验证。全量状态仍为15张部分实现、43张未完成对应页面、0张严格全功能与1:1验收通过。