# 修改记录

> **只记大改动**：一个需求 / 一个模块算一条；同一件事的多轮微调合并成一条，不逐轮记。
> **排序：最新在最上面。**
> 展开细节看 `docs/updata_sql.md`（数据库改动，含完整可执行 SQL 与回滚）与 `.workbuddy/memory/YYYY-MM-DD.md`（过程与踩坑）。
> **维护**：完成一个大改动后，在顶部按日期加一条；同一天追加在该日期块末尾。

---

## 2026-09-22

- **docker 配置命名统一：`changzhou` → `henan`（全套 `henan_` 前缀）**

  **起因**：`docker/` 下的编排文件里到处是 `changzhou`，是**从同源项目拷贝模板时的命名残留**。查实本机 `docker volume ls` / `docker ps -a`：**从未跑过 changzhou 这套**（只存在 hunan 项目的容器与卷 `hunan_mysql_db` / `hunan_redis_cache` / `hunan_rabbitmq_server`，3 个月前创建、均已 Exited）⇒ 改名**无数据迁移包袱**。统一为 `henan` 全套前缀，与实跑的 hunan 命名风格对齐。

  **改动 7 个文件**：

  1. `docker/compose/docker-compose.yml` —— `MYSQL_DATABASE` / `MYSQL_USER` → `henan`；三个 `container_name` → `henan_mysql_db` / `henan_redis_cache` / `henan_rabbitmq_server`；网络 → `henan_app_network`；external 卷 → `henan_mysql_data`
  2. `docker/compose/deploy.sh` —— 自动建卷的卷名
  3. `docker/compose/migrate-mysql-volume.sh` —— `NEW_VOL` 与旧卷候选列表；`docker stop henan_mysql_db`
  4. `docker/WINDOWS_QUICKSTART.md` —— 卷名 / 库名 / 容器名；顺带修正 3 处**本身就是错的**路径 `d:\changzhou_app\changzhou_backend\...` → `D:\henan_background\henan-backend\docker\compose`；第 4 节「和 chengdu 项目切换」→ hunan
  5. `ruoyi-admin/src/main/resources/application-dev.yml` —— jdbc url 库名 + `username`
  6. `ruoyi-admin/src/main/resources/application-pro.yml` —— 同上
  7. `bin/logtool.js` —— `-uhenan`、`-D henan`、容器名 `henan_mysql_db`

  **验证**：`docker compose -f docker-compose.yml config` 解析通过、零报错，`name` 段全部已生效（库 `henan`、三个 `henan_*` 容器名、网络 `henan_app_network`、external 卷 `henan_mysql_data`）。**零 SQL 变更、零后端代码改动。**

  **刻意没改**：① `chengduhipay` —— 第三方**支付通道名**不是地名，`application-dev/pro.yml` 与 `updata_sql.md` 里几十处，动了支付会挂；② `docs/updata_sql.md` 里历史条目的 `USE changzhou;` —— 台账回改会失真，需要留痕就**新加一条**；③ 各 `target/` `dist*/` `.lst` `stats.html` —— 里面是 `D:/changzhou_app/...` 的**编译期绝对路径**，属产物，重新构建自然消失；④ `docs/DEPLOYMENT.md`、`docs/README.md`、`docs/麻将胡了设计方案.md`（`D:\changzhou-cocos\...` 是客户端仓库路径）—— 旧项目文档。

  **上线前必做两件事**：① 卷是 `external: true`，**必须先 `docker volume create henan_mysql_data`**，否则报 `external volume not found` 直接起不来（`deploy.sh up -d` 会自动建，手敲 `docker-compose up` 不会）；② 新卷首次初始化会建出**空**的 `henan` 库 —— `MYSQL_DATABASE` / `MYSQL_USER` / `MYSQL_PASSWORD` **只在数据卷首次初始化时生效**，原有数据需另行导入，否则应用连上的是空库。

  **遗留待定**：网络没固定 `name:`，实际名会随执行目录变（在 `docker/compose` 下执行时是 `compose_henan_app_network`）。卷已用 `external` + 固定 `name` 规避「换目录丢数据」，网络是否同样钉死成 `henan_app_network` 待定。

- **下架三个玩法：删除「奥林匹斯 / 荒野争锋 / 极速糖果」的后台菜单与页面**

  **起因**：这三个玩法不再需要，要求从后台左侧菜单移除。

  **关键前提**：RuoYi 的左侧菜单是**数据库驱动**的（`sys_menu` → `/getRouters` → 前端 `sidebarRouters`），**代码里没有菜单清单**，所以必须"先删数据、再删页面文件"，只删前端文件的话菜单依然在。

  **改动清单**（完整 SQL 与回滚语句见 `docs/updata_sql.md`）：

  1. **数据库**（库 `henan`，已执行）：`sys_menu` 删 **22 行**（3 个顶级 M + 19 个子页面 C）；`sys_role_menu` 删 **22 行**授权（全属 `role_id=103`）。**无 `'F'` 按钮权限行**。
     - 3130 奥林匹斯 `olympus` → 子菜单 3131~3137
     - 2105 荒野争锋 `bullet` → 子菜单 2106~2110、2112
     - 2125 极速糖果 `sweet` → 子菜单 2126~2131
  2. **前端文件**（38 个，删前已确认全部被 git 跟踪）：`ruoyi-ui/src/views/game/{olympus,bullet,sweet}/`（7+6+6）与 `ruoyi-ui/src/api/game/{olympus,bullet,sweet}/`（7+6+6）。
  3. **文档**：本条 + `docs/updata_sql.md` 新条目（含 44 条回滚 INSERT）。

  **验证**：

  - 删除后 `sys_menu` / `sys_role_menu` 命中行数**均为 0**（`printf` 实测）；`SELECT ... WHERE parent_id = 0` 复查剩余 20 个一级菜单，三个玩法已消失。
  - 全量搜索 `game/olympus|game/bullet|game/sweet|api/game/...` 残留引用 **= 0**。
  - `ruoyi-ui` 生产构建 **`exitcode=0` / `DONE Build complete`**（删掉页面后仍能编译，说明没有别处静态引用它们）。

  **刻意没动**：

  1. **后端 Java 代码**。这些玩法名在后端出现在**跨模块共享**的文件里 —— `TtAccountRecordSource`（流水来源码 60=奥林匹斯）、`TtboxRecordSource`、`RedisConstants`、`MessageCategoryEnum`、`PromoTurnover*`、`ApiUserPackSackServiceImpl`、`WebsiteSetupServiceImpl`。删它们会波及**其他玩法与推广/发货链路**，不在「删页面」范围内。
  2. **数据库业务表**：`game_olympus_*` / `game_sweet_*` 等原样保留，未 TRUNCATE、未 DROP。数据还在，随时可回。
  3. **`ruoyi-ui/src/views/game/sugar/`**（5 api + 5 页面）—— **没有任何菜单引用**。菜单「极速糖果」指向的是 `game/sweet/*`，而 `docs/cleanup_records.sql` 又把 `game_sugar_*` 标注为「极速糖果」，两套并存；后端还存在 `GameSugarWin/User/StepInfo/Spin` 实体。**疑似遗留或未接入的开发分支，未确认前不删。**

  **遗留待定**：① 仪表盘「实时 RTP」卡片与「流水统计」折线里仍有 **玫瑰女郎(=olympus)** 一条 —— 那是后端 `/getRtpData` 返回的玩法列表，**与菜单无关**，删菜单不会让它消失；若要一并去掉得动后端。② `game/sugar/*` 是否清理待定。③ 是否需要把 `game_olympus_*` / `game_sweet_*` 业务表也清掉（现在只是入口没了，数据仍在库里占空间）。