henan-backend/docs/修改记录.md

修改记录

只记大改动：一个需求 / 一个模块算一条；同一件事的多轮微调合并成一条，不逐轮记。 排序：最新在最上面。 展开细节看 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 待定。