Files

T

OuYingJun1024 c61997b876 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>

2026-05-27 21:04:25 +08:00

2.0 KiB

Raw Permalink Blame History

集成层（integrations）文档 — 索引

本目录记录 app/integrations/ 下各第三方 SDK / 外部服务的集成内部实现：签名、加解密、协议细节、配置项、踩坑。与 docs/api/ 的区别：docs/api/ 描述对外 HTTP 接口契约（入参/出参/错误码）；本目录描述接口背后调外部服务的重逻辑。

架构约定

app/api/v1/ 接口层只放很轻的东西：解析请求 → 调 repositories/integration → 组装响应 + HTTP 错误码映射。
集成 SDK 的重逻辑（签名/验签/加解密/外部 HTTP 调用）一律放 app/integrations/。换签名方案、换供应商只动这一层，api 层不受影响。
集成模块统一从 app.core.config.settings 读配置；密钥/证书懒加载（文件缺失不在 import 时炸进程，只在真正调用时抛各自的 XxxError）。

集成清单

模块	文件	用途	关联 API 文档
极光 jiguang	`app/integrations/jiguang.py`	一键登录服务端核验 + RSA 解密手机号	auth-jverify-login
短信 sms	`app/integrations/sms.py`	验证码发送 / 校验（当前 mock）	auth-sms-send · auth-sms-login
美团 meituan	`app/integrations/meituan.py`	CPS 券查询 / 换推广链	meituan-coupons · meituan-feed · meituan-referral-link
穿山甲 pangle	`app/integrations/pangle.py`	激励视频发奖回调验签	ad-pangle-callback
微信支付 wxpay	`app/integrations/wxpay.py`	商家转账到零钱（提现）+ code 换 openid（绑定）	wallet-withdraw 等

2.0 KiB Raw Permalink Blame History Unescape Escape

集成层（integrations）文档 — 索引

架构约定

集成清单

详情

2.0 KiB

Raw Permalink Blame History