38 lines
4.5 KiB
Markdown
38 lines
4.5 KiB
Markdown
# 合同申请与个人中心复核
|
||
|
||
操作时间：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验收通过。
|