53 lines
2.8 KiB
Markdown
53 lines
2.8 KiB
Markdown
# 财务结算周期时间展示修复操作日志
|
||
|
||
操作时间：2026-08-17
|
||
|
||
操作类型：修改
|
||
|
||
影响模块：平台总后台、财务管理、财务结算
|
||
|
||
## 操作前状态
|
||
|
||
- 结算开始时间和结束时间虽已声明为日期时间字段，但通用展示逻辑只格式化名称以 `_at` 结尾的字段。
|
||
- `period_start`、`period_end` 因字段名不匹配而直接显示 RFC3339 原文，并在列表中出现 `T` 和省略号。
|
||
|
||
## 具体操作
|
||
|
||
1. 通用字段展示增加基于 `field.type === 'datetime'` 的日期时间格式化。
|
||
2. 结算周期统一显示为 `YYYY-MM-DD HH:mm:ss`，不修改后端时间值和时区处理规则。
|
||
3. 增加静态展示契约，防止非 `_at` 日期时间字段再次回显原始字符串。
|
||
4. 结算主体类型改为气站、配送点、工作人员三类中文枚举，并联动相应主体下拉。
|
||
5. 切换主体类型时清空原主体，防止跨类型标识误提交。
|
||
6. 财务对账渠道复用支付渠道中文口径，账单日期按纯日期格式展示。
|
||
|
||
## 行为变化
|
||
|
||
- 修改前：`2026-06-01T09:00:00...`。
|
||
- 修改后：`2026-06-01 09:00:00`。
|
||
- 仅改变展示格式，不改变结算周期、接口字段、保存值或结算流程。
|
||
- 新建和编辑结算单不再要求手工输入主体类型编码。
|
||
- 财务对账的 `wallet` 改为“余额支付”，`2026-07-01T00:00:00Z` 改为 `2026-07-01`。
|
||
|
||
## 代码变更
|
||
|
||
- `frontend/platform_admin/src/api/resource-display.ts`：日期时间改为按字段类型统一格式化。
|
||
- `frontend/platform_admin/src/api/resources.ts`：补齐结算主体类型枚举和三类动态关系。
|
||
- `frontend/platform_admin/src/api/resources.ts`：补齐财务对账渠道中文枚举。
|
||
- `frontend/platform_admin/scripts/check-resource-display-contracts.mjs`：增加日期时间类型格式化契约。
|
||
- `docs/项目文档_平台资源中文展示统一_v1.0.md`：记录 v1.14 变更。
|
||
|
||
## 验证结果
|
||
|
||
- `pnpm resource-display-contracts:check`：通过。
|
||
- `pnpm contract:check`：通过，48 个资源契约一致。
|
||
- 修改文件定向 Biome lint：无错误；保留 `resource-display.ts` 既有的 `hasOwnProperty` 建议性警告。
|
||
- `pnpm type:check`：通过。
|
||
- `pnpm build`：通过，TypeScript 类型检查及 Vite 生产构建完成，共转换 2621 个模块。
|
||
- 补齐结算主体联动后再次执行资源契约、48 资源契约、定向 lint、类型检查和生产构建：全部通过，仍仅有既有建议性警告。
|
||
- 补齐财务对账渠道和纯日期展示后再次执行上述完整前端验证：全部通过，仍仅有既有建议性警告。
|
||
|
||
## 风险评估
|
||
|
||
- 影响所有已声明为 `datetime` 的字段，输出格式与现有 `_at` 日期时间字段保持一致。
|
||
- 不新增文档未规定的自然月、固定周期或时区转换规则。
|