正文
获取原文件references/architecture-workflow.md
保留完整需求。选择架构由项目约束决定,不默认微服务、Kubernetes、BFF、多 Agent 或自部署模型。存在需要取舍的关键选择时比较成立的方案并记录 ADR,不为固定数量编造候选。
设计要求
- 定义系统内外范围、角色、外部系统、信任边界和组件责任。
- 将 FR/NFR 映射到组件及完整业务流程;需求中缺少实现的部分维持待实现状态。
- 对关键对象、配置和事件说明产出方、存储、使用方、读取或触发时机、版本、失效和业务终态。
- 明确同步调用、异步任务、事务边界、数据所有权、重复处理、失败恢复和状态可见性。
- 配置管理、业务执行与审计记录分别设计;有配置页面或记录表不能证明存在执行能力。
- 定义权限、数据分类、保留、加密、租户隔离和审计要求,注明依据与适用环境。
- 描述本地、测试、生产的源码、构建、配置、数据和秘密流向,持久数据与临时测试环境分别管理。
- 明确 SLO、容量、RTO/RPO、成本变量、超时和有依据的恢复策略。失败保持可观察,不能用替代结果伪装成功。
- 外部服务及模型按实际接入方式设计:API 服务记录供应商与接口边界,本地部署补制品、引擎和资源要求。
版本和平台能力有变化风险时查当前官方资料;推导和测量分别标注。详见 架构检查。
验证与交接
设计中每个组件均能关联需求,每个关键产出有使用方或合法终态。适用实验以实际命令和测量证明,不能将设计吞吐、成本或合规目标写为当前事实。
向 S005 各分支提供组件边界、所有权、接口类别、配置与事件关联、身份要求、NFR 和风险。向 S007/S009 提供业务流程验收点,交给 S006 检查范围完整性和跨模块一致性。多阶段状态遵循 交付记录。