mes-ui-d2/docs/migration-prompt.md

任务：迁移旧 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
• 参考示例：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）
• 参考文档：i18n-rules.md

3. 文件夹命名（重要）

• 文件夹名称遵循 后台Webman界面截图对照表 的 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

  // src/router/modules/production-master-data.js
  path: '/production_configuration',  // 旧值暂留
  

  // src/api/production-master-data/factory-area.js
  const BASE = 'production_configuration/factory_model/factory_area/'  // 旧值暂留
  

• 后续统一修改路由后再批量替换

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界面截图对照表 找到对应行的英文名，转换为 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 前缀