docs: define safe and audit model prefix rename

This commit is contained in:
2026-07-27 13:52:41 +08:00
parent b512c7d189
commit 4b02efdf77

View File

@@ -0,0 +1,27 @@
# 安全与审计模型前缀重命名设计
## 目标
`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*` 标识符。