Files
platforms/docs/操作日志_合同终止恢复与修订字段优化_20260813.md

45 lines
2.3 KiB
Markdown
Raw Normal View History

# 操作日志:合同终止恢复与修订字段优化
操作时间2026-08-13
操作类型:修改
影响模块:合同生命周期、合同详情修订记录、平台/气站/配送点管理端
## 操作前状态
合同详情的只读修订记录展示公共软删除字段“删除时间”。平台前端和后端允许已终止合同直接启用,各管理端的启用按钮状态配置也不一致。
## 具体操作
- 聚合详情表过滤 `deleted_at``DeletedAt`,保留数据库公共软删除能力但不向只读修订记录展示。
- 后端启用动作仅接受草稿状态,已终止合同必须通过续签恢复。
- 平台、气站和配送点管理端统一仅在草稿状态显示“启用合同”。
- 增加终止合同不可直接启用的状态规则测试,并同步合同需求文档。
## 操作后状态
修订记录不再出现无业务意义的删除时间。已终止合同不能直接启用;恢复履约需要通过续签提交新的生效时间、到期时间和原因。
## 代码变更
- `backend/api/internal/logic/platform/gasorder/gasorder.go`:收紧合同启用状态。
- `backend/api/internal/logic/platform/gasorder/gasorder_test.go`:增加状态规则测试。
- `frontend/platform_admin/src/views/resource/ResourceDetailContent.vue`:隐藏聚合记录软删除字段。
- 三个管理端的 `src/api/resources.ts`:统一合同启用按钮状态。
- `frontend/platform_admin/scripts/check-resource-pages.mjs`:增加静态回归断言。
## 验证结果
- `go test ./internal/logic/platform/gasorder ./internal/logic/gas ./internal/logic/delivery`:通过。
- 平台总后台 `npm run resource-pages:check``npm run type:check``npm run build`:通过。
- 气站管理端 `npm run type:check``npm run build`:通过。
- 配送点管理端 `npm run type:check``npm run build`:通过。
## 风险评估
调用方若尝试对已终止合同执行启用将收到状态错误;应改用续签接口。数据库字段和公开接口路径保持不变。
## 入口一致性补充
- 修复平台、气站和配送点管理端部分资源定义遗漏 `13已终止`,导致详情页没有续签入口的问题。
- 三端续签按钮现统一在 `11生效中``12已过期``13已终止` 状态显示。