你的文件与底座的文件
修改标为“你的”的文件,不动底座文件,更新就能顺利合并。
| 路径 | 存放什么 | 归属 |
|---|---|---|
apps/web/src/site/config.ts | 本站配置,以及新增的导航、页脚和 SEO 条目 | 你的 |
apps/web/src/site/messages.ts | 本站文案,以及对底座措辞的覆盖 | 你的 |
packages/db/src/schema/site/ | 你自己的数据表 | 你的 |
packages/db/migrations/site/ | 你的数据表对应的迁移 | 你的 |
site/ | 站点信息、建站清单、部署状态和执行记录 | 你的 |
apps/web/src/i18n/messages.ts | 底座文案。要改措辞,在 src/site/messages.ts 里写同名键 | 底座 |
apps/web/src/config/site-config.base.ts | 底座的导航、SEO 路径和配置校验 | 底座 |
packages/db/src/schema/pg/, sqlite/ | 底座数据表,每个模块一个文件 | 底座 |
packages/db/migrations/pg/, d1/ | 底座迁移及其历史 | 底座 |
两条迁移通道
底座和本站各自记录迁移历史,你的数据表不会与底座更新冲突。
| 数据库 | 底座历史 | 本站历史 |
|---|---|---|
| PostgreSQL | drizzle.__drizzle_migrations | drizzle.__drizzle_site_migrations |
| Cloudflare D1 | d1_migrations | d1_site_migrations |
pnpm db:migrate 和 pnpm release 都先执行底座迁移,再执行本站迁移。
合并底座更新
更新以 Git 提交的形式发布在上游分支。
合并更新
合并上游分支并保留你的修改。你自己的文件很少冲突。
执行迁移
pnpm db:migrate 把新的底座迁移应用到本地数据库。
运行测试
先跑单元测试,部署前再跑完整检查。
发布
经你授权后,pnpm release 执行迁移并部署。
接入新供应商
新的支付或 AI 供应商只是边缘的新代码,中间的业务规则保持不变。
支付渠道
你要写的
- 负责收银台、通知和退款的适配器
- 它的密钥和设置从哪里读取
- 它在后台和订单页面上的名称
- 它真正支持的订阅操作
直接复用的
- 订单快照与服务端核查
- 防重复的事件处理
- 付款与积分的原子写入
- 积分账本、退款流程和后台订单
AI 供应商
你要写的
- 针对其 API 的请求与结果映射
- 如实声明它能做到什么
- 它所提供模型的目录条目
- 它在 Worker 中需要的密钥
直接复用的
- 报价与积分冻结
- 队列、租约和每五分钟一次的巡检
- 输出校验与可选的内容审核
- 私有交付与结算
让它保持可扩展的约定
几条约定承担了大部分工作。
- 路由保持精简;服务端 action 负责权限和输入校验;每个模块的数据读写在 repository.ts,业务规则在 service.server.ts。
- 必须一起生效的写入,例如付款和它发放的积分,放在同一个原子调用里。
- 需要给底座表加字段?新建一张以底座表主键为主键的本站表,例如 site_user_profiles.user_id。
- 已发布的订阅商品不再修改。新价格使用新的商品 ID,已有订阅者保持原有条款。