imetting/docs/imeeting_qy_upgrade_report_...

4.0 KiB
Raw Blame History

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_configaudio_model_config
    • 从旧 hot_words 迁移到 hot_word_group / hot_word_item
  6. 重建最新菜单树与角色授权模型:

    • 新增 dashboarddesktopmeeting_managesystem_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_config1 条默认模型,model_code=llm_model
  • audio_model_config2 条配置
    • audio_model / asr
    • voiceprint_model / voiceprint

迁移后的热词配置:

  • hot_word_group1 个默认热词组
  • hot_word_item20 条热词条目

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_qyimeeting 进行了 information_schema.tables + information_schema.columns 级别的最终校验,结果如下:

  • 缺失表:0
  • 多余表:0
  • 表类型差异:0
  • 字段差异:0

结论:

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