# 标准资源全页改造操作日志

## 记录一：范围确认与现状检查

操作时间：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 的标准资源仍沿用原交互，不受影响。