# 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:初期代码少,但业务规则无法复用且测试困难,拒绝采用。 ## 后果 - 初期需要更多目录和契约代码,但能够降低行业扩展和后台迭代的返工成本。 - 每个接口都需要同步类型、测试和客户端调用,交付速度以可验证性为优先。 - 后续新增行业时优先新增模板配置与校验,不修改个人品牌核心模型。