软件研发管理手册v0.0.1

技术管理手册1 / 38四川荣千谷科技有限公司研发中心管理手册版 本：第 0.0.1 版编 制：xuzz审 核：/批 准：受控状态:分 发 号：RQGCD-IT-001实施日期：2017 年 8 月 11 日技术管理手册2 / 38研发中心管理手册 版本/修改号：0.0.1编号 :RQGCD-IT-001 首版日期：2017 年 8 月修改记录版本号 拟写人 日期 修改摘要V0.0.1 Xuzz 2017-8-11 文件初始化技术管理手册3 / 38技术管理手册4 / 38目录1 引言 51.1 目的和范围 .51.2 背景 .51.3 术语和定义 .52 总体战略方针与目标 .62.1 质量目标 .62.2 工作进度目标 .72.3 技术突破目标 .72.4 人员成长目标 .82.5 策略 .93 基本制度 104 研发部岗位职责 114.1 研发部组织架构图 114.2 部门职责 .114.2.1 部门职责 114.2.2 岗位职责 125 薪酬管理 156 绩效管理 157 培训管理 158 产品研发流程 158.1 流程图 .158.2 活动说明 .16技术管理手册5 / 389 产品发布 179.1 产品类别说明 .179.2 缺陷分级规则 .189.3 产品发布标准 .199.3.1 标准要求 199.3.2 交付件说明 209.4 产品发布 .2110 质量管理 2210.1 术语 .2210.2 质量标准 .2210.3 代码审查 .2310.4 开发转测试标准 .2310.5 缺陷跟踪处理 .2410.6 REOPEN 缺陷的处理 2411 配置管理 2411.1 源代码管理 .2411.2 产品配置库目录结构 2511.3 产品配置管理流程图 2611.4 活动说明 .2612 工作报告 2612.1 周报 .2712.2 测试报告 .2713 会议管理 2713.1 原则 .27技术管理手册6 / 3813.2 每日站会 .2813.3 周会 .2813.4 月度会 .2813.5 代码审查会 .28技术管理手册7 / 381 引言1.1 目的和范围本文的目的是明确研发部在工作中所遵循的活动和要求，指导研发部的产品研发、项目开发以及管理工作的开展，以确保研发部的规范执行，且利于公司员工对研发部工作的快速了解。本文档适用范围为整个研发部。1.2 背景做任何事都有步骤和先后顺序，任何工作由不同的人来执行都可能产生不一致的结果。为此，必须有一套已定义的过程来指导各业务活动，以及有一套明确的要求标准来规范各管理工作，让所有人员都能清楚的了解诸如一个部门会从其他部门得到何种信息，经过怎样处理后，又将处理后的结果反馈给哪些部门，或是一个员工会从其他员工得到何种信息，经过怎样处理后，又将处理后的结果反馈给哪些员工，或员工该如何开展工作，该如何配合其他员工的工作等信息，使得简单的事情有条不紊的进行，避免不必要的浪费，将复杂的事情简单化。开发管理手册是研发部业务与管理工作的基本依据和准则，是一份纲领性文件。1.3 术语和定义名词名称 名词解释负责属于本部门或本岗位应负职责，承担主要责任，同时需要其它部门或岗位配合。技术管理手册8 / 38组织 需要本部门（岗位）或其它部门（岗位）共同完成的工作，且本部门（岗位）承担协调事务。参与 需要本部门（岗位）参加的工作，且本部门（岗位）不承担责任。配合 不承担主要职责，但需要在负责部门领导下参与此项工作并承担相关责任2 总体战略方针与目标2.1 质量目标分类 指标 值 备注严重致命 50一般 150全年产品转测 BUG可忽略 300严重致命 0一般 5BUG产品端 BUG消灭可忽略 20严重：指对系统影响较大，不解决会导致系统运行错误或中断，某些功能无法使用；一般：对系统使用影响不大但可以正常使用，有些同环境有关系；可忽略：往往是一些文字性的或故意破坏性的使用会造或显示不全的。性能 产品性能 4 季度 达标 通过压力测试：只要在我们的预设环技术管理手册9 / 383 季度执行压力测试境当中能完成相应的功能流转，不会出现错误或卡死现象，但有可能会出现某些资源预警，需要改进，实际使用有可能会出现卡死或等待很长时间；基本达标：在通过压力测试的基础上，对于性能要求指标超标率较小，基本上不会出现卡死，但有可能还会出现等待时间较长；达标：全部指标均达到预设标准，基本上不会出现卡死，也不会出现等待时间较长。安全 产品安全 4 季度进行安全测试，或寻找第三方专业安全按公司进行测试。2.2 工作进度目标分类 指标 值 备注工作进度目标月度考核任务完成率全年 90%全年部门内各小组的月度考核任务的总体完成率技术管理手册10 / 382.3 技术突破目标分类 指标 值 备注单元测试 完成或应用单元测试技术选型确认并实际应用，是一种白盒型测试方法，但会增加一定的工作量测试自动化移动端自动化测试方案完成或应用采用自动化测试工具模拟人工操作对系统进行测试并出测试报告系统更新效率 完成或应用对现在系统的更新容易出错或工作量较大与工作难度大进行改进效率提升工具代码审核效率 完成或应用对源代码的标准检查，减少人工核查工作量必须行业技术领域了开发技术应用分享次数2了解目前全球领域内现在的软件技术应用与发展趋势，每季度对特定人员分享一次技术管理手册11 / 38解软件发展趋势分享次数2大数据技术 学习努力行业前沿技术应用大数据营销 学习2.4 人员成长目标分类指标 值 备注招聘面试题标准完成或应用选人招聘标准招聘问题询问完成或应用技术管理手册12 / 38培训考核分数80育人 流程与管理类考核分数95推出相应的培训课件，并安排学习，学习后安排相应的考试（笔试、面试）这里的分值是指所对应成员的平均值。2.5 策略分类策略项 备注周会 周报 每周各小组都有周会机制，确定各小组的小组任务目标，并对小组成员进行任务目标的明确，通过日志的方式进行跟踪，同时将由 QA 进行监督执行月会 月度任务考核 各小组与主要对接工作单位进行月度目标的沟通与确认，同时到研发部月会中进行明确，并把月度要考核的任务目标明确，并做好绩效沟通，绩效沟通需要人力支持日常管理动作月度互动活动 各小组每月都进行有益身心健康并促进工作交流与友益类的活动流程产品开发流程 敏捷式 技术管理手册13 / 38非敏捷式 系统部署流程 产品建议与问题解决流程对开发、销售等人员进行产品问题的沟通，并明确问题的处理方式，由 QA 进行持行跟踪 内部系统维护管理流程驱动其他工作支持流程产品发布标准测试质量村准代码实现标准质量标准产品界面标准标准化源代码管理标准内部管理标准技术管理手册14 / 383 基本制度1) 严格遵守公司基本规章制度。2) 严禁在工作时间内做与工作无关的事项，如看电影、打游戏等。在业余时间进行时，也要以不影响他人为主。部门或公司如果收到相关投诉，将进行 20 元/次的处罚。3) 参与公司或部门各类事项时，应本着实事求是、对事不对人的原则。严禁通过吵架、人身攻击等形式进行，如若发现，将对参与者进行 100 元/ 次的处罚，严重时无偿解雇。4) 不可利用公司之设施（电脑，传真等）做私事，不得擅自携带存储工具拷贝公司文件和资料，不得利用互联网间接拷贝公司文件和资料，不得擅自将公司保密文件和受控文件外传或复制，一经发现按公司保密制度重罚，并追究法律责任。5) 对自己所做的每一项工作时刻保持清晰的思维，有不明白的问题，在没有开始做之前，应立即向上司沟通。6) 必须严格彻底的完成每项任务，不得无故违抗上司的工作指令，对由此造成的公司相关损失或商誉受都损害者都严肃处罚，重者无偿解雇。7) 下班应关闭电脑（含显示器）电源，放假期间（超过 2 天假期）应拔掉电源。发现一次未关闭电源或拔掉电源的情况，处以 5 元/次的处罚。8) 研发过程中遇到技术难题时，个人思考或寻找解决办法的时间不宜超过 2 小时，如果在 2 小时内没有解决思路，则请寻求团队帮助。技术管理手册15 / 384 研发部岗位职责4.1 研发部组织架构图4.2 部门职责4.2.1 部门职责1. 制度执行1） 负责本部门流程与制度的执行；2） 参加本部门员工和业务相关部门的培训，理解和遵守公司与部门规章制度3） 根据业务发展或当前突出的问题，设计创新课题，不断进行部门技术与管理创新；2. 计划管理1） 编制月度计划，并负责实施月度计划；2） 参加月度例会3. 日常管理1） 负责每月工作汇报；技术管理手册16 / 382） 参加月度考核；3） 负责每周代码审查；4） 组织或参加部门培训；5） 参加行政人事部每月对小组内成员的工作情况进行汇总，内容包括：组内人数，正常出勤天数、实际出勤天数、加班天数、月考核任务数、月考核任务完成数、转测 BUG 数等；6） 参加或组织月度活动； 4.2.2 岗位职责1. 岗位构成岗位名称 Headcount缺口高级 Java 1 1初中级 JAVA 1 0中级 Android 1 0中级 IOS 1 0中级测试工程师 1 1UI 工程师 1 0中级 web 前端工程师 1 1产品专员 1 1技术管理手册17 / 382. 产品专员1） 完成系统市场需求调研、收集、汇总、需求分析;2） 将业务需求转化为系统需求，编写需求规格说明书、分析说明书，及用户操作指南;3） 进行产品功能、界面、交互和操作逻辑的设计;4） 对软件需求进行管理，跟踪与验证需求在设计、编码和测试阶段的完成情况;5） 支持市场、运营人员撰写产品宣传文案。3. 中级 web 前端工程师1） 负责公司相关产品的前端技术架构设计、搭建工作；2） 负责公司相关产品 PC 和移动端的前端开发工作；3） 负责公司相关产品 APP H5 开发，完成前端界面和后端交互开发；4） 负责与后端工程师沟通协作，调试数据接口；5） 负责系统的优化与重构。4. UI 工程师1） 负责公司相关产品的界面 UI 设计、优化以及规范管理；2） 负责公司相关产品的交互设计、优化以及规范管理；3） 负责公司相关产品的整体界面风格设定和页面设计；技术管理手册18 / 384） 有逻辑的思考，对产品界面进行持续的设计优化，提升用户体验并做到极致；5） 配合同事根据需求完成有效的设计。5. 高级 JAVA 开发工程师1） 参与业务需求设计讨论；2） 负责后端架构分析和技术研究，并将技术应用于产品；3） 负责解决后端的疑难问题；4） 负责后端开发人员的技术培训；5） 配合运维保证线上服务稳定性、可用性 ;6） 支持并指导产品上线工作。6. 初中级 JAVA 开发工程师1） 参与业务需求设计讨论，基于 JAVA 技术平台进行应用程序开发;2） 参与概要设计评审，了解产品功能；3） 共同确认任务分配和开发计划编制；4） 完成负责模块的详细设计。每日汇报进度、计划和需要的支持；5） 完成负责模块的代码实现和功能自测，每日汇报进度、计划，参与周例会；6） 负责分配的 BUG 修改和需求开发。技术管理手册19 / 387. 中级 IOS 开发工程师1） 参与业务需求设计讨论，基于IOS平台进行应用程序开发;2） 负责移动平台软件框架的研究，设计和实现、关键技术验证和选型等工作;3） 完成IOS项目设计、编码、测试和优化。4） 编写相关的开发文档，如技术文档，设计文档，测试文档等。5） 开发针对不同的IOS操作系统版本和屏幕尺寸的应用，并完成兼容性测试。6） 对所开发的APP、SDK进行版本更新及维护。7） 学习和研究新的移动互联网技术以满足产品的需求。8. 中级 Android 开发工程师1） 参与业务需求设计讨论，基于Android平台进行应用程序开发;2） 负责移动平台软件框架的研究，设计和实现、关键技术验证和选型等工作;3） 完成Android项目设计、编码、测试和优化。4） 编写相关的开发文档，如技术文档，设计文档，测试文档等。5） 开发针对不同的Android操作系统版本和屏幕尺寸的应用，并完成兼容性测试。6） 对所开发的APP、SDK进行版本更新及维护。7） 学习和研究新的移动互联网技术以满足产品的需求。9. 测试工程师1） 快速理解产品需求，根据产品需求分析和输出测试需求；2） 参与产品需求和架构设计评审，从测试角度澄清需求和设计疑问，识别产品可测技术管理手册20 / 38试性问题；3） 在敏捷团队和流程中，积极跟踪开发进展，推动研发任务准点、高质量交付；4） 根据测试需求，做好测试分析和设计，制定明确的测试计划和测试方案5） 做好测试分析和总结，输出高质量的测试报告，为产品提供有价值的质量意见和改进建议；6） 配合开发成员定位问题，并积极推动缺陷解决和问题闭环；7） 搭建和维护测试相关任务的测试环境；8） 积极总结和引入先进测试思想和方法，推动测试能力和流程持续优化，并在团队内推广应用；5 薪酬管理待定（含岗位职级体系、岗位工资体系、晋升体系）6 绩效管理待定（含计划管理、考核周期、考核办法）7 培训管理待定8 产品研发流程8.1 流程图技术管理手册21 / 38维 护 PB（ Product Backlog）版 本 发 布 计 划迭 代 启 动 会（ Sprint Planning）设 计编 码用 例 编 写功 能 测 试自 测 试 缺 陷 提 交缺 陷 修 复 回 归 验 证每日站立会议迭 代 评 审 会（ Sprint Review）回 顾 会（ Sprint Retrospective）系 统 集 成 、 预 测 试POPOSM Team POSMTeamPOSM Team POSM Team POSM迭 代 过 程燃尽图更新1n版 本 发 布PO系 统 测 试TeamSM Team产品研发流程示意图8.2 活动说明序号 活动名称 活动说明 角色 输出001 维护 PB 从市场、客户等方面进行产品需求 PM PB技术管理手册22 / 38收集，并根据需求的商业价值设定产品优先级，从而不断的对 PB 进行排序和更新002 规划版本确定版本的目标，明确时间点，进行初步迭代划分，并让所有干系人都了解PM（主导）SM、Team（参与） 版本计划003 启动迭代组织迭代启动会，Scrum 全员参加会议主要内容包括：1、 任务拆分，确定当前迭代的 SB2、 功能点估算，工作量预估PM（组织）Scrum 全员参加SB004 拆分任务 根据需求进行任务拆分 Scrum 全员 SB005 认领任务 各自认领任务 Team SB006 设计根据任务的实际情况，对所要开发的任务进行设计分析Ui、开发（Team）更新的接口/ 数据字典等文档007 编码 进行代码编写 开发（Team） 代码008 用例编写根据要开发的需求进行测试用例编写测试（Team） 测试用例009 自测试 根据任务的实际情况，进行自测试 开发（Team） 测试结果010 功能测试 根据开发提交的软件进行功能测试 测试（Team）测试发现的缺陷，更新的任务状态011 缺陷提交将测试发现的缺陷提交的指定缺陷库中测试（Team） 测试发现的缺陷012 缺陷修复 根据测试反馈的缺陷进行缺陷修复 开发（Team）修改后的代码、更新的缺陷状态013 验证缺陷 根据开发提交的软件进行缺陷验证 测试（Team） 更新的缺陷状态014 评审迭代对本次迭代所完成的任务进行展示，其目的在于让 PM 尽早的了解产品的实现情况，以便尽早的去矫正需PM（组织）Scrum 全员参加，评审意见、更新后的 PB技术管理手册23 / 38求 其他感兴趣的人员也都可参加015 回顾迭代对本次迭代进行回顾，会议内容包括：1、 每个成员说出迭代中做的好的以及做的不好的2、 对于做得不好的找到改进意见3、 对于暂无法改进的放入产品的PB 中进行跟踪PM（组织）Scrum 全员参加会议结论（改进点及改进意见）016系统集成、预测试分支合并入产品，对产品进行预测试开发（Team） 可测的产品软件包017 系统测试 对要发布的版本进行系统测试 测试（Team） 测试报告018 版本发布 对已完成的版本进行发布 PM 客户可使用的版本9 产品发布9.1 产品类别说明产品类别 解释说明A 版（正式版） 提供给客户用于生产环境的版本B 版（Beta 版） 产品每轮迭代发布的内部版本，或供内部演示使用的版本C 版 特殊版本，仅供客户在正式版发布前紧急要求提供低质量版本上线使用9.2 缺陷分级规则本标准将测试过程中产生的问题按严重程度分成四级： 技术管理手册24 / 381）级：致命问题； 2）级：严重问题； 3）级：一般问题； 4）级： 提示问题。 具体的分级规则见下表定义：问题级别 说明 例子致命问题造成系统或应用程序崩溃、死机、系统挂起，或造成数据丢失，主要功能完全丧失，导致本模块以及相关模块异常等问题或安全性或保密性问题代码错误，死循环，数据库发生死锁、与数据库连接错误或数据通讯错误，SQL 注入漏洞、上传文件未作登录验证、登录验证逻辑存在错误，未考虑异常操作，功能错误等严重问题系统的主要功能部分丧失、数据不能保存，系统的次要功能完全丧失。问题局限在本模块，导致模块功能失效或异常退出致命的错误声明，程序接口错误，动态成本计算错误，数据库的表、业务规则、缺省值未加完整性等约束条件一般问题 次要功能没有完全实现，但不影响使用操作时间长，模块功能部分失效等，合同起草关联公文失败，搜索结果错误，次要功能计算错误，软件产品的编译、打包、安装、卸载错误，打印内容、格式错误，数据库表中有过多的空字段等提示问题使操作者不方便或遇到麻烦，但它不影响功能的操作和执行；经过说明，用户可以较容易理解并且不影响用户使用的提示信息不太准确，或用户界面差，删除操作未给出提示，错别字、界面不规范（字体大小不统一，文字排列不整齐，可输入区域和只读区域没有明显的区分标志），辅助说明描述不清楚，由技术管理手册25 / 38问题提出人对测试对象的改进意见或测试人员提出的建议、质疑9.3 产品发布标准9.3.1 标准要求产品类别发布要求A 版 B 版 C 版需求实现1. 该版本计划的产品需求 100%实现；2. 产品的性能、可靠性、可维护性、安全性，达到产品设计目标；该版本计划的产品需求 100%实现该版本计划（客户要求）的产品需求 100%实现缺陷及遗漏1. 无致命级别遗留问题；2. 无严重级别遗留问题；3. 一般问题及提示性问题总和不超过20（提示问题不得超过 100 个）；5. 在编译器中、源码分析与运行时分析中所报告的所有错误都得到了修正；无致命级别遗留问题；1. 无致命级别遗留问题；2. 无严重级别遗留问题；测试过程1. 代码编译和构建在所有平台上通过；2. 测试完成了覆盖 100%需求点；3. 测试计划中的测试用例 100%执行（需提供用例执行情况）；1.代码编译和构建在所有平台上通过；2.本次迭代功能测试覆盖了100%需求点；3. 测试用例通过率 95%以上；1. 代码编译和构建在所有平台上通过；2. 测试覆盖了 80%以上的需求点；技术管理手册26 / 384. 测试用例通过率 95%以上；5. 按测试计划完成了测试计划中要求的性能测试、功能测试、稳定性测试等测试，如前期在测试策略中做了裁剪的测试，可不做要求；配置过程1. 产品可以在所有目标平台上重复构建；2. 物理配置审计确认现有的所有组件都是正确的版本；3. 产品在所有的目标平台上都能成功安装；4. 发布的介质和镜像文件经过了反病毒和恶意软件扫描；5. 已知的未修复缺陷全部记录在产品的缺陷跟踪系统中；6版本已打了标签，确保此版本的源代码和所有配置脚本等可以回溯；1. 产品可以在有目标平台上重复构建；2. 物理配置审计确认现有的所有组件都是正确的版本；3. 产品在所有的目标平台上都能成功安装；4. 发布的介质和镜像文件经过了反病毒和恶意软件扫描；5. 已知的未修复缺陷全部记录在产品的缺陷跟踪系统中；6如功能完整实现，则需确保版本已打了标签，确保此版本的源代码和所有配置脚本等可以回溯；1. 产品可以在所有目标平台上重复构建；2. 物理配置审计确认现有的所有组件都是正确的版本；3. 产品在所有的目标平台上都能成功安装；4. 发布的介质和镜像文件经过了反病毒和恶意软件扫描；5. 已知的未修复缺陷全部记录在产品的缺陷跟踪系统中；6版本已打了标签，确保此版本的源代码和所有配置脚本等可以回溯；交付件 产品功能清单、更新说明、部署手册及配套的部署视频、数据库模型说明书、产品操作手册、测更新说明、测试报告、需求文档、测试用例产品功能清单、更新说明、产品操作手册、测试报告、需求文档技术管理手册27 / 38（具体交付件说明见 6.1）试报告、需求文档、测试方案、测试用例、产品缺陷、产品缺陷 、测试方案、测试用例、产品缺陷9.3.2 交付件说明产品发布时将对应此次发布的所有交付件进行整理、归档和同步发布，交付件清单见下表：交付件名称 内容说明 性质 责任人产品功能清单产品的功能列表一个产品维护一份，每次发布时就新增的内容进行文档更新，其主要目的是能够让产品的接收者全面熟悉此款产品并做好产品的知识传承工作产品组外部人员使用产品经理更新说明 本次发布的更新说明（含版本号）产品组外部人员使用开发负责人产品操作手册产品的操作说明一个产品维护一份，每次发布时就新增的内容进行文档更新产品组外部人员使用 团队指定人员测试报告产品需求要求或计划中安排的性能测试工作，要交付性能测试报告和功能测试报告，否则交付功能测试报告。测试报告包括以下内容：1）趋势分析：单轮测试分析本轮测试 BUG 趋势，不需要计算缺陷率 ,多轮测试需要统计缺陷率；2）遗留问题统计和跟踪：遗留问题可能产生风险，需要相关开发人员给出规避措施,遗留问题个数不能超过 2 个；3）质量评价：分析测试发现了多少问题，都是哪些类型的问题，严重或致命问题需要重点说明，问题是否修复，是否存在遗留问题。4）覆盖率统计： 测试过程测试了哪些功能产品组外部人员使用产品测试负责人技术管理手册28 / 38-测试能保证的功能，测试过程中未测试哪些功能-测试不能保证的功能；5）测试设计评估：评估测试用例设计是否覆盖所有功能以及如何保证测试设计质量；6）测试执行评估：评估测试执行过程中是否执行所有测试用例，在发现测试用例存在遗漏时，是否进行补充测试。需求文档本次版本所做的需求说明页面原型，功能需求。功能流程 业务场景产品组内部使用产品经理测试方案本次版本所使用的测试方案。测试方案按照测试方案模板编制，明确测试范围、测试重点，进行必要的测试分析，尤其是影响分析产品组内部使用产品测试负责人测试用例本次版本所执行的测试用例及其执行结果。用例编制使用测试用例模板，覆盖所有功能、边界功能、场景用例、功能交互用例以及异常用例；测试用例标识出验收测试用例。测试用例有评审记录，并说明预