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

交付用户端首期页面、配套接口、后台资源及测试文档。用户APP构建、静态分析和三个管理后台构建通过；完整测试仍有2项失败，后端模型注释检查未通过，详见交付记录。

docs/操作日志_用户端APP_合同变更记录_20260908.md

@@ -0,0 +1,28 @@
+# 合同变更记录开发日志
+
+操作时间：2026-09-08。操作类型：扩展。影响模块：本人供气合同。
+
+## 行为变化
+
+原合同页面无法查看历史状态与有效期变更。现在每份合同提供“变更记录”，独立读取不可变快照，支持失败重试、下拉刷新与空态。现有正文、PDF下载、搜索、筛选和旧路由保留。
+
+## 关键文件
+
+- backend/api/internal/logic/client/user/gas_contract_history.go：GetGasContractHistory先按公开identity、JWT用户及未归档状态限定合同，再按合同ID读取变更记录，发生时间与identity倒序。响应白名单仅包含identity、action、contract_status、occurred_at、effective_at、expired_at，不发送内部主键、员工身份或内部原因。
+- backend/api/internal/routers/client.go、client_test.go：增加受保护GET `/heqi/client/v1/user/gas/contracts/:identity/history`及路由回归。
+- apps/user_app/lib/domain/models/gas_order_detail.dart：GasContractEvent强类型适配，区分activate/renew/terminate等真实动作，未知动作仍显示通用变更而非成功签署。
+- apps/user_app/lib/data/repositories/client_repository.dart：gasContractHistory读取本人记录并丢弃跨会话迟到响应。
+- apps/user_app/lib/ui/features/orders/gas_contract_history.dart：历史弹层、状态及有效期快照、错误重试、空态和关闭；gas_contracts_page.dart增加入口。
+- 后端gas_contract_history_test.go覆盖归属SQL、顺序和内部字段不外泄；前端gas_contract_history_test.dart覆盖重试、真实变更含义及关闭。
+
+## 验证
+
+Go全量测试、vet与API构建通过。Flutter analyze、全量103项测试通过。图32在320/360/390/430宽度与1.0/1.3字体的8组截图检查通过，已查看390截图，更新并排证据。平台资源契约同步和48项检查通过。
+
+真实API读取MOCK-CONTRACT-001，返回activate记录：发生时间2026-06-30 09:00，状态11，有效期至2027-07-01 09:00；匿名HTTP401。无数据库迁移或远程业务写入。
+
+浏览器已完成登录回跳、列表“变更记录”入口、真实合同生效记录及关闭；桌面和390手机宽度均实际查看，控制台无错误/警告。Web Release和Android Debug构建通过。新API进程43912，Web端口18571。
+
+## 边界
+
+变更记录不等于电子签署证据，也不代表已实现合同变更申请、续签提醒或签署工作流。历史内部原因未区分公开/私有口径，因此不下发；不能把内部操作员姓名当作用户签名。图32仍为部分实现，严格视觉与完整合同服务仍待补。