Files
persionalBrand/docs/adr/0001-personal-brand-platform-architecture.md
T

29 lines
1.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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:初期代码少,但业务规则无法复用且测试困难,拒绝采用。
## 后果
- 初期需要更多目录和契约代码,但能够降低行业扩展和后台迭代的返工成本。
- 每个接口都需要同步类型、测试和客户端调用,交付速度以可验证性为优先。
- 后续新增行业时优先新增模板配置与校验,不修改个人品牌核心模型。