# iMeeting `imeeting_qy` 数据库升级报告

## 1. 升级目标

- 源旧库：`imeeting_qy`
- 对标最新结构库：`imeeting`
- 升级日期：`2026-04-03`
- 执行方式：先在临时测试库 `imeeting_qy_upgrade_test` 演练，再正式执行到 `imeeting_qy`

## 2. 备份信息

- 正式升级前已创建完整备份库：`imeeting_qy_backup_20260403_004354`
- 备份方式：同服务器整库复制全部 `BASE TABLE`

## 3. 本次执行内容

本次升级使用迁移脚本：

- `backend/sql/migrations/upgrade_imeeting_qy_to_latest.sql`

核心动作如下：

1. 将旧系统表标准化为 `sys_*` 体系：
   - `users -> sys_users`
   - `roles -> sys_roles`
   - `menus -> sys_menus`
   - `role_menu_permissions -> sys_role_menu_permissions`
   - `dict_data -> sys_dict_data`

2. 重建兼容视图：
   - `users`
   - `roles`
   - `menus`
   - `role_menu_permissions`
   - `dict_data`
   - `system_parameters`

3. 对齐旧系统表字段与索引：
   - `sys_users` 补齐 `idx_role_id`
   - `sys_roles` 补齐 `uk_role_name`
   - `sys_menus` 补齐 `menu_level/tree_path/is_visible` 及相关索引
   - `sys_role_menu_permissions` 补齐 `granted_by/granted_at` 及相关索引
   - `prompts` 补齐 `is_system` 字段及组合索引
   - `terminals.current_user_id` 字段注释对齐到最新结构

4. 新增并初始化最新配置表：
   - `sys_system_parameters`
   - `ai_model_configs`
   - `llm_model_config`
   - `audio_model_config`
   - `hot_word_group`
   - `hot_word_item`
   - `prompt_config`
   - `sys_user_mcp`

5. 迁移旧配置数据：
   - 从 `sys_dict_data(dict_type='system_config')` 迁移系统参数到 `sys_system_parameters`
   - 迁移 LLM / ASR / 声纹配置到 `ai_model_configs`
   - 拆分生成 `llm_model_config`、`audio_model_config`
   - 从旧 `hot_words` 迁移到 `hot_word_group` / `hot_word_item`

6. 重建最新菜单树与角色授权模型：
   - 新增 `dashboard`、`desktop`、`meeting_manage`、`system_management` 等最新菜单结构
   - 规范平台管理、系统管理、会议管理三套菜单层级
   - 管理员角色授予全部启用菜单
   - 普通用户保留 `desktop/meeting_manage/meeting_center/prompt_config`

## 4. 升级结果

升级后关键表数据如下：

| 表名 | 行数 |
|---|---:|
| `sys_users` | 44 |
| `sys_roles` | 2 |
| `sys_menus` | 19 |
| `sys_role_menu_permissions` | 22 |
| `sys_system_parameters` | 4 |
| `ai_model_configs` | 3 |
| `llm_model_config` | 1 |
| `audio_model_config` | 2 |
| `hot_word_group` | 1 |
| `hot_word_item` | 20 |
| `prompt_config` | 0 |
| `sys_user_mcp` | 0 |

迁移后的系统参数：

| 参数键 | 参数值 |
|---|---|
| `asr_vocabulary_id` | `vocab-imeeting-734e93f5bd8a4f3bb665dd526d584516` |
| `default_reset_password` | `123456` |
| `max_audio_size` | `500` |
| `timeline_pagesize` | `20` |

迁移后的模型配置：

- `llm_model_config`：1 条默认模型，`model_code=llm_model`
- `audio_model_config`：2 条配置
  - `audio_model` / `asr`
  - `voiceprint_model` / `voiceprint`

迁移后的热词配置：

- `hot_word_group`：1 个默认热词组
- `hot_word_item`：20 条热词条目

## 5. 角色菜单结果

- 平台管理员：
  - `dashboard, hot_word_management, user_management, meeting_center, desktop, meeting_manage, model_management, permission_management, prompt_config, prompt_management, platform_admin, dict_management, system_management, client_management, external_app_management, terminal_management, parameter_management, permission_menu_tree`

- 普通用户：
  - `meeting_center, desktop, meeting_manage, prompt_config`

## 6. 结构校验结论

对 `imeeting_qy` 与 `imeeting` 进行了 `information_schema.tables` + `information_schema.columns` 级别的最终校验，结果如下：

- 缺失表：`0`
- 多余表：`0`
- 表类型差异：`0`
- 字段差异：`0`

结论：

- `imeeting_qy` 已完成升级
- 当前库结构已与 `imeeting` 对齐
- 本次升级为“结构对齐 + 必要配置数据迁移”，未删除旧业务数据