# 财务结算周期时间展示修复操作日志

操作时间：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` 日期时间字段保持一致。
- 不新增文档未规定的自然月、固定周期或时区转换规则。