docs: 部署说明新增 Navicat .nb3 备份/还原路线（含格式解析与步骤），并标注 8/27 旧备份已过期

zhizhijie

2026-09-13 a29387d17c69d3eb8eb6ee879e8e0bfa72662c0a

docs: 部署说明新增 Navicat .nb3 备份/还原路线（含格式解析与步骤），并标注 8/27 旧备份已过期

 docs/¹¤×÷ÈÕ½á/¹¤×÷ÈÕ½á_2026-09-13.md

@@ -63,6 +63,13 @@
- å¼ºéªŒè¯ï¼ˆ8.0 å®¢æˆ·ç«¯ï¼‰ï¼šå¤‡ä»½æ”¹åº“名导入临时库 `traffic_audit_vfy` â†’ è¡¨æ•°é‡ 29=29、表名一致、**逐表 `SHOW CREATE TABLE` ç»“构差异 0**、**逐表 `COUNT(*)` è¡Œæ•°å·®å¼‚ 0**、抽查 `wyc_order_monthly` 2026-08 `order_sum` ä¸€è‡´ â†’ éªŒè¯åŽåˆ é™¤ä¸´æ—¶åº“。
- éƒ¨ç½²è¯´æ˜Žå·²åŒæ­¥æ›´æ­£ï¼ˆçŽ¯å¢ƒè¦æ±‚表、路线 B å‘½ä»¤ä¸Žç‰ˆæœ¬è¯´æ˜Žã€`DROP TABLE` è¦†ç›–警告）。


### 11. æŸ¥è¯ Navicat .nb3 å¤‡ä»½æ ¼å¼ï¼ˆå›žç­”「不是可以打包成一个文件直接还原吗」）
- ç”¨æˆ·è®°å¿†ä¸­çš„「一个文件直接还原备份」= Navicat ç§æœ‰æ ¼å¼ **`.nb3`**；本机已有 8/27 é‚£ä»½ï¼š`D:\文档\Navicat\MySQL\Servers\mysql80\traffic_audit\20260827152017.nb3`（**已过期**：27 å¼ è¡¨ã€ç¼ºç½‘约车两张、数据停在 8/27）。
- è§£æžå‡ºæ ¼å¼ï¼š`tar` å®¹å™¨ = æ¯å¼ è¡¨ `<uuid>.meta.json.gz`（DDL/字段）+ `<uuid>.data.000NN.sql.gz`（gz æ•°æ®åˆ†ç‰‡ï¼‰+ æœ«å°¾æœªåŽ‹ç¼© `meta.json`（DatabaseType/Schema/Objects[UUID,Type,Name,Rows,Metadata{Filename,Checksum}]）；`Checksum` ç»å®žæµ‹å°±æ˜¯è¯¥ meta æ–‡ä»¶çš„ **SHA1（大写）**。
- ç»“论与建议：`.nb3` åªèƒ½ç”± Navicat è‡ªèº«ç”Ÿæˆã€ä¹Ÿåªèƒ½ç”¨ã€Œè¿˜åŽŸå¤‡ä»½ã€è¿˜åŽŸï¼Œ**用 .sql ç‚¹ã€Œè¿˜åŽŸå¤‡ä»½ã€å¿…然失败**；我无法在命令行侧可靠合成并验证 Navicat æ˜¯å¦æŽ¥å—，所以不提供手工拼的 .nb3，改为在文档里写清「本机 Navicat ç‚¹ä¸€æ¬¡å¤‡ä»½ â†’ æ‹·åˆ°ç›®æ ‡æœºåŒè·¯å¾„ â†’ è¿˜åŽŸå¤‡ä»½ã€çš„傻瓜步骤。
- `docs/打包部署说明.md` 5.1 èŠ‚新增「路线 B2：Navicat å¤‡ä»½/还原（.nb3）」，并注明三种方式任选其一、不可叠加。

## äºŒã€æµ‹è¯•ç»“果摘要（详见《功能测试报告》）

| é¡¹ | ç»“æžœ |

 docs/´ò°ü²¿Êð˵Ã÷.md

@@ -111,6 +111,26 @@
- æœ¬æ¬¡å·²ç”Ÿæˆå¹¶**验证过**备份：`traffic_audit_full_20260913.sql`（45.5 MB，8.0.29 å®¢æˆ·ç«¯å¯¼å‡ºï¼‰ã€‚
  éªŒè¯æ–¹å¼ï¼šæŠŠå¤‡ä»½åº“名改成临时库导入，逐表比对 `SHOW CREATE TABLE`（表结构）与 `COUNT(*)`（行数）——**29 å¼ è¡¨ç»“构与行数均 0 å·®å¼‚**，抽查 `wyc_order_monthly` 2026-08 æ•°æ®ä¸€è‡´ï¼ŒéªŒè¯åŽå·²åˆ é™¤ä¸´æ—¶åº“。

#### è·¯çº¿ B2：用 Navicat çš„「备份 / è¿˜åŽŸå¤‡ä»½ã€ï¼ˆ.nb3，最贴近日常习惯）

`.nb3` æ˜¯ Navicat ç§æœ‰å¤‡ä»½æ ¼å¼ï¼ˆtar å®¹å™¨ï¼šæ¯å¼ è¡¨ä¸€ä»½ meta.json + gz åŽ‹ç¼©çš„数据分片 + SHA1 æ ¡éªŒ + æ€» meta.json），
只能由 Navicat è‡ªå·±ç”Ÿæˆã€ä¹Ÿåªèƒ½åœ¨ Navicat é‡Œç”¨ã€Œè¿˜åŽŸå¤‡ä»½ã€è¿˜åŽŸâ€”—**用 `.sql` ç‚¹ã€Œè¿˜åŽŸå¤‡ä»½ã€ä¸€å®šå¤±è´¥**（那个入口只认 .nb3）。

在源机器（30 ç§’）：

1. Navicat â†’ è¿žæŽ¥ `mysql80` â†’ é€‰ä¸­ `traffic_audit` â†’ å³é”® â†’「备份…」→ èµ·ä¸ªåå­— â†’ ç¡®å®šï¼Œç­‰å®ƒè·‘完；
2. ç”Ÿæˆçš„备份文件在 Navicat çš„ profile ç›®å½•ï¼š`D:\文档\Navicat\MySQL\Servers\mysql80\traffic_audit\<时间戳>.nb3`
   ï¼ˆæœ¬æœº 8/27 é‚£ä»½å°±åœ¨è¿™é‡Œï¼Œä½†å®ƒ**已过期**：只有 27 å¼ è¡¨ã€ç¼ºç½‘约车两张表、数据是 8/27 çš„，不要用）。

在目标机器：

3. å…ˆåœ¨ Navicat é‡Œå»ºä¸€ä¸ªè¿žåˆ°æœ¬æœº MySQL 8.0 çš„连接（**连接名建议与源机器一致，比如 `mysql80`**），并新建空库 `traffic_audit`（字符集 utf8mb4）；
4. æŠŠ `.nb3` æ”¾åˆ°ç›®æ ‡æœºå™¨çš„对应目录 `<Navicat profile>\MySQL\Servers\<连接名>\traffic_audit\`（没有就照着建目录）；
5. å³é”®è¯¥åº“ â†’「还原备份」→ åœ¨é€‰æ‹©åˆ—表里勾选这份备份 â†’ å¼€å§‹ï¼ˆåˆ—表里看不到就重启一次 Navicat）。

> ä¸‰ç§æ–¹å¼ï¼ˆè·¯çº¿ A ç©ºåº“ 4 è„šæœ¬ / è·¯çº¿ B å‘½ä»¤è¡Œè¿˜åŽŸ .sql / è·¯çº¿ B2 Navicat .nb3）**任选其一**即可，
> ä½†**不要叠加**：还原完备份后再跑 `init.sql` ä¼šæŠŠæ•°æ®æ¸…空重建。

> æ³¨æ„ï¼š`docs/` ç›®å½•ï¼ˆæŠ¥è¡¨æ¨¡æ¿ã€æ±‡æ€»å¤§è¡¨æ¯ç‰ˆï¼‰**与数据库无关，无论哪条路线都必须一并拷贝**。

### 5.2 æ”¹é…ç½® `backend/application.yml`