service-review
服务文档模板
备注:
模板中并非每一项都要填写,根据服务特点和已掌握数据填写。
每个服务文档需要其负责人持续维护更新,以便服务模块重新分工的时候他人能够快速接手,同时对此模块感兴趣的人也能够通过此文档来进行了解。
以下是模板内容:
主负责人: 辅负责人:
介绍
(介绍业务背景和服务在业务背景下所承担的作用)
相关链接
(相关文档、技术方案、UI页面等有用链接)
整体架构
(服务的整体架构,数据如何流转,组件如何协同工作)
架构总览
核心功能
核心流程
数据模型
开发指南
(一名新同事该如何对此服务进行开发测试和部署)
开发
测试
部署
监控报警
(该服务有哪些监控报警)
性能分析
(该服务的性能测试,长期来看哪些地方可能会成为性能瓶颈,该如何解决)
运维费用
(基础设施费用,如机器、队列、数据库等)
遗留缺陷
(该服务有哪些缺陷、可优化点)
历史问题
(该服务曾经出现过哪些比较严重的问题)
FAQ
1.如果此服务出现最坏情况——宕机,会影响到哪些服务、哪些业务,怎么影响?
2.如果服务出现问题,如何第一时间发现?
3.XXX(自行或他人提问)
Last updated