修改计费订单ID类型为Long,优化相关逻辑

This commit is contained in:
wuweihua
2026-11-14 00:23:47 +08:00
parent 87eab12d51
commit 8b7c346ec4
71 changed files with 929 additions and 346 deletions
@@ -0,0 +1,64 @@
# UUID -> bigint 夜间执行与冒烟清单
脚本:`bms-back/sql/20261113_uuid_to_bigint_order_bill.sql`
## 必须顺序(不要飞)
1. **先停 Java / BMS 服务**(含计费、出账、导出等异步 worker)
2. 全库或关键表备份
3. 在服务器执行 SQL(下面一键脚本)
4. SQL 成功后,再部署 **Long 版** 后端并启动
5. 冒烟
>旧包连新库或新包连旧库都会挂。**一定先停 Java,再跑 SQL。**
## 服务器一键执行
把同目录下 `20261113_uuid_to_bigint_order_bill.sql` 与 `20261113_uuid_to_bigint_run.sh` 一起上传到服务器。
```bash
# 1) 先停 Java(按你们部署方式改,以下为示例)
# systemctl stop bms-admin
# 或:kill / docker stop / 停掉所有 java -jar bms-*.jar
# 2) 再跑迁移
export BMS_DB_HOST=127.0.0.1
export BMS_DB_PORT=3306
export BMS_DB_NAME=bms
export BMS_DB_USER=root
export BMS_DB_PASS='******'
chmod +x 20261113_uuid_to_bigint_run.sh
./20261113_uuid_to_bigint_run.sh
# 或非交互:CONFIRM=YES ./20261113_uuid_to_bigint_run.sh
```
日志写在 `sql/logs/uuid_to_bigint_*.log`。
## 执行前
1. **已停 Java / BMS**(含计费/出账/导出异步)
2. 全库备份(或至少:prc_order_bill*、prc_income*、prc_pay_bill*、ar_bill_detail*、prc_billing_task、pay_bill_line)
3. 建议在从库/备份库先干跑校验
4. 准备好 Long 版后端包(SQL 成功后再发)
## 执行
1. 确认 Java 已停
2. 跑 `./20261113_uuid_to_bigint_run.sh`(内部会执行整份 SQL)
3. 查日志校验/抽查通过
4. 部署新后端,启应用
## 冒烟
- [ ] 订单列表能打开,billId 为数字
- [ ] 新建/重计费一票,生成新 bigint bill_id
- [ ] 手动加一笔应收费用 / 查费用明细
- [ ] 生成一笔应收账单,明细能关联订单
- [ ] 旧应收账单明细 JOIN prc_order_bill 正常
- [ ] 应付费用/应付账单查看正常
## 回滚
1. 停新包
2. **推荐**:整库从备份恢复
3. 或:`SET FOREIGN_KEY_CHECKS=0` 后将 `*_bak_uuid` RENAME 回主表名(引用列需额外处理)
4. 部署旧后端包
## 次日
- 确认无误后 DROP `*_old_uuid` / `*_bak_uuid` / `mig_map_*`