BugPhobia准备篇章：团队Beta阶段准备工作分析

0x00：序言

To the searching tags, you may well fall in love withhttp://xueba.nlsde.buaa.edu.cn/

再见，无忧时光~

0x01 ：Beta阶段会议记录(2015/10/24)

特别说明：Beta准备阶段的会议（2015/10/24~2015/12/07之间的全部会议全部不计入Scrum Meeting，实为准备阶段的集体讨论）

会议记录Github传送门：Beta阶段会议记录过渡阶段)(20151024).md

0x0100：需求分析整理：沟通

 

Beta阶段接口基本定义如下描述：

接口定义描述	具体样例说明
Particular Scopes（URL）：通过URL描述基本的属性或关系	ü  /users/{id}/notifications ü  /question/add
Methods（HTTPS Protocol）：描述服务器的交互方法	ü  GET, POST, PUT, DELETE
Arguments（Requires）：API本身所需的参数	ü  private_information ü  write/read_access
Return：API本身返回的文本返回值	ü  {"body":,"is_unrea":,"post_id":}

 

Beta阶段接口需求文档基本分工：

王鹿鸣	n  定义用户（实体）的基本接口 n  定义标签（实体）的基本接口 n  定义推荐（关系/方法）的基本接口 n  定义基本接口的同时，对Beta阶段的需求文档做出一定的调整 n  同步调研文件上传下载部分的实现方法和接口（此部分工作允许延后，但最终Beta版本的产品必须实现此部分功能）
王文基	n  定义搜索（关系/方法）的基本接口 n  定义基本接口的同时，对Beta阶段的需求文档做出一定的调整
冯志睿	n  实际调研第三方登陆（Oauth/OpenID）的具体应用场景，并尽可能对登陆、注销等与第三方登陆关联的后端部分作出学习
徐越，赵庶宏	n  定义问题（实体）的基本接口 n  定义回答（实体）的基本接口 n  定义基本接口的同时，对Beta阶段的需求文档做出一定的调整

图1 BugPhobia团队讨论第三方登陆和搜索方法的可行性

0x0104：团队基本分工确立：组内协作（会议讨论）

更为详细而准确的版本，请参阅0x0304：Beta阶段任务分工责任的详细内容

王鹿鸣	n  完成Semantic UI框架向ReactJS的代码迁移工作 n  完成其他模块的具体页面的前端实现 n  架构团队整体的开发流程	u  前端开发 u  全栈沟通、架构、前端
钱林琛	n  完成功能规格说明书、技术规格说明书、绩效管理的整理和维护工作 n  Scrum Meeting期间完成Scrum Meeting的记录和更新，要求必须包含：个人的Work Issue的ID关联（已完成、计划完成、工作中的困难记录），燃尽图，照片，代码/文档的签入记录说明 n  与团队成员交流后规划各个开发时间，进行监督和“干预” n  必须与爬虫组、数据组、APP前端组进行沟通	u  项目经理 u  功能沟通，管理
冯志睿	n  调研第三方登陆的基本环境，并在Beta阶段进一步支持第三方登陆 n  根据接口定义，实现相应接口（JSON数据格式），交付前端做进一步的解析	u  后端开发 u  全栈沟通、后端、结对编程
王文基	n  根据接口定义，实现相应接口（JSON数据格式），交付前端做进一步的解析	u  后端开发 u  后端、结对编程
赵庶宏	n  根据接口定义，实现相应接口（JSON数据格式），交付前端做进一步的解析	u  后端开发 u  后端、结对编程
李云涛	n  Javascript和DOM的学习进度规划 n  重新梳理前端页面的逻辑跳转，整理需要开发的“新页面” n  直接以ReactJS的view渲染开始新页面的编码和设计	u  前端开发 u  全栈沟通、前端、结对编程、测试
李入云	n  Javascript和DOM的学习进度规划 n  重新梳理前端页面的逻辑跳转，整理需要开发的“新页面” n  直接以ReactJS的view渲染开始新页面的编码和设计	u  前端开发 u  结对编程、前端
金东禾	n  整理已知的Django框架、Semantic UI框架的入门教程，通过Markdown或LaTex整理为可读性较强的文档，留作为接任此项目的团队的学习文档	u  文档整理 u  学习文档整理、技术平台整理

 

图2 BugPhobia团队和Dream团队讨论接口定义文档之冰糖雪梨方桌会议

图3 BugPhobia团队和Dream团队讨论接口定义文档之冰糖雪梨方桌会议——神奇角度图

 

0x0108：团队文档管理：组内监督

 

团队文档管理说明：

团队自主交流文档尽可能使用**Markdown**文本编辑，允许使用扩展的Markdown语法，但必须保证GIT@OSC或MarkdownPad能够支持相应的扩展语法

对于部分必要的新技术（Semantic UI，ReactJS，Django，Apache部署等等），必须同时维护一份技术入门文档，**此文档允许延迟或交付其他人完成**（如Semantic UI的开发维护可以由Panacea完成），但必须保证各个文档有人维护，需要包含以下基本信息：

n  参考资料或链接（特别鸣谢）

n  常见问题的解决

n  入门教程

n  撰写人，维护人，修改时间和版本说明

文档允许工作转交，但必须保证责任人唯一制度，同时允许协同合作完成

项目经理将依据文档的维护情况进行进度的基本调整，同时文档最后必须由项目经理整合为一份合格的开发文档

 

团队文档管理说明：

前端	n  对于每一ReactJS渲染的页面，要求必须存在独立的维护文档，如果某几个页面关联性强，允许将几个页面合并为一份文档进行维护，但必须包含文件路径，文档说明，维护人等等 n  Semantic UI入门教程（含HTML,CSS） n  ReactJS入门教程
后端	n  对于各个接口定义，要求必须存在一定的维护文档和单元测试！同时提供单元测试/技术文档的说明，此部分文档在后期会进一步作出说明 n  Django入门教程,Solr、Apache、Nutch等的配置
团队整体	n   [直接负责人：钱林琛] 功能规格说明书 n   [直接负责人：钱林琛] 需求分析说明书 n   [直接负责人：王鹿鸣] 前端规格说明书 n   [直接负责人：冯志睿] 后端规格说明书 n   [直接负责人：李云涛] 测试规格说明书 n   [直接负责人：王文基]环境规格说明书（Solr）

0x02 ：Beta阶段接口定义文档

接口文档Github传送门：Beta阶段前后端接口定义说明.md阶段前后端接口定义说明.md

接口文档Cnblog传送门：BugPhobia准备篇章：Beta阶段前后端接口文档

需求文档Github传送门：需求分析和定位概念模型.md

0x03 ：Beta阶段任务管理说明

会议记录Github传送门：需求分析和定位概念模型.md

 

0x0300：Beta阶段任务进度管理

2015/11/24（周二） ~ 2015/12/4（周五）：Beta阶段准备工作	n  完成基本需求和前后端接口的设计，尽快反馈给爬虫组和数据组 n  完成必要的沟通工作，讲明Beta阶段的重要需求和基本的开发需求 n  完成学习成本的消化，完成部分技术的调研工作，探明可行性后进一步进行说明
2015/12/5（周六） ~ 2015/12/19（周六）：Beta阶段开发工作	n  全员进入Beta阶段开发工作 n  开发的起始时间由各组（前端/后端）自行协商确定
2015/12/20（周日）：Beta阶段测试和推广工作	n  Beta阶段的网页已经能够达成Alpha阶段的需求分析，将开始重点围绕推广开展大量工作，吸引大量用户群体（线下推广和线上推广同时进行，海报设计完成时）

0x0304：Beta阶段任务分工责任

王鹿鸣	n  完成历史代码的整理和迁移工作（Semantic UI向ReactJS的单页模式迁移） n  完成新页面的前端开发工作 n  架构团队整体的开发流程	u  前端 u  架构
钱林琛	n  完成功能/技术/绩效等方面规格说明书的整理和维护工作 n  完成Scrum Meeting的记录和更新，要求包含：个人Work Issue的ID关联（已完成、计划完成、工作困难记录），燃尽图，照片，代码/文档的签入记录 n  协商后规划各阶段开发进度，进行监督和干预工作 n  必须与学霸爬虫组（爱码室）、学霸数据组（Power Team）、学霸Android端组（Dream）进行沟通	u  项目经理
冯志睿	n  调研第三方登陆的基本实现流程，考虑支持的可能性（依据目前的调研结果，可行性较低，暂时任务搁置） n  后端开发：根据接口定义完成具体实现（前端根据需求完成变量规范后） n  后端开发维系结对编程/集市模式，而后端开发的管理由完成	u  后端 u  代码复审
王文基	n  后端开发：根据接口定义完成具体实现（前端根据需求完成变量规范后） n  由于Alpha阶段完成了Solr等部分的配置，因此需要完成此部分的文档的书写、复审工作，具体的工作作为长期任务将在文档规范部分进行详细说明	u  后端 u  文档复审
赵庶宏	n  后端开发：根据接口定义完成具体实现（前端根据需求完成变量规范后） n  由于学霸网页端和学霸Android端决定共用后端，因此Dream团队中赵庶宏同学将共同参与到后端开发的部分，具体的任务分工将在开发阶段进一步明确	u  后端
李云涛	n  前端开发：重新梳理前端页面的逻辑跳转，根据“新页面的需求”进行设计和准备 n  前端开发：直接以ReactJS的单页应用模式进行新页面的编码工作 n  测试维护：按照Alpha制定的测试方案（功能性测试、安全性测试、白盒测试、服务器压力测试）	u  前端 u  测试维护
李入云	n  前端开发：重新梳理前端页面的逻辑跳转，根据“新页面的需求”进行设计和准备 n  前端开发：直接以ReactJS的单页应用模式进行新页面的编码工作 级及以后的软件工程团队能够尽快上手，需要将结对编程期间的“学习成本”进行整理，尽可能包含：前置知识的学习（Javascript，DOM等），参考链接，学习笔记，学习心得	u  前端 u  学习文档维护
金东禾	n  整理已知的Django框架、Semantic UI框架的入门教程，通过Markdown或LaTex整理为可读性较强的文档，留作为接任此项目的团队的学习文档	u  学习文档维护

测试的具体安排：

> Beta阶段前端开发这里相对压力较大，因此各部分单元测试必须严格保证（后端开发的验证也将针对单元测试进行严格的要求）

> 其他测试的脚本依旧闭源处理，而预计开发阶段进行一周后开始进行整体的测试

管理的具体含义：

> 项目经理安排进度时会首先和后端组沟通，包含：任务的起始时间、结束时间、工作量

> 某一任务完成后，需要保证单元测试、文档、注释等部分都要包含（此部分由开发组自行斟酌）

 

图4 BugPhobia团队会议留影——不知道谁莫名其妙地直接拍鞋子（QQAQQ）

 

0x0308：Beta阶段任务流程说明

团队在Beta阶段将完成使用Team@OSC进行任务的管理（https://team.oschina.net/Bugphobia）和Github本身的Issues进行关联

n  团队全部成员均能够发布任务，但必须保证任务标签、任务说明均完备，在发布后任务将自动进入待办中状态

n  所有预定任务均会在两天前发布任务，团队的少年/少女在完成任务时应当首先将任务状态更改为进行中状态，而任务完成后可自行将任务状态更改为已完成（或者在Scrum Meeting上说明状况，由其他人归为“已完成”状态）

n  状态进入“已完成后”，任务管理将进入“审阅阶段”，此阶段将由项目经理审阅后更改为“已验收”状态，此后项目经理将同期发布代码复审工作

点左右关注https://team.oschina.net/Bugphobia/，任务将定期发布在这里，一定要保证任务不会被遗漏！

n  注意：团队的所有项目，必须建立在XuebaOnline的任务下

n  文档一定要上传至completed文件夹，待审阅完成后将由钱林琛自动迁移到documents文件夹（后期的整理交由项目经理完成）

0x04 ：Beta阶段会议记录(2015/10/30)

会议记录Github传送门：Beta阶段会议记录(准备阶段)(20151130).md

 

0x0100：Beta阶段准备工作说明

2015/10/31会议说明（不计入Scrum Meeting）：

Beta阶段接口需求文档基本分工：

项目经理根据Beta阶段任务及文档管理.md	n  说明Beta阶段的整体开发进度（准备/开发/维护与推广） n  说明Beta阶段的基本任务分工 n  说明Beta阶段的任务分配流程和具体提交方法 n  说明文档的基本规范和负责人，协商后给出Deadline
说明目前接口设计的完成情况（根据（排版二稿）Beta阶段前后端接口定义说明.md），询问接口设计的进一步工作安排
说明Alpha阶段具体完成的任务及Beta阶段的需要完成的任务
协商任务	n  前端方面：完成ReactJS的基本工作计划，给出一份基本的前端所需完成的工作列表 n  后端方面：根据接口提出修改意见，给出一份基本的后端所需完成的工作列表 n  测试方面：单元测试此次由前后端（主要是后端）自行处理和完成，白盒测试在后续会掺入其中，具体的测试方案列表也尽可能给出

图5 BugPhobia团队会议留影——又不知道谁莫名其妙地直接拍镜子（QQAQQ）

0x0104：Beta阶段具体任务安排说明

2015/10/31会议说明（不计入Scrum Meeting）：

Beta阶段接口需求文档基本分工：

接口审核规范：王鹿鸣	n  依据目前两组接口的整合文档，给出必要的修改意见，其中包括 l  参数、URL本身的重命名 l  接口定义是否规范与完整 n  审核结束后，将继续开始和学霸Android端的开发成员进行进一步的沟通 n  此文档正式提交后，将和数据组、爬虫组讨论实现（接口定义同时包含需求）
测试任务整理列表：李云涛	n  依据“Beta阶段工作整理模板.md”将测试的工作按照时间顺序进行说明，整理成列表，以便后续分配任务
前端任务说明列表：王鹿鸣	n  依据“Beta阶段工作整理模板.md”将前端的工作按照时间顺序进行说明，整理成列表，以便后续分配任务
后端任务说明列表：王文基	n  依据“Beta阶段工作整理模板.md”将后端的工作按照时间顺序进行说明，整理成列表，以便后续分配任务

特别说明：

n  需求分析整理完成状况良好，各部分接口均已独立完成，但未统一命名规则，细节规范等方面；因此，整合王鹿鸣，王文基，徐越的综合接口分析文档，交由王鹿鸣从架构的角度进行文档的复审和修改，待复审结束后于XueBa数据组交流具体的支持程度，进行进一步的任务细化

n  组内基本分工基本确定，在目前尚未开发的阶段，各成员的基本分工和职责已经确立，在正式开发时尽可能不会如Alpha阶段出现大幅度的工作整合和人员调整

n  文档规范，文档规范基本给出，但未给出前端、后端、测试的规范文档模板，此部分仍在定义中，同时Scrum Meeting的基本模板文档也未给出，此部分任务应当纳入准备阶段的必需任务进行准备

n  规格说明书的更新暂时未给出严格定义，等待后续的Meeting做进一步的安排

0x05 ：Beta阶段待完成任务说明

会议记录Github传送门：Beta阶段待完成任务说明.md.md