1、Git代码提交注释规范
需求类Git注释
需求注释格式是:需求#{需求ID}:开发人员填写的注释内容
例如:需求#123456 API接口开发和提供
Git命令:
代码语言:javascript复制$ git commit -a -m "需求#123456 API接口开发和提供"
效果类似如下示例:
提交后,需求状态自动更新为:研发中、自动上屏到需求备注(方便code review)。
问题类Git注释
格式是:bug#{问题ID}:开发人员编写的注释内容或问题原因
例如: bug#123456 这里可以填写修复的原因
Git命令:
代码语言:javascript复制$ git commit -a -m "bug#123456 这里可以填写修复的原因"
效果如下示例:
提交后,问题状态自动更新为:已解决、自动上屏到问题备注(方便code review)、邮件通知问题创建人员并推送钉钉群消息。
上面的需求和Bug提交规范,可以自动和YesDev的需求、Bug进行关联。
2、开发提测新模板
新提测模板请参考:《开发提测模板》
邮件标题:XXXX提测申请
项目链接:// 填写YesDev对应的项目链接或需求链接
开发分支:// 粘贴Git仓库分支链接
code review:// 分支对比链接,以及审计负责人
测试环境:// 填写测试环境的域名或APP安装包链接或小程序体验二维码
开发人员:// 参与本次开发的人员名单(可以进一步补充每个模块的主要负责人)
提测内容:// 原来的提测内容
影响模块:// 原来的影响模块
3、线上故障复盘模板
可以参考YesDev给出的故障复盘文档模板进行复盘,包括:故障标题、故障描述、故障影响及损失评估、处理过程、故障原因、后续改进措施等。
4、YesDev协作流程
1、面向产品经理和需求方
如何分类提需求?
1)常规迭代需求,添加需求或通过Excel导入,由技术负责人 创建项目并进行关联需求,评估工时,排期开发
2)紧急需求,需求方/产品经理和技术负责人沟通确认后,追加需求到已经排期的项目中,并且邮件同步发出
3)专项需求,创建项目后,维护项目需求,并指派需求给技术负责人
4)小改进需求,通过 问题-改进,进行单独提交,非技术问题,属于产品需求的小改动,例如:修改文案、更换图片或链接等
如何查看最新开发进度?
1)通过项目的详情页,查看项目进度和需求进度
2)在需求详情页,通过查看需求的代码提交记录,查看开发动态
3)通过 需求排期,查看当前最新的需求排期计划和迭代进度
4)通过每周的需求KPI邮件《每周需求迭代汇总》定时接收需求迭代的周记录,发送时间支持可配置
5)通过邮件、钉钉群消息,接收相关的需求流转新动态,例如:需求已完成、需求已上线等
6)通过钉钉群 【发布群】上线发布专用群,接收最终发布上线的通知,可以和YesDev进行集成
7)通过项目排期、提测邮件等,接收项目迭代汇总的信息
2、面向研发团队
如何流转需求?
1)根据需求,评估开发任务、工时、和预计完成的时间,在每周一之前形成自己的周工作计划
2)完成任务后,及时将任务状态改为DONE
3)开发过程中,提交代码时,按需求注释规范提交Git代码
4)需求完成或上线后,人工更新需求状态为:已完成/已上线
如何流转问题/Bug/故障/工单/改进?
1)问题解决后,将问题状态改为:已解决,并补充原因
2)问题重开后,重新修复后,将问题状态重新改为:已解决,并补充原因
3)可以按问题注释规范,提交Git代码,会自动更新问题状态为:已解决,并通知对方
4)遇到紧急的故障,应立即响应并处理,按“先止损-后定位-再排查-改代码-发布修复-最后复盘”顺序处理
如何统筹推进项目?
1)进行产品需求评审后,将已确定的需求,创建并关联到指定项目
2)分配需求到技术人员,各自拆解并评估任务和时间
3)汇总项目排期,发出项目排期邮件,如有需求,每天或每周或定时汇总重要项目的进度、风险和进度
4)关注每周的项目整体汇总邮件
3、面向测试部门
如何流转开发过程中发现的Bug?
1)在指定项目详情页,添加新问题到此项目,问题类型选择:Bug,并指派给技术人员
2)问题修复并验收后,将问题状态改为:已关闭,若依然有问题则改为:重开,并填写原因
如何处理线上故障?
1)发现故障后,第一时间在群里同步或现场沟通
2)同步创建故障单,并交给技术人员在故障处理完毕后补充编写
如何规划测试用例和测试计划?
1)可以创建或导入测试用例
2)可以创建测试计划并关联到指定项目
3)在测试计划,可以自动汇总并整理测试报告
4)可以定时接收每周的测试质量汇总邮件,跟踪每周的线上故障、工单等SLA服务水平
5、技术文档编写规范
针对重要的需求、核心功能、以及复杂的项目,可以按以下技术文档模板编写,以便进行技术评审。
开发分支:
// git的仓库分支
修改范围:
// 本次修改的页面、或新增的API接口等
技术设计:
// 核心的UML图,例如:时序图、泳道图、数据模型、架构图、流程图等
自测结果:
// 针对页面、接口、不同业务规则的自我验证,提供单元测试、链接、数据库截图以及其他材料证明
参考资料:
// 外部参考资料,例如XXX开放平台XXX接口