# 12.6 数据删除规范

:::tip 建议遵守
删除的默认形态是软删除；物理删除是受控例外。删除前做引用守卫，删除后可追溯。
:::

## 默认：软删除

```go
// repository 标准入口
repo.SoftDelete(ctx, "id", id)
repo.SoftDeleteByID(ctx, id)

// 批量：基座 BatchDelete（逐条软删）
spec.BatchDelete(ctx, ids)
```

软删后对查询不可见（Ctx 注入 del_flag=0），数据保留可审计、可恢复（运维按需 UPDATE 回 0）。

## 例外：物理删除

仅限**数据本身有保留期语义**的场景（超期日志、临时文件索引）：

```go
ctx = hooks.WithPhysicalDelete(ctx)   // 显式放行
```

放行要收敛在最小函数作用域，注释说明依据（如"超过 job.logRetentionDays"）。

## 删除守卫

删除被引用数据前做存在性检查，冲突时上抛守卫错误：

| 错误码 | 场景 |
|---|---|
| CodeHasChildren | 树形表存在下级（部门/菜单/分类） |
| CodeInUse | 关键记录仍被引用（用户在角色中等） |

守卫检查用 `ExistsByCond`（软删/租户已过滤）。

## 前端交互

- 危险删除（批量、不可逆）必须二次确认
- 删除失败展示后端 msg（守卫原因）
- 不做"假删除"（前端移除行但不调接口）

## 审计要求

删除操作经 RouteSpec Log/LogType=delete 留操作日志——谁删了什么可追溯。物理删除场景本身不落业务表，但任务日志留有执行记录。

## 相关

- [12.3 数据访问铁律](/zh/standards/data-access.html)
- [4.8 横切机制](/zh/architecture/cross-cutting.html)