c74aa7dab6
- 包根 cn.iocoder.yudao → com.wanxiang.huijing;业务 cn.wanxiang.game → com.wanxiang.huijing.game(统一单一命名空间) - groupId cn.iocoder.cloud → com.wanxiang;artifactId + 模块目录 yudao-* → huijing-*(含 huijing-server/framework/gateway/dependencies) - 类名 Yudao* → Huijing*(44 个);配置前缀 yudao.* → huijing.*(Tier A 标识符 + Tier B 配置) - 排除不动:Flyway 迁移脚本(不可变历史,保 checksum)、上游归属 URL/LICENSE、DB 表名(真表 system_*/game_*,无 yudao_ 业务表) - 范围:game-cloud + game-admin。范围外 contracts/docs/.agents 的 yudao 引用=文档漂移,后续单独清(Opus H4 判不阻断) 评审:Opus 对抗复审(逮 Flyway checksum Blocker→已修排除迁移);Codex 未同步交回。 本地验证:apply 幂等✓;范围内真代码残留 0(16 处 \bYudao 均在已排除迁移注释内)。 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
0. 友情提示
在 sql/tools 目录下，我们提供一些数据库相关的工具，包括测试数据库的快速启动、MySQL 转换其它数据库等等。
注意！所有的操作，必须在 sql/tools 目录下执行。
1. 测试数据库的快速启动
基于 Docker Compose，快速启动 MySQL、Oracle、PostgreSQL、SQL Server 等数据库。
注意！使用 Docker Compose 启动完测试数据后，因为会自动导入项目的 SQL 脚本，所以可能需要等待 1-2 分钟。
1.1 MySQL
docker compose up -d mysql
1.2 Oracle
## x86 版本
docker compose up -d oracle
## MacBook Apple Silicon
docker compose up -d oracle_m1
注意：如果使用 MacBook Apple Silicon 版本，它的 ORACLE_SID 不是 XE，而是 FREE！！！
1.3 PostgreSQL
docker compose up -d postgres
1.4 SQL Server
docker compose up -d sqlserver
# 注意：启动完 sqlserver 后，需要手动再执行如下命令，因为 SQL Server 不支持初始化脚本
docker compose exec sqlserver bash /tmp/create_schema.sh
1.5 DM 达梦
① 下载达梦 Docker 镜像：https://eco.dameng.com/download/ 地址，点击“Docker 镜像”选项，进行下载。
② 加载镜像文件，在镜像 tar 文件所在目录运行：
docker load -i dm8_20240715_x86_rh6_rq_single.tar
③ 在项目 sql/tools 目录下运行：
docker compose up -d dm8
# 注意：启动完 dm 后，需要手动再执行如下命令，因为 dm 不支持初始化脚本
docker compose exec dm8 bash -c '/opt/dmdbms/bin/disql SYSDBA/SYSDBA001 \`/tmp/schema.sql'
exit
1.6 KingbaseES 人大金仓
① 下载人大金仓 Docker 镜像：
- x86_64 版本 【Windows 选择这个】
- aarch64 版本 【MacBook Apple Silicon 选择这个】
② 加载镜像文件，在镜像 tar 文件所在目录运行：
docker load -i kdb_x86_64_V009R001C001B0025.tar
③ 在项目 sql/tools 目录下运行：
docker compose up -d kingbase
# 注意：启动完 kingbase 后，需要手动再执行如下命令
docker compose exec kingbase bash -c 'ksql -U $DB_USER -d test -f /tmp/schema.sql'
1.7 华为 OpenGauss
docker compose up -d opengauss
# 注意：启动完 opengauss 后，需要手动再执行如下命令
docker compose exec opengauss bash -c '/usr/local/opengauss/bin/gsql -U $GS_USERNAME -W $GS_PASSWORD -d postgres -f /tmp/schema.sql'
1.X 容器的销毁重建
开发测试过程中，有时候需要创建全新干净的数据库。由于测试数据 Docker 容器采用数据卷 Volume 挂载数据库实例的数据目录，因此销毁数据需要停止容器后，删除数据卷，然后再重新创建容器。
以 postgres 为例，操作如下：
docker compose down postgres
docker volume rm ruoyi-vue-pro_postgres
2. MySQL 转换其它数据库
项目提供了 sql/tools/convertor.py 脚本，支持将 MySQL 转换为 Oracle、PostgreSQL、SQL Server、达梦、人大金仓、OpenGauss 等数据库的脚本。
2.1 实现原理
通过读取 MySQL 的 sql/mysql/ruoyi-vue-pro.sql 数据库文件，转换成对应的数据库脚本。
2.2 使用方法
① 安装依赖库 simple-ddl-parser
pip install simple-ddl-parser
# pip3 install simple-ddl-parser
② 在 sql/tools/ 目录下，执行如下命令打印生成 postgres 的脚本内容，其他可选参数有：oracle、sqlserver、dm8、kingbase、opengauss：
python3 convertor.py postgres
# python3 convertor.py postgres > tmp.sql
程序将 SQL 脚本打印到终端，可以重定向到临时文件 tmp.sql。
确认无误后，可以利用 IDEA 进行格式化。当然，也可以直接导入到数据库中。