个人实践
六张必交图与评审检查单
- 六张图:功能架构、业务流程、总体架构、技术架构、交互时序、部署架构
- 每张图标注版本和对应 ADR 编号
- 评审检查单核对质量属性、压测数据和故障演练证据
- 遗留问题登记负责人和截止时间
工程实践02
用质量属性和取舍驱动架构设计:确定关键质量属性,划分系统层次,用 ADR 记录决策,交付可评审的架构图和接口契约。
把架构设计从画图变成可评审的决策过程:质量属性、取舍、ADR、架构图和接口契约一一对应。
| 阶段 | 输入 | 处理 | 输出 |
|---|---|---|---|
| 需求与约束 | 业务目标、合规与资源限制 | 识别关键参与者、外部系统和硬约束 | 约束清单、非目标 |
| 质量属性排序 | 约束清单 | 写可度量的质量场景并排序 | 质量属性表 |
| 方案对比 | 质量属性与现状 | 给出两个以上候选,按同一组维度比较 | 方案对比表 |
| ADR 决策 | 对比结论 | 记录结论、理由、代价和 Revisit 条件 | ADR 文档 |
| 图与契约 | ADR 集 | 产出分层图、链路图、部署图和接口契约 | 六张图、OpenAPI / AsyncAPI |
| 评审与演进 | 图与契约 | 按检查单评审,记录遗留问题与版本 | 评审记录、架构版本 |
个人实践
工程做法
# 统一动作接口(节选)
POST /actions/{action}
请求:{ deviceId, params, confirmToken? }
响应:{ actionId, status: accepted | rejected | timeout }
错误码:DEVICE_OFFLINE / NEED_CONFIRM / DUPLICATE_ACTION
幂等键:actionId个人实践
# ADR-0003 设备上报使用 MQTT 状态:已采纳 背景:设备需要长连接上报遥测,HTTP 轮询延迟不可接受 决策:MQTT over TLS,EMQX 集群接入 代价:需要维护会话与离线消息,运维复杂度上升 Revisit:设备量超过 5 万或需要双向强一致时重新评估
为一个「设备实时接入 + 业务状态管理 + AI 辅助决策」的系统设计分层架构,不要直接堆技术名词。 按以下顺序输出: 1) 从业务目标推导 3 个质量属性并排序,说明最不能坏的是哪一个; 2) 给出分层(终端 / 接入 / 业务应用 / 平台服务 / 数据与中间件 / 基础设施),每层写职责与「不负责什么」; 3) 分别画出实时上行与指令下行两条链路经过哪些层,指出瓶颈与隔离点; 4) 说明 AI 能力放在哪一层、它不能做什么、人工确认放在哪里; 5) 列出 3 个关键 ADR 标题,每个含两个候选方案与各自代价、Revisit when。 约束:状态只能在一处流转;AI 不进入控制闭环;每张图都要能指回某个 ADR 编号。
真实项目:无人机智能作业平台,改造前后均有架构图与 ADR 对照。
功能、流程、总体、技术、时序、部署
MQTT 上报、统一动作层、状态机位置
统一动作层的字段、错误码与幂等键
图与 ADR 可在站内 /architecture 页面逐项核对。