重构

docs/默认数据说明.md

@@ -1,9 +1,9 @@
 # 默认数据说明
 
-执行 `pnpm db:migrate` 后数据库仅有**表结构**；执行 **`pnpm db:seed`** 后会写入下文演示数据。  
+执行 `pnpm db:migrate` 后数据库仅有**表结构**；执行 **`pnpm db:seed`** 后会写入下文默认数据。
 种子脚本位置：`apps/api/prisma/seed.ts`。
 
-> **注意**：以下为开发演示用途。生产环境务必修改密码、`JWT_SECRET`，勿直接使用默认账号。
+> **注意**：生产环境务必修改密码、`JWT_SECRET`，勿长期使用默认管理员密码。
 
 ---
 
@@ -24,9 +24,11 @@
 | 用户名 | 密码 | 角色 | 说明 |
 |--------|------|------|------|
 | `admin` | `Admin@123` | 平台管理员 | 绑定 `SUPER_ADMIN` 角色 |
-| `agent1` | `Agent@123` | 一级代理 | 授信额度 **100,000** |
-| `agent2` | `Agent@123` | 二级代理 | 上级为 agent1，授信 **30,000** |
-| `player1` | `Player@123` | 玩家 | 挂靠 agent1 |
+| `agent1` | `Agent@123` | 一级代理 | 仅 dev seed 写入，授信额度 **100,000** |
+| `agent2` | `Agent@123` | 二级代理 | 仅 dev seed 写入，上级为 agent1，授信 **30,000** |
+| `player1` | `Player@123` | 玩家 | 仅 dev seed 写入，挂靠 agent1 |
+
+生产模式 seed 只写入 `admin` 和赛事目录数据，不写入代理、玩家、充值流水或注单。
 
 | 入口 | 地址 |
 |------|------|
@@ -71,18 +73,20 @@
 
 | 代码 | 名称 |
 |------|------|
-| `EPL` | 英超 / Premier League |
 | `WC2026` | 2026 世界杯（加拿大、墨西哥、美国） |
 
-### 已发布场次（约 9 场）
+### 已发布场次
 
-- **英超 2 场**：如曼联 vs 切尔西（开球时间为相对当前的演示时间）
-- **世界杯 7 场**：如墨西哥-南非、美国-巴拉圭、法国-阿根廷等（2026-06 固定日期）
+- **世界杯小组赛 72 场**：含 2026-06 固定日期、场馆、分组、球队中英文名。
+- 球队图片使用公开 FlagCDN 国旗 URL，例如 `https://flagcdn.com/fr.svg`；不再使用旧的赛事图片源。
+- 默认赛事全部为非热门赛事，玩家首页不会因为 seed 数据自动出现热门赛事。
 
 每场在尚无盘口时会自动创建演示玩法，包括但不限于：
 
 - 全场 / 半场：独赢、让球、大小、单双  
-- 全场 / 半场 / 下半场：波胆（多档比分选项）  
+- 全场：波胆（多档比分选项）
+
+默认足球盘口模板与赛事 seed **不创建** `HT_CORRECT_SCORE`（上半场波胆）和 `SH_CORRECT_SCORE`（下半场波胆）。这两个盘口类型仍保留在系统识别能力中，便于兼容历史数据或后续手动扩展。
 
 赔率均为种子脚本中的**示例数值**，可在管理后台赛事相关流程中调整（非冠军盘）。
 
@@ -108,7 +112,7 @@
 | 可用余额 | **88,888.88** |
 | 账变流水 | 2 笔演示充值（`DEMO-DEP-001` / `DEMO-DEP-002`） |
 | 语言偏好 | `zh-CN` |
-| 示例注单 | `DEMO-BET-001`：待结算单关；`DEMO-BET-002`：已赢且已结算单关 |
+| 示例注单 | 默认不写入演示注单 |
 
 ---
 
@@ -182,6 +186,14 @@ pnpm db:migrate
 pnpm db:seed
 ```
 
+生产服务器如需清空业务数据并写入正规默认数据，优先使用脚本：
+
+```bash
+CONFIRM=YES ./scripts/prod-init-db.sh
+```
+
+该脚本会先备份 PostgreSQL，再执行 Prisma 迁移，然后以 production 模式清空业务表并写入 `admin`、WC2026 小组赛 72 场和 48 强优胜盘。
+
 ---
 
 ## 十、相关文档