# entity 模块 i18n 说明

## 提取范围
本模块全部新增文案（页面标题、按钮、提示、错误码、字段名、过滤标签、消息）均已提取到 `wwwroot/i18n/`：

| 文件 | 语言 | 用途 |
|------|------|------|
| `wwwroot/i18n/zh-CN.json` | 简体中文 | 默认语言 |
| `wwwroot/i18n/en-US.json` | 英文 | 英文界面 |

## key 规范
- 统一前缀 `entity.`（模块名），避免跨模块冲突。
- 分组：`entity.field.*`（字段标题）、`entity.filter.*`（搜索标签）、`entity.code.*`（错误码 message，与后端 `{code, message, field, detail}` 结构对应）、`entity.msg.*`（操作消息）、`entity.import.*`（导入页文案）、`entity.list.*`（列表页文案）。
- 前端通过 bricks 的 `i18n('entity.xxx')` 调用（`i18n` 为 ahserver 注入全局）。

## 与后端错误码的对应
后端错误结构统一为 `{code, message, field, detail}`，其中 `code` 取值如 `ENTITY_VALIDATE_FAIL`、`IMPORT_VALIDATE_FAIL` 等。前端展示文案使用 `entity.code.<CODE>` 作为 key 查找 i18n；`message` 字段为后端兜底文案（中文）。

## 新增文案流程
1. 在 `wwwroot/i18n/zh-CN.json` 与 `en-US.json` 同时新增同 key。
2. 同步更新 `docs/i18n.md` 本说明（如 key 分组有变化）。
3. 部署时 i18n 文件随 wwwroot 一起链接到宿主应用 wwwroot。