xsl
76a0502ea3
- claim_task_bonus 在幂等快捷路径前做完成凭据校验：report_feedback 查当日 rp_feedback、first_report 查 succeeded rp_report，无凭据 40311 且不打流水；sign_in/share_report 不校验（产品决策：签到行为即领取，分享内测期接受端侧自报，hard_cap 锁死刷量收益） - task_bonus_rules 默认值与 .env.example 同步产品定稿（产品方案 §3.2，2026-09-11）：sign_in 对话+10/day、report_feedback 发型+2/day、share_report 换装+3/day、first_report 重生成+1/lifetime；下架 invite_friend/profile_complete - billing/repo 新增只读凭据探测 has_feedback_between/has_completed_report（import-linter 禁 billing→report，直查 shared.models 的 rp_* 表，永远只读） - 测试：test_task_bonus_eligibility 5 用例（40311 两分支/凭据后 200/40910/40410/零流水） 偏差说明：test_task_bonus 与 test_task_bonus_rules 断言数值随定稿更新（发放/幂等/封顶语义未动）；quota.py docstring「占位值」说法顺手更正。
packages/shared/ — 横切基础设施
配置、日志、错误码、统一响应、数据库、Redis、可观测性。架构 §16.1。
| 模块 | 内容 |
|---|---|
config.py |
pydantic-settings 类型化配置，全部来自环境变量 |
errors.py |
统一错误码（§9.2：4xxxx 客户端 / 5xxxx 服务端 / 6xxxx 外部依赖） |
response.py |
统一响应信封 {code, message, data, request_id, hint} |
handlers.py |
FastAPI 异常处理器，保证任何异常都返回信封且不泄露堆栈 |
middleware.py |
请求 ID / 追踪 ID、访问日志、HTTP 指标、/v1 路径别名 |
logging.py |
structlog JSON 日志 + 脱敏处理器 |
context.py |
请求上下文（request_id / trace_id / user_id / task_id） |
db.py |
异步 SQLAlchemy 引擎与会话 |
models.py |
ORM 表定义 |
redis_client.py |
Redis 连接 |
observability.py |
OTel tracing + Prometheus 指标注册表 |
能放什么
跨所有域复用、且不含任何业务判断的东西。
不能放什么
- 任何业务规则。「配额够不够」属于
packages/domain/billing， 「任务能不能取消」属于packages/domain/task。放进来就没人能纯单测了。 - 对具体业务域的 import。
shared在依赖层级的底部，反向依赖会立刻形成环。
日志脱敏不是可选项
logging.py 的脱敏是 structlog 处理器，作用于每一条日志，没有 opt-in。
新增敏感字段时加进 SENSITIVE_KEYS，或用 LOG_EXTRA_REDACT_KEYS 环境变量。
NFR-SEC-03 / 架构 §11.2：手机号、UnionID、图片地址、诊断结论、令牌一律脱敏。
新增错误码
在 ErrorCode 加值，同时在 ERROR_META 加 message 和 hint。
测试 test_every_error_code_has_metadata 会强制这一点。
FR-BILL-07：配额相关文案里不能出现价格、购买、会员、升级字样，
test_quota_hint_never_mentions_price_or_purchase 会扫描全部文案。