4.1 KiB
标准资源全页改造操作日志
记录一：范围确认与现状检查
操作时间：2026-08-10
操作类型：扩展
影响模块：平台总后台标准资源管理
操作前状态：工作人员和用户账户已有独立资料页，其余标准资源的新建、详情和编辑主要使用 CrudListPage.vue 内的抽屉；机构账户管理使用二级模态框。
具体操作：盘点 48 个资源契约、三类管理端路由、后端 Create/Update DTO、聚合详情、钱包摘要、气站状态、详情动作和树形资源差异；按用户确认将范围限定为 5173。
操作后状态：确定 46 类标准列表资源详情、25 类新建和 23 类编辑的全页迁移边界；树形资源和短操作保留原交互。
风险评估：创建字段与更新字段不一致是主要风险，采用显式资源字段规则和保存后详情复读缓解。
记录二：路由与共享页面改造
操作时间：2026-08-10
操作类型：新增、修改
影响模块：frontend/platform_admin
具体操作：
- 新增标准资源路由生成器，统一创建
/new、/:identity、/:identity/edit隐藏子路由。 - 新增共享资源页面、详情内容、双列表单、账户摘要、钱包摘要、业务动作、关系加载、头像和未保存保护组件。
- 将
CrudListPage.vue收敛为列表与短操作入口，移除标准 CRUD 抽屉和账户二级模态框。 - 将机构账户管理改为带归属过滤条件的隐藏列表及独立 CRUD 页面。
- 删除已被共享页面替代的
AccountProfilePage和未使用的ReadOnlyListPage。 - 拆分仪表盘、财务和资源路由构建文件，控制主要代码文件规模。
操作后状态：所有标准资源的详情、新建和编辑均从列表导航到独立 URL；详情动作、审核、启停、归档等短操作保持原有模态交互。
风险评估：路由数量增加但由构建器统一生成，并通过资源覆盖脚本检查，降低漏配和路径漂移风险。
记录三：字段规则与安全兼容
操作时间：2026-08-10
操作类型：扩展
影响模块：资源表单、导航、平台账户头像
具体操作：
- 为可编辑资源逐项声明更新字段、创建隐藏字段、编辑必填和不可变归属。
- 增加合同、检修、系统角色和平台角色权限的动态编辑限制。
- 增加智能气阀归属变更专属动作，要求填写动作、原因和备注。
- 增加安全
return_to、404/403 中文错误页、密码长度校验和未保存离开确认。 - 增加平台账户受控头像读取路由；平台账户更新未提交头像时保持原头像。
操作后状态：编辑请求只提交服务端允许更新的字段，详情继续使用受保护接口和脱敏响应。
风险评估：附件 URI 仍受保护且没有受控下载接口，因此本次明确不提供附件预览，避免绕过资源权限。
记录四：验证
操作时间：2026-08-10
操作类型：验证
影响模块：前端、后端、浏览器交互
验证结果：
npm.cmd run resource-pages:check：通过，详情 46 类、新建 25 类、编辑 23 类，列表无标准 CRUD 抽屉。npm.cmd run contract:check：通过，48 个前后端资源契约一致。npm.cmd run type:check：通过，Vue 与 TypeScript 类型检查无错误。- Biome 新增文件错误级检查：通过，无错误级诊断。
npm.cmd run build：通过，Vue 类型检查和 Vite 生产构建成功。go test ./...：通过，后端全部包测试成功。- 浏览器：通过用户详情/编辑/新建、钱包详情跳转、机构账户管理、气站状态区、404 中文提示、未保存“继续编辑/确认放弃”和
/staff/add独立页检查。 - 数据安全：浏览器回归未执行创建、保存、启停、归档或流程动作，没有修改测试业务数据。
边界案例：聚合详情子表在本地缺少完整订单/合同样本，已完成代码结构检查和生产构建，后续使用固定测试数据补充端到端验证。
风险评估：本次只改平台总后台；5175、5176 的标准资源仍沿用原交互，不受影响。