platforms/docs/superpowers/plans/2026-07-27-platform-admin-final-important-fixes.md

Platform Admin Final Important Fixes Implementation Plan

For agentic workers: REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (- [ ]) syntax for tracking.

Goal: 修复平台总后台终审的 8 项 Important 问题，并以回归测试、全量校验和提交记录证明修复结果。

Architecture: 后端统一在资源边界完成响应投影、关键字查询和精确位置授权，避免各页面或处理器自行绕过安全规则。前端以类型化字段定义驱动表单控件和请求载荷，并为审批与树归档提供明确交互；模型注释通过 AST 审计守住完整性。

Tech Stack: Go 1.26、Gin、GORM、Vue 3、TypeScript、Arco Design Vue、Node test runner、Biome 2.5、pnpm。

Global Constraints

• HTTP 仅公开 identity 和 <实体>_identity，禁止公开数据库自增 ID。
• 精确轨迹坐标必须由显式短期授权声明控制，普通列表和详情必须脱敏。
• 可选关系为空时不进入请求体；数字、布尔、时间和 JSON 字段保持正确类型。
• 归档为 status=archived，不得物理删除。
• 所有模型字段必须有中文注释。

---

Task 1: 后端安全边界与筛选

Files:

• Modify: backend/api/internal/logic/platform/task4_resources.go
• Modify: backend/api/internal/logic/platform/platform.go
• Modify: backend/api/internal/logic/platform/resource.go
• Modify: backend/api/internal/routers/platform.go
• Test: backend/api/internal/logic/platform/resource_test.go
• Test: backend/api/internal/routers/platform_test.go

Interfaces:

• Consumes: Gin 查询参数、JWT location_scope、资源关系定义。

• Produces: 创建响应公共投影、轨迹点脱敏处理器、通用 keyword 过滤。

• Step 1: 写创建响应、轨迹点授权和关键字筛选失败测试。

• Step 2: 运行定向 Go 测试并确认按预期失败。

• Step 3: 统一创建响应投影，轨迹点改为只读授权处理器，并把安全关键字条件同时用于 count/list。

• Step 4: 运行定向 Go 测试并确认通过。

Task 2: 前端类型化表单、审批和树归档

Files:

• Modify: frontend/platform_admin/src/api/resources.ts
• Create: frontend/platform_admin/src/api/resource-form.ts
• Modify: frontend/platform_admin/src/views/shared/CrudListPage.vue
• Modify: frontend/platform_admin/src/views/shared/ReadOnlyListPage.vue
• Modify: frontend/platform_admin/src/views/shared/TreePage.vue
• Test: frontend/platform_admin/scripts/final-important.test.mjs

Interfaces:

• Consumes: ResourceField{type, required} 与当前表单值。

• Produces: buildResourcePayload(fields, form)，以及审批 POST 和树归档交互。

• Step 1: 写字段类型、空可选关系、审批动作和树归档失败测试。

• Step 2: 运行 Node 测试并确认按预期失败。

• Step 3: 实现类型化控件/载荷、审批详情动作和树归档确认。

• Step 4: 运行 Node 测试并确认通过。

Task 3: Biome 与模型中文注释

Files:

• Modify: frontend/platform_admin/biome.json
• Modify: backend/api/internal/models/*.go
• Test: backend/api/internal/models/comments_test.go

Interfaces:

• Consumes: Biome 配置与 Go AST。

• Produces: 不依赖缺失本地 ignore 文件的 lint 配置，以及每个导出模型字段的中文注释。

• Step 1: 复现 Biome ignore-file 配置错误并写模型注释 AST 失败测试。

• Step 2: 修正 Biome VCS ignore 配置，为全部模型字段补中文注释。

• Step 3: 运行 go test ./...、Node 测试、pnpm audit:platform、pnpm lint、pnpm type:check 和 pnpm build。

• Step 4: 复核差异并提交。