docs(server): 台账记下 7a5303f（V156）与后台 dist 重建，附高德 key 缺失的判据

yeg

2026-09-29 e200466f5d882b418643ee9e11cbb0579c9988d1

docs(server): 台账记下 7a5303f（V156）与后台 dist 重建，附高德 key 缺失的判据

 .scratch/server-testenv/README.md

@@ -8,8 +8,8 @@

| 路径 | 内容 |
|---|---|
| `/data/talent-card/app.jar` | 后端 fat jar（103 MiB）。**2026-09-29 更新到提交 `61ba794`**：V155 已应用（迁移 149 条、库版本 155、`merchant_onboarding_application.business_address` 列已建）。上一版留在 `app.jar.bak-20260929-1326`，回滚直接换回即可（V155 只加一列可空列，旧代码忽略它，安全） |
| `/data/talent-card/admin/` | 后台管理端 dist（nginx 托管） |
| `/data/talent-card/app.jar` | 后端 fat jar（103 MiB）。**2026-09-29 16:51 更新到提交 `7a5303f`**：V156 已应用（库版本 156，`merchant_onboarding_application.store_cashier_url` 列已建），启动 14.7 s、`/actuator/health` UP。上一版（提交 `61ba794`、库版本 155）留在 `app.jar.bak-20260929-1650`，更早一版在 `app.jar.bak-20260929-1326`；回滚直接换回即可（V156 同样只加一列可空列，旧代码忽略它，安全）。上传来源文件的 sha256：`79d63e44…e4554` |
| `/data/talent-card/admin/` | 后台管理端 dist（nginx 托管）。**2026-09-29 16:54 由 `redeploy-admin.sh` 从 Gitblit `main`(`7a5303f`) 重建并替换**：进件详情的「门店照片」区多了「店铺收银台」一列。注意本次构建日志里有「没有 `/etc/talent-card/admin-build.env`，本次不带高德 key 构建」——见下文「已知缺口」 |
| `/data/talent-card/uploads/` | 上传落盘目录（对应 `UPLOAD_DIR`） |
| `/data/talent-card/src/` | 从 Gitblit 克隆的源码，服务器上构建 admin 用 |
| `/data/talent-card/redeploy-admin.sh` | admin 重部署脚本（见下） |
@@ -115,6 +115,12 @@
- 数据库：`talent_card`，字符集 `utf8mb4` / `utf8mb4_0900_ai_ci`（与测试库同口径，
  照 `ResetTestDatabase.java` 只写 charset 不写 collate；**不要**照抄 `init-local-mysql.sql` 的 `utf8mb4_unicode_ci`，那是 5.7 开发库用的）。
- MySQL 8.4 上迁移里的 7 条 `VALUES() is deprecated`（1287）仍可运行，但该语法未来版本会被移除。
- **后台的「商户创建」页地图没有高德 key**：`/etc/talent-card/admin-build.env` **不存在**，`redeploy-admin.sh`
  每次都会打印「本次不带高德 key 构建（地图相关页面会报未配置）」。**这不是某次重建弄丢的**：本次替换后的
  `admin/assets/MerchantCreateView-<hash>.js` 与改动前的构建产物**内容哈希完全相同**（`D144nYCr`，没被本次改动碰到），
  两者都没有内联 key，说明构建期变量一直就没配。要用地图：把 `VITE_AMAP_KEY` / `VITE_AMAP_SECURITY_CODE`
  写进 `/etc/talent-card/admin-build.env`（`600`，模板见 `talent-card-admin/.env.example`）再跑一次
  `redeploy-admin.sh`。别把 key 放进仓库（`.gitignore` 只忽略 `*.local`，**没有忽略 `.env`**）。

## ⚠️ 用空库部署后，第一件事：处置引导账号 `admin`