Alpha项目展示

项目	内容
这个作业属于哪个课程	2021春季软件工程（罗杰 任健）
这个作业的要求在哪里	Alpha-项目展示
我们是谁	删库跑路对不队
我们在做什么	题士
进度如何	进度总览

一、项目与团队亮点

1.关于我们

1.1 团队成员与分工简介

姓名	负责	具体工作简介
QSY	PM&前端	产品主页与后台管理系统设计与开发，服务器nginx与SSL等部署与维护，例会报告与产品相关博客的撰写，推进项目进度，审查项目质量
LKL	后端	题目相关接口、单元测试的撰写，CICD的部署，题目相关数据模型的设计与建立
CWM	前端	题库、收藏|错题列表、各种刷题模式、模拟考试等页面相关的前端工作的设计、开发与测试
CYY	后端	用户相关，后台管理相关接口、单元测试的撰写，服务器后端相关配置与维护，个人信息相关数据模型的设计与建立
LS	前端	注册、登录、首页、我的及个人信息，产品介绍等页面相关的前端工作的设计、开发与测试
WCC	后端	题目评论相关接口、单元测试的撰写；题目数据的爬取、清洗与导入；题目图片与用户头像上传等接口的开发与测试

1.2 项目管理

初始打算：Space 关联 Github 进行项目管理，不过后续得知今年团队开发仓库统一使用gitlab，由于Space 不能较好地关联gitlab的项目，遂放弃

最终决定：使用gitlab的Milestone+issue+Merge Request的方式管理

首先建立Milestone

根据需求分析的结果，设计功能并划分为具体任务，任务分为Design，Develop和Test三类，并以issue的形式分配给团队成员

团队成员分别创建个人开发分支，通过发起merge request的形式，将前端阶段性开发成果经由二次确认后merge进入front-end分支，将后端阶段性开发成果经由二次确认后merge进入back-end分支；前后端功能完善，符合Milestone设定计划后，发起merge request，经由PM审核后merge进入master分支；在每次merge的过程中，关联issue，在确认merge后，自动关闭对应issue

2.典型用户场景

临近期末，小A还没开始航概期末复习，现在他正面临着复习时间紧迫，复习资料不完整的问题，正当他不知所措的时候，小B向他推荐了题士...

小A：我使用的是IOS操作系统，一般的软件和应用都对IOS平台不支持，我能够使用题士吗？

小B：题士利用微信小程序平台对IOS和安卓平台统一支持，同时也发布了安卓客户端对安卓进行额外支持

小A：现在离期末考试仅剩几天，但是我对于相关知识点和题目都不了解，题士能够给我什么帮助吗？

小B：题士提供顺序刷题，随机刷题和易错刷题等多种做题模式，顺序刷题帮助你按照章节进行复习，随机刷题帮助你交叉复习不同章节内容，易错刷题统计了所有同学常见易错题，帮助你聚焦易错内容

小A：可是我对很多内容不熟悉，应该会错很多题，有没有什么比较有效的复习方式？

小B：题士能够帮助你对你错的题目进行记录，提供错题列表，也能够在错题列表中直接对错题进行复习；同时提供收藏列表，让用户自主收藏好题；而且如果对于内容不熟悉的话，也可以选择题士提供的背题模式，对航概进行快速复习

小A：真是太好了，我的期末考试有救啦！

3.特色功能

3.1 杀手功能

题士Alpha版本的杀手功能包括易错模式刷题，模拟考试，刷题进度显示等功能

3.2 对比竞品

说明：️表示完全具备， 表示不完全具备，表示不具备

对比内容	航概练习题库	考前自救题库	题士
小程序端	️		️
安卓APP端	️	️	️
切换科目	️		️
查看题库	️	️	️
关键词搜索	️		️
顺序刷题	️		️
随机刷题	️		️
错题列表	️	️	️
收藏题目列表	️		️
易错刷题			️
模拟考试			️
背题模式		️	️
做题天数		️	️
设置用户头像			️
做题情况统计	️		️

4.项目发布

4.1 面向使用人群发布

1906为即将考航概的使用人群，产品率先向他们推广

4.2 海报

进一步制作海报，进行产品的展示与宣传

4.3 宣传册

同时制作H5宣传册，方便在通讯软件中的宣传与分享

4.4 实际日活数据

累计访问量：



日活数据：



发布四天平均日活：53.25

4.5 用户反馈

5.软件工程质量

5.1 设计文档

文档是开发的依据，是维护的凭证，是拓展的基础

项目有完善的API设计文档和数据库设计文档

Beta阶段将继续扩充架构文档

5.2 代码规范

前端代码规范

题士uni-app开发遵循uni-app开发规范和Vue单文件规范

后台管理系统开发过程中，将部分内容修改后的现有业内开发规范设置为自身开发规范，具体规范代码详见gitlab仓库

后端代码规范

后端开发主要采用node.js框架，使用javascript语言，因此遵循javascript开发规范

5.3 项目继承

项目代码结构清晰，文档规范，继承项目者在查询uni-app和node.js前后端开发框架后即可接手开发，项目开发可进一步查阅uni-app和node.js开发文档

5.4 单元测试与CI/CD

前端以功能测试和兼容性测试为主，后端以压力测试和单元测试为主

前端功能测试、兼容性测试和后端压力测试详见Alpha阶段测试报告，后端单元测试结果如下：

共计78个测试用例，代码覆盖率为80%，其中后端未覆盖接口具体包括：

• 修改密码涉及邮箱发送与验证
• 邮箱注册，设计邮箱发送与验证
• 微信登录

其中前两个未覆盖接口均涉及邮件发送，由于邮件发送按量计费，团队开发经费有限，因此未对其进行单元测试，第三个微信登录接口无法自动进行测试，所以未进行覆盖测试

同时项目部署CI/CD，自动触发后端单元测试，保证后端开发质量，测试结果如图：

5.5 经验教训

内容较为独立，因此另发一篇总结博客记录，详见Alpha阶段性总结

5.6 Beta计划

1.根据用户反馈与测试结果修复alpha版本的bug：

功能改进|bug	改进结果|修复结果
题目收藏列表的开始按钮位置调整	由上一版本的始终固定为页面头部修改为悬浮在页面下端
小程序游客状态下，点击收藏题目按钮提示已收藏	重新设定为游客状态无权限点击收藏题目按钮
ios系统查看题目评论闪出问题	ios系统已无点开题目评论后闪出问题
题目评论的组件略丑	调整题目评论的组件，进一步美化
开始刷题时的下拉刷新设置影响刷题体验	删除开始刷题时的下拉刷新设置
修改第一道题的上一题的提示	将“请求失败”修改为“没有啦”
小程序游客模式下点击登录不能自动拉取微信头像的问题	小程序游客点击登录可以正常获取微信头像

2.进一步开发改进alpha内容

任务	原因
api进一步细化	alpha阶段部分api重用，重用会使某些调用获取的冗杂数据较多，需要对api进一步细化，减少重用
易错刷题页面显示每个题目的错误率	alpha阶段未能同时显示题目的错误率，仅能保证所刷题目为易错题
模拟考试提交结果另设页面，进一步美化	alpha阶段提交后仅显示得分，需要另设页面，显示得分、圆圈显示题目对错
题目列表按章节下拉时才请求对应章节的题目数据	alpha阶段为初始时请求所有题目数据，加载较慢，更改为点击下拉栏，才按对应的章节请求数据，提升加载速度
添加连续引导页作为新手指引	项目部分功能需要说明，可以考虑添加连续引导页进一步表述，或在产品官网上进一步说明

3.按Beta版本原定计划开发完善题士功能

进一步开发题士中的如下功能：

• 问答社区（问题讨论，经验分享）
• 资源分享社区
• 考期日历倒计时
• 知识卡片

二、项目与团队总结

项目与团队总结部分为亮点中涉及的项目相关内容的进一步扩充，对亮点部分形成支撑

1. 成员沟通

Alpha开发阶段团队每两天进行一次线下例会，每次例会总结个人开发进度，讨论开发成果，制定开发计划，并进行集中高效开发，及时沟通，及时调整

每次例会时间在4h-8h之间，会议记录详见Scrum Meeting汇总

2. 资源平衡

项目总体架构如图：

团队两名前端开发人员LS与CWM负责安卓APP和微信小程序的联合开发

另一名前端开发人员QSY负责产品主页和后台管理系统的联合开发

两名后端开发人员LKL与CYY负责题士主体功能的后端开发工作

另一名后端开发人员WCC同时负责题士评论功能的后端开发工作和题库的数据爬取、清洗和导入等相关工作

项目能够如期交付的原因如下：

• 团队各个成员的能力均十分突出，可以独当一面
• 团队各个成员对项目均抱有认同感，认为在做一件有价值、有意义的事，而非单纯地为了分数完成任务
• 团队成员彼此熟识，配合默契，可以为同一目标齐心协力，全力冲刺
• 团队成员可以主动提升团队开发任务相较于个人任务的优先级，保证项目进度正常推进

3. 进度推进

团队成员开发过程中士气高涨，项目推进较快，除五一假期前两天整装待发、准备冲刺外，其余时间均有项目相关的产出，并及时提交，发起merge request，关闭issue，具体燃尽图如下：

4. 成员贡献

成员贡献计算依据团队贡献分分配规则，具体结果如下：

姓名	基础分	工作量	额外工作	额外工作说明	总分
QSY	45	3	5	帮助CWM定位小程序开发BUG；技术博客：Gitlab Burndown Chart Generate；PM工作，协调监督、完成团队博客	53
LKL	45	2	4	帮助WCC完成图片上传；提供node.js开发资料；	51
CWM	45	2	0		47
CYY	45	2	2	技术博客：基于JWT的Token身份验证；后端压力测试	49
LS	45	3	3	帮助CWM美化前端样式；技术博客：Uniapp云打包生成apk下载链接；app发布，负责小程序审核	52
WCC	45	2	1	数据爬取与处理；后端压力测试	48

团队成员具体任务说明与数据支持如下：

姓名	负责	团队贡献分	具体工作简介	代码量	参与文档
QSY	PM&前端	53	产品主页与后台管理系统设计与开发，服务器nginx与SSL等部署与维护，例会报告与产品相关博客的撰写，推进项目进度，审查项目质量	3355	除题目相关API、题目评论相关API和数据库设计文档外的所有文档
LKL	后端	51	题目相关接口、单元测试的撰写，CICD的部署，题目相关数据模型的设计与建立	1162	功能规格说明书-五-七 技术规格说明书 团队贡献分分配规则：初版 题目相关API 题目相关数据库设计
CWM	前端	47	题库、收藏|错题列表、各种刷题模式、模拟考试等页面相关的前端工作的设计、开发与测试	2299	需求分析文档：四、五 技术规格说明书 功能规格说明书：五-七 团队贡献分分配规则：初版 题目相关API 题目相关数据库设计
CYY	后端	49	用户相关，后台管理相关接口、单元测试的撰写，服务器后端相关配置与维护，个人信息相关数据模型的设计与建立	1417	功能规格说明书:一-四 Alpha阶段初始任务分配 团队贡献分分配规则：终版 Alpha阶段测试报告：压力测试说明、用户场景测试说明 个人信息相关API 后台管理系统相关API 个人信息相关数据库设计
LS	前端	52	注册、登录、首页、我的及个人信息，产品介绍等页面相关的前端工作的设计、开发与测试	2039	功能规格说明书:UI设计 评论相关API 题目评论相关数据库设计
WCC	后端	48	题目评论相关接口、单元测试的撰写；题目数据的爬取、清洗与导入；题目图片与用户头像上传等接口的开发与测试	1142	功能规格说明书:一-四、整合 Alpha阶段初始任务分配 团队贡献分分配规则：终版 Alpha阶段测试报告：压力测试说明、用户场景测试说明 评论相关API 文件上传API 题目评论相关数据库设计

5. 用户场景相关

项目开发前的目标

• 实现一款集刷题、题目讨论、错题整理、社区资料分享等功能为一体的优质软件

• 安卓APP与微信小程序的同时发布

• Alpha阶段：累计用户量为200；Beta阶段：保守估计每日活跃用户为400

预期的典型用户场景

我们针对产品的典型用户进行了以下五类划分：普通学生，大佬，DDL选手，助教和老师，具体描述如下

普普通通，平平无奇的普通学生

内容	说明
用户姓名	钉崎野蔷薇
照片
用户身份	19岁，女大学生，普普通通的大学生，各项能力平均
用户痛点1	有一定学习基础，想要通过做题对学习内容进行复习，获得中等偏上的成绩
用户痛点2	对基础题目能够正确作答，对于难题存在作答障碍或者理解困难
用户痛点3	对于恶心的题目，有强烈的吐槽欲望
软件对应功能	题士多模式做题功能（alpha版）；题士题目搜索（alpha版）；题士讨论区（beta版）；题士题目评论区（alpha版）。目前可以进行多模式刷题，可以在对应的题目下进行评论
使用预期场景	日常学习时，通过题士多模式刷题及时回顾学习内容，巩固知识点；在遇到难题时，通过问答社区提问，等待大佬或者老师助教的解答；在做题的同时，在题目讨论区吐槽，创作
用户比例	50%

学习无难事，万人膜拜的大佬

内容	说明
用户姓名	伏黑惠
照片
用户身份	20岁，男大学生，学习能力强，愿意为同学答疑解惑，分享做题经验
用户痛点1	想要更有效率地进行做题和复习，对题目进行整理和分类，方便记录做题笔记，获得高分
用户痛点2	没有便捷途径获得往年的考题资料，及时复习
用户痛点3	想要有个途径对自己的踩坑进行记录和分享
软件对应功能	题士题目收藏，错题自动整理功能（alpha版）；题士资源分享社区（beta版）；题士讨论区（beta版）。目前可以在错题和收藏题目列表中快速查看自己的错题和收藏题目
使用预期场景	日常做题，通过平台能够方便整理错题，同时收藏好题和易错题；在做题同时，记录解题思路和对应知识点；通过资源分享社区，及时获取往年真题，及时刷题
用户比例	20%

平时玩乐，期末完了的DDL选手

内容	说明
用户姓名	虎杖悠仁
照片
用户身份	20岁，男大学生，摸鱼一时爽，期末火葬场，不到期末绝不复习的DDL选手
用户痛点1	期末考前，想要通过最短时间过最多的题，同时重点关注好题和易错题
用户痛点2	知识点难以在短时间记忆，希望有人分享知识点记忆技巧
软件对应功能	题士背题功能（alpha版）；题士易错题刷题（alpha版）；题士题目评论区（alpha版）。目前可以在背题模块中快速背题，在短时间内通过背题获取大量知识
使用预期场景	三天之后航概期末考试，在短时间内，通过大量快速过题进行复习；吸取踩坑经验，做题小技巧，尽全力不挂科
用户比例	25%

腼腆但是热情的课程助教

内容	说明
用户姓名	两面宿傩
照片
用户身份	24岁，男研究生，课程助教，内向腼腆，有耐心愿意为同学答疑解惑
用户痛点1	同学们常常提问同质问题，每次都需要重新回答同样的内容
用户痛点2	班级群中发布的资料常常过期，需要重新发送
软件对应功能	题士讨论社区（beta版）；题士资源共享社区（beta版）。beta开发结束后将满足此典型场景
使用预期场景	助教通过翻阅提问区问题，对共性题目统一解答；通过平台上传资料，不用担心资源过期，不能下载的问题
用户比例	4%

有责任心的老教师

内容	说明
用户姓名	五条悟
照片
用户身份	45岁，教授，课程主讲教师
用户痛点	希望了解同学们对于学习该门课程普遍的难点，痛点，针对性讲解题目，整理知识点，帮助同学们通过课程
软件对应功能	题士易错题（alpha版）；题士讨论区（beta版）。目前可以查看易错题，根据易错题制定习题课，提升学生成绩
使用预期场景	打开题士，查询易错题和讨论区常见问题，制定习题课和复习课计划，帮助同学们针对性复习
用户比例	1%

预期的功能描述

界面	功能描述	开发阶段
登录	用户可以通过微信或邮箱两种方式进行登录	Alpha
注册	用户通过输入邮箱，获取验证码进行注册，绑定账户	Alpha
首页	首页展示产品的核心功能，并提供相应功能入口，包括考期日历、错题/收藏、知识卡片、题库、资源社区、问答社区和刷题功能等，用户可以切换不同科目，选定科目后开始使用本产品	Alpha
我的-题库	展示用户头像、昵称、累计做题数、做题天数、历史记录等内容，提供关于我们、意见反馈、分享、设置和退出等功能入口	Alpha
我的-社区	由默认的题库选项切换至社区选项，获取问答数量、获赞数量等统计数据信息，提供我的问答的链接入口，方便用户直接查看	Alpha
刷题|背题	支持用户在刷题和背题两种模式中切换，对题目进行收藏等。在刷题模式下，用户根据题干内容选择正确选项，产品反馈正误，用户可以点击查看评论按钮，查看各种评论，也可以自己发表评论或评论他人评论；在背题模式下，产品直接提供题干内容和正确答案，用户可以快速背题	Alpha
题库	支持用户在题库中根据关键词进行搜索，同时展现当前科目下各章节的所有题目的完成情况，用户可以点击某一题开始刷题	Alpha
错题|收藏	展示用户的错题数或收藏题目数，并按照不同章节整理错题或收藏的题目，用户可以点击某一章节进入题目列表，查看该章节下的所有错题或收藏的题目	Alpha
题目列表	某一章节下的错题列表或收藏题目列表，用户可以点击开始按钮对错题或收藏的题目进行练习	Alpha
考期日历	支持用户根据考期安排设置考期日历，产品将根据考期日历对用户进行贴心提醒	Beta
知识卡片	对于不便于设置为选择题形式的知识内容，均可以通过知识卡片的形式进行理解、记忆。知识卡片对知识进一步细化、整理和归纳，提升用户学习效率。开发团队将导入部分知识卡片，用户也可以自行添加设置卡片	Beta
问答社区	支持用户查看Open、Closed、All和Mine四种状态下的讨论贴，用户可以发帖，回帖，参与讨论，产品将综合关注度、发帖时间等因素对不同状态的讨论贴分别排序后呈现	Beta
资源社区	支持用户添加资源描述上传资源链接、根据链接下载资源等	Beta

在哪里发布了软件？

微信小程序平台和安卓APP二维码下载

详见Alpha-发布说明

项目发布后是否满足了全部典型场景？剩下的为何没有满足？

目前暂未满足全部典型场景，部分未完成的场景将在beta版本阶段迭代开发。

已实现场景（Alpha版本）	未实现场景（Beta版本）
APP端邮箱注册与登录	讨论区（问题讨论，经验分享）
小程序端微信登录	资源分享社区
多模式刷题功能（顺序做题，随机刷题，易错刷题）	考期日历倒计时
模拟考试	知识卡片
题目搜索
题目评论区
收藏题目列表
错题列表
背题模式

6. 竞品评价

思考一下竞品出于什么原因并没有囊括该特色功能，团队凭借什么样的优势实现了它？

从竞品自救题库的NABCD分析博客中可以看出，竞品开发团队并未进行充分有效的需求分析（至少在博客中并未体现需求分析调研结果）

从竞品自救题库的开发过程记录中可以看出，竞品开发团队存在部分成员消极怠工现象，开发进度较为缓慢

题士开发团队在产品功能开发前，对预期使用用户进行了较为详尽的需求分析；在开发过程中，配合默契，团队开发进度推进合理，每位开发人员的开发工作均做到全身心投入

7. 自我评价

团队成员对这些功能的自我评价如何，是否达到了预期目标，为什么？

• 根据发布后的问题反馈，Alpha开发的功能仍存在bug需要修复、体验需要提升

• 部分前端组件确实略丑，将进一步改进

• Alpha功能达到预期，Beta功能将如期实现

• Beta开发阶段将继续冲冲冲！

再次注明：项目与团队总结部分为亮点中涉及的项目相关内容的进一步扩充，总结部分未覆盖的内容已在亮点部分说明