1.6 KiB
1.6 KiB
ADR 0001:个人品牌平台架构边界
- 状态:已采纳
- 日期:2026-09-19
背景
产品需要支持个人品牌信任建设,同时允许餐饮、咨询、设计、摄影等行业模板复用。后台负责配置内容,小程序和其他客户端负责渲染与提交。
决策
- API 使用 NestJS + Prisma,Controller 负责 HTTP 边界,Service 负责业务规则,DTO 负责运行时输入校验。
- 共享 API Client 和 types 作为客户端契约,接口变更必须同步测试和调用方。
- 管理后台使用 React + Ant Design + TanStack Query + React Router,按 feature 拆分页面。
- 品牌内容、服务、信任内容和行业字段由后台配置驱动;客户端不得写死行业业务规则。
- 认证、授权、品牌隔离和统一错误响应属于平台基础设施,业务 feature 不得各自实现一套。
备选方案
- 继续在单个 React 入口文件中实现所有页面:短期速度快,但会造成状态、请求和业务耦合,拒绝采用。
- 让小程序直接维护服务和文案:上线简单,但无法支持后台配置和多行业模板,拒绝采用。
- 让 Controller 直接操作 Prisma:初期代码少,但业务规则无法复用且测试困难,拒绝采用。
后果
- 初期需要更多目录和契约代码,但能够降低行业扩展和后台迭代的返工成本。
- 每个接口都需要同步类型、测试和客户端调用,交付速度以可验证性为优先。
- 后续新增行业时优先新增模板配置与校验,不修改个人品牌核心模型。