a61036e5dc
1. 新增角色管理后台页面、路由与国际化文案 2. 重构API请求错误处理逻辑，统一拦截业务与HTTP错误 3. 新增确认弹窗组合式函数，区分取消与请求错误场景 4. 完善表格按钮权限与显示控制逻辑 5. 更新API参数规范与文档说明 6. 修复部分页面分页数据解析问题
101 lines
6.2 KiB
Markdown
101 lines
6.2 KiB
Markdown
## 任务：迁移旧 CRUD 页面到新版 page-table + page-dialog-form 方案
|
||
|
||
### 输入
|
||
用户会提供一个旧 CRUD 页面的文件路径列表和对照表信息。
|
||
|
||
---
|
||
|
||
### 迁移规则（必须严格遵守）
|
||
|
||
#### 1. 组件方案
|
||
- 使用 `<page-table>` + `<page-dialog-form>` 替代旧版 `<sct-base-table>` + `<sct-base-dialog>` + `<SctBaseForm>`
|
||
- 使用 `useTableColumns()` 生成列定义（不再手动分配 idx）
|
||
- 使用 `useTableButtons()` 生成工具栏按钮和行内按钮（不再分开写 buttonList / tableButtonList）
|
||
- 使用 `i18nMixin(prefix)` 注入 `key()` 和 `ckey()` 方法
|
||
- 参考文档：[表格组件使用说明.md](file:///d:/code/mes/mes-ui/docs/表格组件使用说明.md)
|
||
- 参考示例：`src/views/production-master-data/factory-model/factory-area/index.vue`
|
||
|
||
#### 2. i18n 国际化（重要）
|
||
- 使用 `mixins: [i18nMixin('完整i18n前缀')]`，不要在每个页面手动定义 `T` 常量和 `tkey()` 方法
|
||
- `data()` 中用 `this.key('xxx')` 传完整 i18n key，**不要用 `k()` 提前翻译**（翻译由 page-table / page-dialog-form 内部处理，切换语言自动响应）
|
||
- 模板搜索区用 `$t(key('xxx'))`，公共 key 用 `$t(ckey('xxx'))`
|
||
- 语言包必须中英文同步添加（`zh-chs.json` + `en.json`）
|
||
- 参考文档：[国际化规则.md](file:///d:/code/mes/mes-ui/docs/国际化规则.md)
|
||
|
||
#### 3. 文件夹命名（重要）
|
||
- 文件夹名称遵循 [后台Webman界面截图对照表](file:///d:/code/mes/mes-ui/后台Webman界面截图对照表.md) 的 snake_case/kebab-case 命名
|
||
- 目录示例：`src/views/production-master-data/factory-model/factory-area/`
|
||
- 路由模块：`src/router/modules/production-master-data.js`
|
||
- API 文件：`src/api/production-master-data/factory-area.js`
|
||
|
||
#### 4. 路由 path 和 API BASE URL（重要 — 临时方案）
|
||
- **路由 path** 和 **API BASE URL** **暂时保留旧项目的命名**，因为后台数据库的路由表还未更新
|
||
- 示例：目录按对照表叫 `production-master-data`，但路由 path 保持旧值 `production_configuration`
|
||
```js
|
||
// src/router/modules/production-master-data.js
|
||
path: '/production_configuration', // 旧值暂留
|
||
```
|
||
```js
|
||
// src/api/production-master-data/factory-area.js
|
||
const BASE = 'production_configuration/factory_model/factory_area/' // 旧值暂留
|
||
```
|
||
- 后续统一修改路由后再批量替换
|
||
|
||
#### 4.1 API 参数名必须对齐旧项目（重要）
|
||
- **API 函数入参的 key 名称必须与旧项目保持一致**，不能自行发明参数名
|
||
- 例如：旧项目角色菜单接口参数是 `role_id`，不能写成 `id`
|
||
```js
|
||
// ❌ 错误 — 自行发明参数名
|
||
getRoleMenu({ id: this.roleId })
|
||
// ✅ 正确 — 与旧项目参数名一致
|
||
getRoleMenu({ role_id: this.roleId })
|
||
```
|
||
- **迁移 API 时必须仔细阅读旧项目接口代码**，逐个核对每个接口的入参 key 名称
|
||
- 如果后端报「xxx 不能为空」，首先检查参数 key 是否与旧项目一致
|
||
|
||
#### 5. 旧 key → 新 key 映射
|
||
如果用户提供的是旧页面代码，需要根据对照表做 key 映射。已知映射如下（持续补充）：
|
||
|
||
| 旧 key 前缀 | 新 key 前缀 |
|
||
|------------|------------|
|
||
| `page.production_configuration.factory_model.factory_area` | `page.production_master_data.factory_model.factory_area` |
|
||
| `page.system_settings.user_management.role` | `page.system_administration.user_management.role` |
|
||
| `page.system_settings.user_management.user` | `page.system_administration.user_management.user` |
|
||
| `page.system_settings.menu_configuration.menu` | `page.system_administration.menu_management.menu_configuration` |
|
||
| `page.system_settings.system_assistant.operate_log` | `page.system_administration.system_utilities.operation_logs` |
|
||
| `page.system_settings.system_assistant.api_log` | `page.system_administration.system_utilities.api_logs` |
|
||
| `page.system_settings.system_monitoring.system.login` | `page.system_administration.system_monitoring.login` |
|
||
| `page.production_configuration.matetial_model.*` | `page.production_master_data.material_model.*` |
|
||
| `page.planning_production.production_batch_management.batch` | `page.planning_production.batch_management.batch_list` |
|
||
| `page.data_middleground.basic_traceability.*` | `page.data_platform.traceability.*` |
|
||
|
||
#### 6. 处理流程（每迁移一个页面执行以下步骤）
|
||
1. **确定对照表位置**：从 [后台Webman界面截图对照表](file:///d:/code/mes/mes-ui/后台Webman界面截图对照表.md) 找到对应行的英文名，转换为 snake_case
|
||
2. **创建目录结构**：`src/views/{一级snake_case}/{二级snake_case}/{三级snake_case}/`
|
||
3. **创建 API 文件**：`src/api/{一级snake_case}/{二级snake_case}/{三级snake_case}.js`，BASE URL 暂用旧值
|
||
4. **添加路由模块**：`src/router/modules/{一级snake_case}.js`，path 暂用旧值
|
||
5. **编写页面代码**：使用 page-table + page-dialog-form 方案
|
||
6. **添加 i18n**：在 `zh-chs.json` 和 `en.json` 中添加对应 key
|
||
7. **验证 JSON 合法性**：`node -e "JSON.parse(require('fs').readFileSync('src/locales/zh-chs.json','utf8'))"`
|
||
|
||
---
|
||
|
||
### 页面模板（通用 CRUD 页面骨架）
|
||
|
||
参考 `src/views/production-master-data/factory-model/factory-area/index.vue` 的结构，核心模式：
|
||
|
||
- **Script**：`mixins: [i18nMixin('page.{一}.{二}.{三}')]` + `data()` 中用 `this.key('xxx')` 传 key
|
||
- **Template**：`<page-table>` 传 columns/data/loading/toolbarButtons/rowButtons/pagination + `<page-dialog-form>` 传 formCols/formData/rules/title
|
||
- **Buttons**：`useTableButtons({ toolbar: [...], row: [...] }, this.$permission)`
|
||
- **Columns**：`useTableColumns([...])`
|
||
- **Methods**：`fetchData / onSearch / onReset / onPageChange / openAdd / openEdit / onDialogSubmit / handleDelete`
|
||
- **i18n key 模板**（每个页面至少要有这些）：`search / reset / add / edit / delete / operation / add_title / edit_title / code / name / remark / enter_code / enter_name / remark_length / operation_success / confirm / cancel / tip / confirm_delete`
|
||
|
||
---
|
||
|
||
### 输出要求
|
||
- 创建完整的页面文件、路由模块、API 文件
|
||
- 在 `zh-chs.json` 和 `en.json` 中添加对应 i18n key（中文和英文同步）
|
||
- 完成后提醒用户验证 JSON 合法性
|
||
- 如涉及对照表中已有映射的 key 前缀变更，自动纠正为新的 key 前缀
|