项目 内容
这个作业属于哪个课程 2021春季软件工程(罗杰 任健)
这个作业的要求在哪里 团队项目-计划-功能规格说明书

一、架构与技术栈

1.整体架构

本项目的整体架构如上图所示。下面我们将对涉及的技术栈进行详细说明:

2.前端框架

采用uni-app框架来设计前端界面,支持多平台发布的同时给用户良好的使用体验。

uni-app 是一个使用 Vue.js 开发所有前端应用的框架,开发者编写一套代码,可发布到iOS、Android、Web(响应式)、以及各种小程序(微信/支付宝/百度/头条/QQ/钉钉/淘宝)、快应用等多个平台。极大地继承了Vue.js的优势:自底向上渐进式的开发设计。

3.后端框架

采用Node.js + Express 框架管理后端数据库。

Express框架是一个基于Node.js平台的极简、灵活的web应用开发框架,主要基于Connect中间件,并且自身封装了路由、视图处理等功能。另外,得益于Node.js繁荣的生态,我们通过npm可以方便的实现对所需资源包的获取与管理。

4.数据库

采用了MySQL数据库,后端使用MySQL包提供的接口实现ORM(Object-Relational Mapping,把关系数据库的表结构映射到对象上),经过处理后返回给前端

5.云环境

采用了腾讯提供的轻量应用服务器,具体配置如下:

镜像:Ubuntu 20.04 LTS

运算组件:2核CPU、4GB内存

云SSD系统盘:80GB SSD云硬盘

流量包:1200GB流量包

二、设计与分析

1.系统层面

1.1 代码设计

  • 抽象、模块化、封装

    • 前端模块化

      • 使用Uni-app原生组件进行开发,如tabbar,button等

      • 对于特殊功能,还需要封装自定义组件,如:刷题组件,问答列表,资源列表,题目列表,卡片内容.

      • 目录结构则由Uni-app推荐的目录结构进行管理.

    • 后端抽象、模块化

      • 后端数据抽象化

        后端将数据库返回的查询结果进行封装后,以对象数组/键值对的形式返回给前端。

      • 后端功能模块化

        使用模块化的函数和中间件实现各种功能,利于后期扩展和维护。

    • 前后端分离

      前后端开发是解耦的,可以并行进行,只需要前后端共同维护一个接口文档就可以实现前期并行开发,后期便捷集成。

  • 功能设计

  • 接口设计

1.2 架构设计

  • 界面和实现的分离

    界面是呈现给用户的界面,即为前端的设计。实现是后端对数据处理返回给前端。所以我们采用了前后端分离的做法来实现界面和实现的分离。前后端通过上述定义的api接口来进行请求发送->请求响应->返回对应数据 流程来实现。前端需要对界面进行设计,并明确自己所需要的数据;后端需对管理的数据进行整合处理,对请求的数据进行返回。

  • 错误处理

    因为我们采用了前后端分离的方法。错误会发生在前端、后端以及服务器上。

    对于前端,错误发生在界面的渲染上和一些未定义的功能行为。这一部分错误产生能在测试阶段进行捕获,并可以直接部署修改在代码上。同时在产品发布后,可以针对反馈信息来进行错误的收集。

    对于后端,错误发生在数据的处理上,包括了数据不存在,权限失败等错误行为,这里在实现阶段定义了对应的错误号,体现在对应的返回数据中,前端对于返回数据中的错误号,显示对应的错误提示信息。这些错误同样可以在测试和反馈阶段进行捕获。另一方面,有些错误是系统允许的,需要对用户的非法行为做出应对,属于程序的正常行为。

    对于服务器,错误的产生源于网络、服务器性能等多种不可抗因素,这里不再赘述处理方法。

  • 应对变化的灵活性

    首先我们前端采用了基于Vue.js的uni-app框架。Vue.js是一款从底至顶渐进式的开发框架。可以灵活地支持组件的复用。

    其次我们采用了前后端分离的模式,对于前后端通过api接口进行连接,二者相对独立。对于需求的变化可以在不影响接口的前提下在各自模块中进行修改;对于错误处理,可以按照上述方式进行灵活修改。

    最后,基于我们的团队协作原则,对于开发测试中的难题,团队里可以进行灵活协商。

1.3 测试设计

  • 单元测试

    • 前端单元测试

      由于前端使用的是基于Vue.js的uni-app框架,对此我们采用了Vue.js官方的单元测试实用工具库——Vue Test Utils。同时为了使测试尽可能覆盖全面,我们采用了以下模式进行测试:

      • 构建基于Jest的Vue单元测试环境

        Jest包含着karma + mocha + chai + sinon 的所有常用功能,相对而言Jest更加全面。这里采用Jest进行第一版的简单测试,对每一个Vue组件进行测试

      • 使用Vue Test Util 提高测试编码效率

        基于Vue Test Util丰富的官方文档及实用API开展进一步的测试,同时根据同步的DOM更新,对DOM事件的响应进行测试。

      • 对复杂场景进行测试

        目标上,争取mock掉目标组件范围外所有不好测试的模块。根据单元测试的粒度,在测试代码中插入断言。

    • 后端单元测试

      • 代码编写

        由于后端使用基于Node.js的Express框架,因此我们需要完成的后端代码包括:入口文件、路由中间件、mysql中间件、身份认证中间件。

      • 单元测试

        我们使用Express进行模块化设计与实现,因此,单元测试针对的是我们所编写的模块。

        就拿上文提到的路由中间件为例,假设我们编写了一个路由文件user.js,并且包含一个匹配路径后的http get方法:

        router.get("/",verifyRight("get/users"),async(req,res,next)=>{
        var query = req.query.query;
        var pagenum =req.query.pagenum == undefined?1:req.query.pagenum;
        var pagesize = req.query.pagesize ==undefined?5:req.query.pagesize;
        var data = {};
        let sql = `select user.id id,username,email,phone,rolename from user
        left outer join role on roleid = role.id limit ${(pagenum-1) *pagesize},${pagesize}`
        if(query !== ""){
        sql = `select user.id id,username,email,phone,rolename from user
        left outer join role on roleid = role.id where username like '%${query}%' limit ${(pagenum-1) *pagesize},${pagesize}`
        } var result = await sqlQuery(sql);
        data["users"] = result;
        data["pagenum"] = pagenum;
        sql = `select count(*) from user`
        if(query !== ""){
        sql = `select count(*) from user where username like '%${query}%' `
        } var result = await sqlQuery(sql);
        data["total"] = result[0]["count(*)"] ;
        res.json(resBody(data,1,"获取成功"))
        })

        这个路由中间件主要是进行路由匹配、权限认证、异步回调处理并返回结果等功能。

        如果我们想对这个中间件进行测试,可以借助测试框架Mocha。我们可以创建user-test工程来对user.js进行相关测试,其中包括对这个http get的测试。

        在项目工程下配置好Mocha后,我们在默认目录test下编写user-test.js的测试。

        通过在user-test.js中导入assert模块以及user.js文件的user模块,我们可以对调用所要测试的方法后res的结果进行断言,即可验证所测方法行为的正确性。

        最后,我们就可以利用Mocha运行测试了。

        通过在package.json中添加npm命令:

        {
        ... "scripts": {
        "test": "mocha"
        }, ...
        }

        然后在测试工程目录的terminal下运行命令:npm test。默认情况下,所有测试都会自动执行,最后会在命令行下显示各个测试通过与否。

  • 压力测试

    • 测试内容

      做题功能是我们“题士”产品的最核心的模块,根据目前业务的需要,我们需要测试能否支持500的并发做题量。

    • 测试场景设置

      使用类似于LoadRunner的现有工具模拟真实用户,采取逐步增加用户数(每分钟增加用户数5人)对做题功能进行并发操作,达到500人为止;当并发数达到500后则继续运行一段时间(60分钟)。

    • 服务器状态监视

      由于我们购买的是腾讯云的服务器,腾讯云为我们提供了对数据库、CPU/内存的占用率等信息,结合实际产品提供服务的情况,我们可以判断系统是否能通过压力测试。

    • 测试结果收集与分析

      由于产品后端部署环境有很多参数可以调节,例如,MySQL可以配置max_connectionsthread_cache_sizeback_log等参数,因此,我们可以收集设置不同参数下系统的状态信息与当前并发数,构造关系表格进行分析,理想情况下应该能找出并发瓶颈。

  • 真实测试

    真实测试是对我们的系统进行一系列实际使用时会遇到的真实情况的模拟。我们团队将从以下方面对真实的情况进行分类并进行测试

    • 功能测试

      • 手动测试,模拟真实用户进行功能实现与否的测试
      • 自动化测试,设计测试用例,实际上就是针对代码的单元测试。
    • 专项测试

      • 兼容性测试,使用不同设备,不同型号,不同分辨率对ui进行测试

      • 安装卸载升级测试

      • 交叉事件测试,测试考察点如下: 包含运行时接收来电/短信/消息推送, 运行时出现系统弹窗, 运行时切换外部设备等。

      • 用户体验度测试,包含:界面设计,功能易用性,横竖屏切换,系统功能响应

      • 稳定性测试通过测试工具实现在一定时间范围内的无序操作, 来检测应用的稳定运行能力, 重点在于考察应用在测试期间出现程序无响应或闪退的频率. 使用Monkey,UICrawler,Maxin

    • 客户端性能测试

      测试考察点如下: 包含CPU/内存占用, 界面流畅度, 流量/电量消耗, 启动时间等.

    • 服务端性能测试

      APP 应用的服务端性能测试可以依赖主流常见的性能测试工具来实现. 例如: LoadRunner, JMeter等.

1.4 性能分析

“题士”产品可能面临大量用户同时刷题的大数据、高并发情形。

前后端分离,对于前端的资源可以使用nginx等效率高的服务器,并且数据是在前端渲染,不是在服务端通过jsp、freemarker等渲染后返回前端,相当于把原本服务端处理的任务分散到用户端浏览器,可以很大程度的提高页面响应速度。

但是前后端分离需要解决跨域的问题,我们打算在后端进行跨域控制,摒弃session+cookie的身份认证模式,转而使用token验证方式。后端采用Node.js,因其单(主)线程、异步I/O、事件循环等技术,本身是有利于高并发的。

2.业务流程层面

2.1 用户操作

  • 输入数据

    针对产品的功能,用户在使用程序过程中产生的数据体现在以下几个方面:

    • 用户登录的账号信息

      账号信息包括账号(这里采用的是用户的手机号),密码,和手机验证码。

    • 问答社区的评论数据

      评论数据包括文字,图片。主要是用于社区中用户用于交流表达产生的可视化数据。

    • 资源社区的资源数据

      用户可以上传的数据包括上文件,图片资源,并以相关文字加以描述。

  • 支持操作

    本产品可以支持的用户操作在功能介绍中已详细说明。这里主要将用户在使用软件时的事件视为对程序的某些“输入”。例如用户的点击行为,刷新行为,滑动行为等。

2.2 异常处理

  • 针对输入数据

    • 账号表单验证及后端数据库验证

      对于登陆页面,会对填入的数据进行表达验证:不允许输入空白且不符合要求的手机号;不允许输入空白密码或者验证码。在响应登陆行为时,会在后端进行相对应的验证,以免不法登录。

    • 限制评论数据的输入

      我们设计了对应的文本框进行文本输入,同时加入上传图片功能对评论加入图片。以上行为限制了输入数据,同时对于非法格式,上传失败。

    • 限制资源上传

      类似对评论数据的限制,我们同样对上传功能进行限制。

  • 针对用户操作行为

    用户的操作行为的限制基于功能的设置。对于未定义行为不给予响应;对于权限外的行为,抛出非法权限警告;对于频繁操作的行为,抛出响应等待警告。

三、更新日志

时间 更新内容
2021-04-20 10:00 按照班级作业要求完成技术规格说明书

Alpha-技术规格说明书的更多相关文章

  1. (Alpha)Let's-技术文档(技术规格说明书)

    技术规格说明书 抽象 首先,对抽象原则的理解,“抽象”这一概念本身就很抽象.抽象体现的是一种概括能力.我们生活中遇到的很多客体,其在某些方面具备有一些相似甚至相同的性质,以这些特点而非事物本身来认识鉴 ...

  2. 【Alpha】技术规格说明书

    由于第1周已经写过技术规格说明书(设计文档),本周更新了上一版内容. Github地址:https://github.com/buaase/Phylab-Web/blob/master/docs/Ba ...

  3. 【近取 key】技术规格说明书

    项目 内容 这个作业属于哪个课程 2021春季计算机学院软件工程(罗杰 任健) 这个作业的要求在哪里 技术规格说明书 我在这个课程的目标是 进一步提升工程化开发能力,积累团队协作经验,熟悉全栈开发流程 ...

  4. [V1-Team] WEDO创意论坛技术规格说明书

    WEDO 创意论坛技术规格说明书 0x0 文档版本 版本号 说明 v1.0 初步确定技术路线 附Github仓库:WEDO 0x1 技术说明 1. 前端框架   在主流的前端框架中,我们调研了Vue. ...

  5. [软件工程基础]PhyLab 技术规格说明书

    由于暂不对后端有所改变,因此该部分技术规格说明书复用 Default 的技术规格说明书. 由于现阶段对于 Laravel 框架不熟悉,以及对于是否使用已有的轮子或者造轮子实现预想的功能还不清晰,因此暂 ...

  6. 【BUAA软工】技术规格说明书

    项目 内容 班级:北航2020春软件工程 博客园班级博客 作业:技术规格说明书 技术规格说明书 宏观技术 后端 WEB服务器 WEB服务器选取的是Springboot,作为当下Java语言最主流的WE ...

  7. [no_code]OCR表格处理——技术规格说明书

    项目 内容 这个作业属于哪个课程 2020春季计算机学院软件工程(罗杰 任健) 这个作业的要求在哪里 技术规格说明书 我们在这个课程的目标是 远程协同工作,采用最新技术开发软件 这个作业在哪个具体方面 ...

  8. Alpha阶段项目展示

    1.团队简介 韩青长 前端工程师 我是韩青长,技术小白,抱着对软工的好奇和对未来工作的憧憬选了这门课.暂时选择了测试的工作,也对开发和UI有一定兴趣.从前上帝创造了我们,现在轮到我们来创造自己的软件了 ...

  9. Alpha版本测试报告

    请根据团队项目中软件的需求文档.功能规格说明书和技术规格说明书,写出软件的测试计划.测试过程和测试结果,并回答下述问题. 1. 在测试过程中发现了多少Bug? 2. 你是怎么进行场景测试(scenar ...

  10. Alpha版本项目展示

    成员简介 谷大鑫: 热爱编程,技术狂魔,可以对感兴趣的技术钻研到茶饭不思,队伍的技术中坚.标签:整个队伍里最靠谱的人. 个人博客:http://www.cnblogs.com/nrm1/ 杨金键: 未 ...

随机推荐

  1. Intel® QAT 加速卡之IPSec示例

    Intel QAT 加速卡之IPSec示例 文章目录 Intel QAT 加速卡之IPSec示例 1. QAT处理IPSec入站报文 2. QAT处理IPSec出站报文 3. 组织架构 4. 示例源码 ...

  2. 创建 Spring容器的三种方式

    一.src路径下打包完在war包的classes层级下 1.Spring容器创建的三种方式 创建Bean容器之后创建对象: 其中第三种使用的是BeanFactory对象 2.spring通过配置文件用 ...

  3. JAVA安全基础之代理模式(一)

    JAVA安全基础之代理模式(一) 代理模式是java的一种很常用的设计模式,理解代理模式,在我们进行java代码审计时候是非常有帮助的. 静态代理 代理,或者称为 Proxy ,简单理解就是事情我不用 ...

  4. 详解C3P0(数据库连接池)

    详解C3P0(数据库连接池) 快速索引 一.基本定义 二.使用C3P0(数据库连接池)的必要性 1.JDBC传统模式开发存在的主要问题 三.数据库连接池的详细说明 四.使用连接池的明显优势 1.资源的 ...

  5. 安卓开发 利用百度识图api进行物体识别

    前文 之前的随笔中,已经通过相机或相册获取到了我们想要的图片,接下来进行识图api的配置工作.我使用的是百度的api,利用python获取信息,并在MainActivity中进行调用来输出信息. 一. ...

  6. PHP中国际化的字符串比较对象

    在 PHP 中,国际化的功能非常丰富,包括很多我们可能都不知道的东西其实都非常有用,比如说今天要介绍的这一系列的字符排序和比较的功能. 排序 正常来说,如果我们对数组中的字符进行排序,按照的是字符的 ...

  7. fibnacci数列

    斐波那契数列(Fibonacci sequence),又称黄金分割数列.因数学家列昂纳多·斐波那契(Leonardoda Fibonacci)以兔子繁殖为例子而引入,故又称为"兔子数列&qu ...

  8. fliebeat配置手册

    1.  关于Filebeat 当你要面对成百上千.甚至成千上万的服务器.虚拟机和容器生成的日志时,请告别 SSH 吧!Filebeat 将为你提供一种轻量型方法,用于转发和汇总日志与文件,让简单的事情 ...

  9. P2350-[HAOI2012]外星人【线性筛】

    正题 题目链接:https://www.luogu.com.cn/problem/P2350 题目大意 给出\(N\)质因数分解之后的结果,求每次\(N=\varphi(N)\),多少次后\(N=1\ ...

  10. P1712-[NOI2016]区间【线段树,尺取法】

    正题 题目链接:https://www.luogu.com.cn/problem/P1712 题目大意 \(n\)个区间,求出其中\(m\)个区间使得它们有覆盖同一个点且最长区间长度减去最短长度最小. ...