xsl
cf9d500bfa
SmsSender Protocol（fake/tencent）+ 验证码生命周期（哈希存储/一次性/ 5 次作废）+ 号码-IP-设备三重频控 + 掩码纪律（FR-ACC-04/14，TD-32； 真实发送待签名审核）。 实现：packages/identity/sms_login.py（SmsStore/SmsSender 双 Protocol、 FakeSmsSender 打日志、TencentSmsSender 包官方 SDK 失败映射 61000、 SmsAuthService 验证码生命周期 + UTC+8 时段桶频控）；路由 POST /auth/sms/send、POST /auth/sms/verify（provider="phone" 映射 + issue_session + TokenPairResponse，与华为通道零耦合）。测试：单测 37 个 （内存 dict 实现 store、注入时钟模拟 TTL；号码规范化/掩码/频控矩阵/ 验证码四要素/腾讯通道桩测），集成 7 个（send→verify 双令牌闭环、同号 同 user、脚本化刷量 11 发第 11 次 42911、IP/设备维度、错 5 次作废）。 门禁：ruff/mypy(identity+apps/api)/lint-imports 全绿，单测 275 通过、 集成 23 通过。 偏差说明： 1. SmsSender.send_code 收 (phone, masked, code) 三参而非单一「掩码键」： 腾讯通道下发必须有真实号码（掩码/哈希无法投递）；防泄漏由「实现层 不得记录 phone」约定 + structlog 全局手机号脱敏兜底。 2. 频控计数按「请求」计（含被拒请求）且在限额检查前自增：否则被拒 请求不烧额度，攻击者可无限试探；同时这是「连发 11 次第 11 次 42911」脚本化验收在真实时钟下成立的前提。 3. request_code 对 sender 逃逸的非 AppError 异常兜底包成 61000： 通道故障不得以 5xxxx 内部错误形式稀释告警（TencentSmsSender 自身 映射为主，此处仅接漏网）。 4. wire 请求模型（SmsSendRequest/SmsVerifyRequest）定义在 sms_login.py 内（任务文档允许的两选一，未新建 sms_schemas.py）。
meida_backend · 美搭服务端
「美搭」智能穿搭美学助手的服务端。当前状态是工程地基 + 一条打通的纵向切片
（登录取 token → 配额预扣 → 真实调用 DeepSeek → 记成本 → 提交配额），
业务域大多只有目录与 README，见各 packages/*/README.md。
技术选型与分层依据见仓库外的《技术架构文档》《技术选型与调研报告》，本文只讲怎么跑起来。
快速开始
cp .env.example .env # 填入 DEEPSEEK_API_KEY
make install # uv sync + 装 pre-commit
make up # PostgreSQL(pgvector) + Redis，端口 55432 / 56379
make migrate # 建表并创建 vector 扩展
make run # http://localhost:8000/api/v1/docs
验证真实链路（会产生真实 API 费用，是唯一花钱的入口）：
make smoke
它会起依赖、迁移、拉起 API、发一次真实对话，然后把 ob_ai_call
的成本行与 bl_ledger 的配额流水打出来。跑通即证明「计量 + 配额 + 大模型」三者串通。
目录结构
| 目录 | 职责 |
|---|---|
apps/api |
HTTP 入口。只做鉴权、校验、幂等、配额、统一响应，不放业务规则 |
apps/worker |
Celery 长耗时任务入口 |
packages/domain |
纯领域逻辑，不许 import 任何框架与 I/O |
packages/llm |
大模型网关：场景路由、Prompt 版本、结构化输出、成本计量、预算熔断 |
packages/shared |
配置、日志脱敏、DB、Redis、错误码、中间件 |
packages/<业务域> |
identity / billing / task / agent / kb / retrieval / report … |
services/ |
需要独立伸缩的重型服务（换装、抠图、视觉），V1 为占位 |
prompts/ |
按 <prompt_id>/<version>.txt 归档，与 ob_ai_call.prompt_version 对应 |
migrations/ |
Alembic；CI 强制 upgrade → downgrade → upgrade 往返可用 |
依赖方向由 lint-imports 强制（pyproject.toml 的 [tool.importlinter]）。
apps → packages → domain 是单向的，业务包也不得绕过网关直连 provider。
提交前
make check # lint + typecheck + imports + test + secrets，与 CI 同一套
单测不连库、不发网络请求。需要真实中间件的用例在 tests/integration，
默认跳过，用 make test-integration 显式开启。
两件容易踩的事
- Prompt 固定前缀不许含时间戳、随机值等易变内容。 命中缓存的输入单价只有未命中的
约 1/30，前缀被污染会让输入成本翻数十倍。
LLM_CACHE_PREFIX_MODE=strict下启动即失败。 - DeepSeek 自 2026-08-17 起峰谷定价，高峰（北京时间 09:00-12:00、14:00-18:00）
单价是空闲时段的 2 倍。单价配两套，由
packages/llm/cost.py按调用时刻选择； 成本在调用当时算好落库，事后不按当前价重算。