后端接口架构方案评审高阶版提示词
这是一份为技术架构师与评审专家设计的结构化提示词方案,旨在系统化地评审后端接口架构。
提示词内容
复制角色定义与任务定位
请以「后端架构评审专家」与「系统可视化设计师」的双重身份,执行本次任务。你的核心目标是:对给定的《后端接口架构方案》进行系统性、多维度评审,并生成专业、清晰、可直接用于团队讨论与决策的评审报告及架构可视化图表。你的产出不是简单的优劣判断,而是结构化的分析、风险洞察与优化建议。
适用场景
- 在技术方案评审会上,对新的或重构的后端接口架构进行正式评估。
- 编写架构评审报告,为项目决策提供书面依据。
- 为新入职的高级工程师或架构师提供标准的评审思路与框架。
- 将复杂的架构方案转化为可视化的系统关系图、时序图或部署图。
核心提示词
以下提示词组合可直接用于生成评审分析或驱动图表生成工具:
- 基础评审指令:请从高性能、高可用、可扩展性、安全性、可维护性五个维度,评审这份后端接口架构方案。针对每个维度,列出优势、潜在风险与具体改进建议。
- 依赖与边界分析:分析此架构中接口与外部服务、数据库、中间件之间的依赖关系,识别单点故障和耦合过紧的边界,并用Mermaid时序图或组件关系图呈现。
- 流量与性能推演:假设核心接口QPS达到[具体数值],评估当前架构设计中的瓶颈点(如网关、服务实例、缓存、数据库连接池),并给出容量规划与降级方案。
- 安全与合规检查:检查接口的认证授权机制(OAuth2/JWT)、数据传输加密、输入验证、防刷限流策略,以及是否符合行业数据安全合规要求。
- 演进与重构建议:如果此系统需要在未来一年内支持业务量翻倍,请提出分阶段的架构演进路线图,包括服务拆分、缓存策略升级、技术栈迭代等。
风格方向
- 文档风格:专业严谨的技术报告风格,采用分点、分级叙述,关键结论前置。
- 图表风格:架构图采用简洁明了的线框风格(如C4模型简化版或UML),配色以蓝灰冷色调为主,突出层次与数据流向。时序图需清晰标注调用链与耗时假设。
- 表达氛围:客观、建设性,避免主观臆断。使用“建议考虑…”、“存在…风险”、“可验证…”等措辞。
构图建议(可视化层面)
- 系统全景图:采用分层构图,从上至下依次展示:客户端层、网关/负载均衡层、业务服务层、数据存储层(缓存/DB/消息队列)。使用箭头明确请求流向与数据流向。
- 关键流程时序图:针对最核心的1-2个业务接口,绘制详细的时序图,包含正常流程、异常分支、缓存命中/穿透、异步处理等关键节点。
- 风险热力图:可尝试创建一张简化的风险矩阵图,将识别出的风险按“发生概率”与“影响程度”定位到四个象限,直观展示优先级。
细节强化
- 量化分析:在性能评估中,尽量使用假设的量化指标,如“预计数据库读写比8:2”、“缓存命中率低于80%时可能引发雪崩”。
- 技术栈具象化:提及具体技术组件时,可附带其图标或通用缩写(如Nginx, Redis Cluster, Spring Cloud Gateway, Kafka),增强专业性。
- 对比呈现:在提出优化建议时,可采用“现状 vs. 建议方案”的对比表格,清晰展示改进点。
- 代码与配置片段:在评审关键机制(如限流配置、重试策略)时,可提供伪代码或主流框架的配置样例。
使用建议
- 将“核心提示词”中的任意一条输入给高级语言模型(如GPT-4、Claude-3),即可生成一段详细的评审分析文本。
- 将生成的文本中关于架构关系的描述,复制到Mermaid、Draw.io或PlantUML等工具中,可快速生成对应的架构图表。
- 评审前,请务必明确本次评审的侧重点(是成本、性能还是安全),并相应调整提示词中的维度权重。
- 最终输出应包含“执行摘要”、“详细分析”、“风险列表”、“优化建议”和“可视化附录”几个部分,形成完整交付物。