Skip to Content
指南集成自己的业务

集成自己的业务

模板提供认证、基本账户资料、后台管理、商业基础能力与可选内容,没有必须依赖的示例业务。Bookmark、Decision Log、组织协作与工具仪表盘已从当前应用退场。

完成安装后,为自己的产品定义一个完整用户任务。实现和验证时使用隔离本地数据库。

添加页面前明确归属

职责归属位置必须确定的事项
业务实体与不变量src/server/ 下的业务领域归属、有效生命周期转换、输入限制与并发规则
公开服务合同领域拥有的 TypeScript 合同查询、命令、安全结果与失败/恢复语义
可替换 HTTP 调用方领域拥有的 src/contracts/ 协议与生成客户端准确请求/响应 schema、调用方权限与错误映射
持久化自有表与已审阅迁移约束、已有数据处理与 Cloudflare D1 支持
页面与 Actions路由内的 src/app/ 组合新鲜身份、服务调用与传输适配
UI路由内视图或实际共享组件草稿、等待/确认/拒绝/未知反馈及无障碍控件
产品发现src/application/product/navigation/只包含实际支持的目的地址,包括登录返回与 CTA 路径

页面或客户端只提供用户输入,不能提供可信用户 ID、角色或存储适配器。服务通过 Auth 获取当前权限,逐项检查资源操作。导航可见性不授权查询或写入。

使用已安装的 UI 基础组件与领域服务边界。不要在页面、表格单元格或表单中实现数据库查询、支付解释或业务状态转换。新的前端布局应消费同一领域合同。

商业操作

Payments 拥有产品、不可变报价版本、结账尝试与确认支付事实。已发布目录项本身不是业务能力。将真实领域操作绑定到明确权益策略与可信商业观察;基础模板没有默认付费示例操作。

新销售独立于已有购买选择。/me/billing 拥有客户账单与原尝试恢复。结账返回 URL 不能确认支付;支付或资源效果不确定时,必须遵循原领域恢复规则,不能作为新命令重放。

旧产品退场时,保留已记录产品与报价身份,处理已有账单义务。移除源码不授权删除客户历史数据或改写支付事实。

产品组合

src/config/product.ts 声明公开品牌与能力选择。core 关闭新销售;personal-paid 在供应商和报价配置可用时选择真实结账。Docs、Blog、分析与反馈附件仍需显式选择。参见配置。

基本账户导航包含资料与账单。只有实际支持用户任务且路由独立授权时才添加入口。开发者设置说明保留在 Docs;客户账户不承担入门教程或实现示例集合的职责。

验证完整任务

验证创建或编辑成功、第二账户的读写被拒绝、无效输入及相关冲突。命令可能产生未知结果时,验证恢复不会悄悄产生第二次效果。覆盖直接路由/API 调用、键盘操作和窄屏。使用仓库命名本地实例工具进行隔离应用验证。

测试真实公开服务调用方与实际应用。fixture 只证明其有限场景,不证明供应商投递或已部署 Worker 行为。源码检查、本地应用证据与 Cloudflare 部署证据应分别保留。


集成自己的业务 | cfstack 文档