platforms/docs/superpowers/specs/2026-07-27-safe-audit-model-prefix-design.md

安全与审计模型前缀重命名设计

目标

将 backend/api/internal/models 中的安全模型前缀从 saf_ 统一为 safe_，审计模型前缀从 aud_ 统一为 audit_，并让后端、前端和资源契约使用相同名称。

范围

• 模型文件和 Go 类型：Saf* 改为 Safe*，Aud* 改为 Audit*。
• 资源名、后端 API 路径、前端资源定义、菜单路由和页面目录同步使用 safe_*、audit_*。
• 自动建表和初始化代码使用新模型及新表名。
• 测试、审计报告和资源契约同步更新。

非目标

• 不迁移旧数据库表或历史数据。
• 不保留 saf_*、aud_* 的 API、资源或路由兼容别名。

实施策略

使用直接切换：先增加会在旧命名存在时失败的契约测试，再逐层重命名模型、后端资源与前端声明。每个资源在重命名后必须拥有模型、路由、页面和资源声明的一致映射。

验证

• Go 模型、逻辑和路由测试；go build ./cmd/main。
• 前端资源审计、类型检查和生产构建。
• 搜索验证生产代码不再含 saf_、aud_ 或 Saf*、Aud* 标识符。