sub2api/issues/plugin-refactor/phase-1_plugin-kernel/TASK-004_admin_modules_api.md

完成报告: [TASK-004] Admin 模块可观测 API

• 完成状态: Success
• 关联任务规格: 链接
• 完成日期: 2026-06-11

1. 任务完成简报

GET /api/v1/admin/modules 只读可观测接口落地：数据源 Runtime.Snapshot()，项目统一 envelope（response.Success），字段 snake_case 按 id 字典序，error 文本经 logredact.RedactText 脱敏。完全复刻现有 admin handler 模式（私有小接口仿 SystemHandler、独立 register 函数、admin group 自动套 AdminAuthMiddleware + AdminComplianceGuard）。

2. 文件变更详情

创建的文件

• backend/internal/handler/admin/module_handler.go — ModuleHandler + List
• backend/internal/handler/admin/module_handler_test.go — 5 个单测（序列化含 disabled 模块、排序、错误脱敏、空快照 [] 非 null、真实 Runtime 端到端）

修改的文件

• internal/handler/handler.go — AdminHandlers 增加 Module 字段
• internal/handler/wire.go — provider 注册与参数
• internal/server/routes/admin.go — registerModuleRoutes
• cmd/server/wire_gen.go — wire v0.7.0 工具重新生成（未手改）

3. 验证记录（主控复跑确认）

• go build ./... ✅；go test ./internal/handler/admin/ ✅；make test-invariants 42 包全绿 ✅；
• 全量 go test -tags=unit ./internal/... 零失败；go vet ./... ✅；
• 基准对比零回归：bench-baseline.sh compare 7 个基准全 ok（allocs/op 完全一致，ns/op -2.9%~+0.5% 均在噪声内）；
• golangci-lint 本地 80 分钟未跑完（WSL /mnt 盘 + staticcheck 全程序分析），已按 .golangci.yml 启用清单人工核查新文件（depguard/errcheck/gofmt/govet 等），最终判定交 CI lint job。

4. 遗留事项

• 无功能遗留；前端展示属后续可选项（本阶段 API-only，符合规格）。