docs: 新增数据库迁移指南 + 迁移脚本,同步目录结构文档

- 新增 docs/数据库迁移.md: clone 后如何建表(alembic upgrade head)、日常升级、
  新增迁移、迁移文件名 vs revision id 的关系与去前缀注意事项、当前 9 条迁移链
- 新增 scripts/migrate.sh: 只做迁移不启服务(部署/CI 用),run.sh 已自动包含
- 后端技术实现.md 目录树: crud 并入 repositories、alembic 文件名去 hex 说明、
  补 docs/数据库迁移.md;接口层"调 repositories/integration"措辞同步
- README.md / docs/integrations 残留 crud 提法同步为 repositories

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

docs/后端技术实现.md

@@ -41,14 +41,14 @@
 
 ## 3. 分层架构与目录结构
 
-标准 FastAPI 分层,一个请求自上而下穿过:**api(薄,收发) → integrations(外部 SDK) / crud · repositories(数据) → models / db**。重逻辑(SDK 签名/加解密/外部 HTTP)落 `integrations`,集成层细节见 [docs/integrations/](./integrations/README.md)。
+标准 FastAPI 分层,一个请求自上而下穿过:**api(薄,收发) → integrations(外部 SDK) / repositories(数据) → models / db**。重逻辑(SDK 签名/加解密/外部 HTTP)落 `integrations`,集成层细节见 [docs/integrations/](./integrations/README.md)。
 
 ```
 app/
 ├── main.py                  # FastAPI 入口:注册全部 router、CORS、/health、lifespan
 ├── api/
 │   ├── deps.py              # 共享依赖:get_current_user(鉴权)、get_db(注入 session)
-│   └── v1/                  # 接口层(薄):解析请求 → 调 crud/integration → 组装响应 + HTTP 错误码
+│   └── v1/                  # 接口层(薄):解析请求 → 调 repositories/integration → 组装响应 + HTTP 错误码
 │       ├── auth.py          # 登录 6 端点(极光一键登录 / 短信 send+login / refresh / me / logout)
 │       ├── coupon.py        # 领券透传 /coupon/step(转发 pricebot)
 │       ├── meituan.py       # 美团 3 端点 + feed 拼接(_interleave / _TOPIC_ROUNDS)
@@ -74,14 +74,13 @@ app/
 │   ├── ratelimit.py         # 同 IP 滑动窗口限流依赖
 │   ├── rewards.py           # 发奖/兑换/提现额度等业务常量与换算
 │   └── logging.py
-├── crud/                    # 福利业务数据访问 + 事务(钱包/签到/任务/省钱/发奖)
+├── repositories/            # 数据访问 + 事务(早期叫 crud,2026-05 统一并入此目录)
+│   ├── user.py              # get_user_by_id / get_user_by_phone / upsert_user_for_login
 │   ├── wallet.py            # 账户/流水/兑换/提现单(调 integrations/wxpay)
 │   ├── signin.py            # 签到记录 / 连续天数 / 档位
 │   ├── task.py              # 一次性任务领取
 │   ├── savings.py           # 省钱汇总 / 战绩 / 明细
 │   └── ad_reward.py         # 看广告发奖(按 trans_id 幂等 + 每日上限)
-├── repositories/            # user 域数据访问(2026-05 由 crud 改名沿用)
-│   └── user.py              # get_user_by_id / get_user_by_phone / upsert_user_for_login
 ├── models/                  # ORM 表结构
 │   ├── user.py              # user(含微信 openid/nickname/avatar)
 │   ├── wallet.py            # 金币账户 / 金币流水 / 现金流水 / 提现单
@@ -93,17 +92,18 @@ app/
     ├── base.py              # DeclarativeBase
     └── session.py           # engine + get_db
 
-alembic/                     # 数据库迁移(versions/ 目前 9 个迁移,down_revision 链式)
+alembic/                     # 数据库迁移(versions/ 9 个迁移;文件名已去 hex 前缀,链靠文件内 down_revision)
 deploy/                      # systemd(.service) + nginx(.conf)
 secrets/                     # 极光 RSA 私钥 / 微信支付证书(不入 git,仅 .gitkeep 占位)
-scripts/                     # 运维脚本(对账 / 重置签到 / 重置福利 / 模拟穿山甲回调)
+scripts/                     # 运维脚本(migrate 迁移 / 对账 / 重置签到 / 重置福利 / 模拟穿山甲回调)
 tests/                       # pytest(auth / health / welfare / withdraw / ad_reward / coupon_proxy)
-run.sh                       # 本地启动脚本
+run.sh                       # 本地启动脚本(自动先跑迁移再起服务)
 docs/api/                    # API 接口文档(索引 README + 一接口一文件)
 docs/integrations/           # 集成层实现文档(SDK 签名/加解密/协议细节)
+docs/数据库迁移.md           # Alembic 迁移指南(如何建表/升级/新增迁移)
 ```
 
-> **命名说明**:`api/v1/` 的 `v1` 用于 URL 版本化(移动端无法强制即时升级,需新旧版本并存能力);`integrations` 装外部 SDK 集成、`crud`/`repositories` 装数据访问、`core` 装基础设施,三者分离。**数据访问层有两个目录是历史遗留**:user 域在 `repositories/`(早期 crud 改名),后来的福利业务在 `crud/`,职责相同。`coupon.py` 是领券透传,勿与 `meituan.py` 里的 `coupons`(券列表)混淆。
+> **命名说明**:`api/v1/` 的 `v1` 用于 URL 版本化(移动端无法强制即时升级,需新旧版本并存能力);`integrations` 装外部 SDK 集成、`repositories` 装数据访问、`core` 装基础设施,三者分离。**数据访问层统一在 `repositories/`**(早期叫 `crud/`,2026-05 已整体并入,`crud/` 不再存在)。`coupon.py` 是领券透传,勿与 `meituan.py` 里的 `coupons`(券列表)混淆。
 
 ---