From 4b02efdf77826ad290406f71cb4c79485dfc3055 Mon Sep 17 00:00:00 2001
From: yanweidong <david.yan@qq.com>
Date: Mon, 27 Jul 2026 13:52:41 +0800
Subject: [PATCH] docs: define safe and audit model prefix rename

---
 ...26-07-27-safe-audit-model-prefix-design.md | 27 +++++++++++++++++++
 1 file changed, 27 insertions(+)
 create mode 100644 docs/superpowers/specs/2026-07-27-safe-audit-model-prefix-design.md

diff --git a/docs/superpowers/specs/2026-07-27-safe-audit-model-prefix-design.md b/docs/superpowers/specs/2026-07-27-safe-audit-model-prefix-design.md
new file mode 100644
index 0000000..73cfb60
--- /dev/null
+++ b/docs/superpowers/specs/2026-07-27-safe-audit-model-prefix-design.md
@@ -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*` 标识符。