Softie 是一个面向美国市场的 AI 陪伴聊天产品。这是新人入职后从零到能独立修 bug、上线功能所需的全部背景知识 —— 架构、开发、部署、监控、踩坑都在这里。
softieweb · main → 自动部署当前消息系统是 messagesV2。老的 messages 表已废弃，但仍有遗留代码。所有读写都走 V2，转纯文本用 convertMessageToPreviewText()。
Better Auth 的 session.user.id 是 text；DB 业务表（orders/messagesV2）的 userId 是 UUID。需要用 businessUser.id 翻译，否则 postgres 直接报错并 500。
Fly.io 部署仅启动新容器，不跑 db:migrate。新 migration 必须在 GHA workflow 里显式调用，否则线上 DB 会落后导致 42703。
必须 gh run list 确认 CI success，再用 curl 验证生产文件包含改动。CI 绿灯不代表 CDN 已刷新（橙云缓存 24h+）。
Next.js + Mastra Agents + Drizzle + Redis + R2 是怎么拼在一起的；核心数据流（聊天、支付、推送）如何走；BullMQ Worker 干什么。
阅读 →从 0 到能跑起 dev server：依赖、env、Docker Postgres+Redis、常用命令、Android 调试 (JDK 21)、调试技巧。
阅读 →main 分支自动上线流程、GHA workflows 全景、回滚命令、必须遵守的「推完必验」规范、Cloudflare CDN 刷新。
阅读 →Sentry / PostHog / Langfuse / Clarity 分工；Lark Bot 矩阵（Pay-Bot / Cost-Bot / Ads-Bot）；每日数据监控自动化管道。
阅读 →Airwallex 主 + Stripe 备的双轨；订阅 vs Sparks 区别；webhook 幂等；reconcile cron；ID 翻译陷阱与 Branded Types 防御。
阅读 →过去半年踩过的所有坑按主题分类：环境变量、Drizzle、Capacitor、推送、Lark、Fly.io、定价、性能。新人省一周。
阅读 →过去 7 天 PostHog + Clarity 抓到的真实「差一步就付款」用户群像。10 个独立案例 · 完整事件时间线 · LLM 解读 + 行动建议。开会用。
阅读 →