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

28 lines
1.1 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 安全与审计模型前缀重命名设计
## 目标
`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*` 标识符。