marco
b50495bebe
短信(SMS_MOCK 切 mock/real): - integrations/sms.py 重写: real 模式走极光短信 REST /v1/messages 自定义验证码(本服务 secrets 生成 6 位码 + 进程内存 + 本地校验一次性/防爆破), 鉴权复用极光一键登录 JG_APP_KEY/MASTER_SECRET (同一极光应用, 上线只需 SMS_MOCK=false); mock 仍"任意6位通过"不动其余测试 - 防刷四层: 单号冷却 + 单号每日上限 + 单IP rate_limit(/sms/send 10/min、/sms/login 20/min) + 单码失败次数作废; SmsError 带 status_code 映射 429/503/400 - config 增 SMS_SEND_ENDPOINT/SIGN_ID/TEMPLATE_ID/CODE_LENGTH/DAILY_LIMIT/MAX_VERIFY_ATTEMPTS; test_auth 加 real 模式单测; sms.md/后端技术实现/待办账本同步 admin 后台(app/admin/ 独立子应用, uvicorn app.admin.main:admin_app :8771): - 复用主仓 models/repositories/integrations + 同库, 鉴权完全隔离(ADMIN_JWT_SECRET≠JWT_SECRET_KEY + payload typ=admin + bcrypt 密码 + 可选 IP 白名单); 主 app 不 import 本包, admin 崩不影响主进程 - 路由: 登录 / 账号管理(RBAC: super_admin·finance·operator) / 用户列表+360详情+封禁+手动调币 / 钱包流水 / 提现重试对账 / 反馈工单 / 数据大盘; 全写操作落 admin_audit_log(涉钱与业务写同事务) - 涉钱逻辑(调微信/退款/对账)复用 app.repositories.wallet 不重写 - 新增 models/admin.py(AdminUser/AdminAuditLog) + admin_tables 迁移 + create_admin.py + deploy/shaguabijia-admin.service; 依赖加 bcrypt Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
集成层（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 等 |