feat: 标准资源使用独立页面并优化详情布局

docs/操作日志_标准资源全页改造_20260810.md

@@ -0,0 +1,67 @@
+# 标准资源全页改造操作日志
+
+## 记录一：范围确认与现状检查
+
+操作时间：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 的标准资源仍沿用原交互，不受影响。