platforms/docs/操作日志_财务结算周期时间展示修复_20260817.md

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

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