写点什么

模块三 架构文档

作者:Asha
  • 2021 年 11 月 13 日
  • 本文字数:4816 字

    阅读完需:约 16 分钟

前言

[可选,用于总体上描述本篇文档的内容和目的]

本文是学生管理系统详细架构设计文档,用于指导后续的开发,测试和运维


词汇表

[可选,用于明确定义和说明一些英文缩写、术语等,请用表格来呈现,infoq 写作平台不支持表格,所以只能一个一个的列]


1. 业务背景


[必选,从以下常见的角度来回答,你准备构建或者重构系统的目的和所处的位置是什么,可以是 1 个角度,也可以是多个角度,一般挑选重点的 3 个目的就差不多了:1.解决什么问题;2.带来什么价值;3.实现什么目标;4.完成什么任务;5.处于什么地位。

]

[样例:

随着前浪微博业务的不断发展,业务上拆分的子系统越来越多,目前系统间的调用都是同步调用,由此带来几个明显的系统问题:

  • 性能问题:当用户发布了一条微博后,微博发布子系统需要同步调用“统计子系统”“审核子系统”“奖励子系统”等共 8 个子系统,性能很低。

  • 耦合问题:当新增一个子系统时,例如如果要增加“广告子系统”,那么广告子系统需要开发新的接口给微博发布子系统调用。

  • 效率问题:每个子系统提供的接口参数和实现都有一些细微的差别,导致每次都需要重新设计接口和联调接口,开发团队和测试团队花费了许多重复工作量。

基于以上背景,我们需要引入消息队列进行系统解耦,将目前的同步调用改为异步通知。

]

随着学校的规模的不断扩大,学生数量的增加,需要处理的信息也日趋增大。不仅花费大量的教师资源, 处理效率也十分低下。 为提高学生管理的管理水平,优化资源,尽可能降低管理成本成为学生管理的新课题,学生管理系统是从 学生管理现状出发,根据学生管理的新要求进行开发设计的,它需要解决学生信息管理数据信息量大修改 不方便,对一系列数据进行分析时花费时间长等问题,帮助学生管理人员有效管理学生信息。 因此学生信息管理系统可以通过系统规范化地管理、科学性统计和快速查询、修改、增加、删除等,提高 信息的准确度以及日常管理的工作效率。

本系统主要是应用于学生各类信息的管理,总体任务是实现学生信息关系的系统化、规范化、自动化,其 主要任务是统计学生各类信息进行日常管理,如查询、修改、增加、删除、以及学生选课、成绩的查询等 功能设计的管理系统。系统边界图如下:

[技巧:使用系统边界黑盒图来描述系统与外界的边界和交互关系]


2. 约束和限制

[必选,列出明确的约束和限制,常见的约束和限制有:1.投资方的成本要求;2. 监管方的监管要求;3. 技术选型的硬性要求;4. 项目时间要求;5. 质量要求]

[样例:

1.必须在 2021.06.30 号完成

2.成本不能超过 1000 万

3.数据库采用 Oracle

4.质量标准符合 ISO9001-XXXX 标准

]

[技巧:约束和限制越多越好]

  1. 后端使用 java

  2. 数据库使用 mysql, 并有备份机制

  3. 必须在 2022.03.30 号完成


3. 总体架构

[必选,描述经过备选架构决策后定下来的架构方案,这一章主要是描述架构的 3R:Rank、Role、Relation]

[技巧:1. 系统边界白盒图描述系统内的角色与外界的交互(Rank + Role + 外部 Relation);2. 系统架构图来描述内部的 Role + 内部 Relation]

[注意:不建议一张图同时描述系统架构的 3R 以及与外界的交互,因为图太复杂,画系统边界白盒图的时候,系统内部的 Relation 可以不画]


3.1 架构分析

[可选,这部分主要是架构复杂度的分析,基本上从备选架构文档中提炼关键内容过来即可]

[样例:

3.1.1 高可用

对于微博子系统来说,如果消息丢了,导致没有审核,然后触犯了国家法律法规,则是非常严重的事情;对于等级子系统来说,如果用户达到相应等级后,系统没有给他奖品和专属服务,则 VIP 用户会很不满意,导致用户流失从而损失收入,虽然也比较关键,但没有审核子系统丢消息那么严重。

 

综合来看,消息队列需要高可用性,包括消息写入、消息存储、消息读取都需要保证高可用性。

]

[技巧:常见的复杂度都要覆盖到,即使分析后不涉及也要描述,避免评审的时候被人认为遗漏了关键点]

高可用:如果系统临时宕机,一般不会有什么影响,所以不需要考虑高可用

高性能:单个学校的管理系统,不需要高可用

可扩展:业务目前不会增长。

安全:不涉及数据安全,不需要考虑安全

成本:无需考虑

可维护:由甲方维护,无需考虑


3.2 总体架构

[必选,描述总体架构设计]

[样例:此处省略架构图,文字描述样例:

1)采用数据分散集群的架构,集群中的服务器进行分组,每个分组存储一部分消息数据。

2)每个分组包含一台主 MySQL 和一台备 MySQL,分组内主备数据复制,分组间数据不同步。

3)正常情况下,分组内的主服务器对外提供消息写入和消息读取服务,备服务器不对外提供服务;主服务 4)器宕机的情况下,备服务器对外提供消息读取的服务。

5)客户端采取轮询的策略写入和读取消息。

]

[技巧:

1.用系统架构图来描述架构,如果是前端或者客户端,用前端架构图或客户端架构图来描述架构

2.基于架构图中的内容,使用文字描述 Role、Relation 的基本内容,文档目录可以自由调整

]

服务端 role 设计:后端分为学生子系统,课程子系统,权限子系统,系统之间使用接口进行交互

MySQL role 和 relation: 采用 MySQL 主备,直接使用 MySQL 主从进行复制


4. 详细设计

[必选,描述核心场景或者流程的实现机制]


4.1 核心功能

[必选,描述核心场景或者流程的实现机制,对应 4R 架构中的 Rule,每个核心场景一个小节]

[样例:

4.1.1 消息发送流程

4.1.2 消息消费流程

]

[技巧:使用系统序列图来描述 Rule,跟项目开发中写设计文档一样的写法]

a、学生管理

1. 系统登录:此功能面向所有用户角色,根据用户角色权限不一,功能权限也不一样。 2. 账号分配:学生账号由系统生成,给定相应权限,可进行密码更改,无法对系统成绩评定等功能做出相应干 涉。教师账号由管理者(教务)通过系统生成,教师有对学生成绩评定和试卷评定的权限,同时兼容学生权 限。管理(教务)权限由系统固有账号,是系统 root 权限,对教师有分配管理权限,对数据有增加、修改、 删除、查询权限。 3. 账号绑定:学生账号可通过第三方如:手机号码、微信等自行绑定,可实现账号自助找回等。 4. 组织管理层级:按学生实际情况划分归属。 例如:软件学院—数字传媒方向(专业)—软件 1306—苗雨 乔。 5. 文件上传/下载:此功能针对所有用户开放,学生可以将自己课堂笔记、日常作业等相关信息在线传输,教 师通过学生上传的相关作业、试卷信息进行相应评定,完成对学生平时成绩的评定。此功能一旦评定结束,所 有用户只有查询、浏览的权限,除管理员外其他用户没有对成绩修改的权限。 6. 信息查询:此项功能包含课程查询(含课程体系、课时安排、课表、教师、教材等)、成绩查询、文件查 询。

b、课程管理

1. 课程录入:由管理员对相应课程体系进行录入,供学生、教师进行在线选择。 2. 选课功能:学生可以在线对自己的课程体系进行选择,相对应的课程选择功能类比。 3. 排课功能:此功能根据学生选定的课程和教学体系安排,对相应教师、教室、时间进行统一规划安排。 排课功能备选开发方向为在线排课和人工录入,在线排课是系统根据课程要设置课程的名称、课时、上课 的班级、代课老师等信息,除此之外,还可以选填排课时的优选项,例如:上课时间有限上午等系统自动 生成课程信息,管理员有权限对课程安排作出添加、删除、修改等判定。 4. 教材选择:此功能由教务统一管理,根据每门课程选定相应教材.

c、考试管理

1. 试卷区域分割:发起考试:期中的时候,教师可以创建一次考试;而在月考时可以根据上课的周数进行考 试安排,如一般可以在在第八周、十二周、十六周分别创建三次考试。其中这些考试题目是在事先录入好的 题库中按照教师设定的知识点、范围、难易程度以及题型自动生成的试卷。每创建一次考试之后,教师需要 将出好的考试题进行分割点标注,然后印刷试卷,考试。考试过后,试卷会被扫描,然后教师需要将扫描件 试卷录入系统之中,系统会根据标注点对试卷进行预处理和分割。教师进入系统,可以对已经分割好的试卷 进行判分。 2. 平时成绩:此项功能包含学生平时所有相关成绩信息,例如:考勤主要是由教师终端自动生成的或者教师 手动输入,时间期限为当天;课堂笔记主要是由学生在当堂课程结束后将自己的笔记上传然后由教师批阅给 予成绩在下次上课前完成自动签名;课后作业主要是在每堂课之后,教师可以发起一次作业任务,学生应老 师设定的时间内提交作业,老师会对作业进行批阅,在下次课前给予成绩评分,将以上方式计算得到的总成 绩计入平时成绩。最后按照系统判定的平时成绩结合月考、期中、期末试卷成绩按相应比例得出学生最终成 绩。 3. 评分判定:教师使用系统对上传的试卷分割区域作出相应的评分。由于教师要对试卷进行签字,我们建 议教师在评分之前可以在试卷上进行签字,由此得到的扫描结果就有教师签字。如有额外需求,需要教师通 过外设进行试卷签字,此项功能暂不做需求开发。

d、权限管理

1. 系统使用者有学生、教师、管理员、辅导员。 2. 学生、教师、辅导员可以注册、登录、修改自己的信息,但注册信息需要管理员审核通过。 3. 学生只能查看自己的成绩,教师可以修改学生的成绩。 4. 辅导员可以查看学生的信息,可以设置学生的奖惩信息。 5. 教师可以上传考试试题,学生可以做题。


4.2 关键设计

[必选,描述系统的一些关键设计点是如何实现和取舍的]

[样例(如果你有兴趣,可以对比一下 kafka 的文档:Kafka design):

1)消息发送可靠性

业务服务器中嵌入消息队列系统提供的 SDK,SDK 支持轮询发送消息,当某个分组的主服务器无法发送消息时,SDK 挑选下一个分组主服务器重发消息,依次尝试所有主服务器直到发送成功;如果全部主服务器都无法发送,SDK 可以缓存消息,也可以直接丢弃消息,具体策略可以在启动 SDK 的时候通过配置指定。

如果 SDK 缓存了一些消息未发送,此时恰好业务服务器又重启,则所有缓存的消息将永久丢失,这种情况 SDK 不做处理,业务方需要针对某些非常关键的消息自己实现永久存储的功能。

2)消息存储可靠性

消息存储在 MySQL 中,每个分组有一主一备两台 MySQL 服务器,MySQL 服务器之间复制消息以保证消息存储高可用。如果主备间出现复制延迟,恰好此时 MySQL 主服务器宕机导致数据无法恢复,则部分消息会永久丢失,这种情况不做针对性设计,DBA 需要对主备间的复制延迟进行监控,当复制延迟超过 30 秒的时候需要及时告警并进行处理。

3)消息如何存储

每个消息队列对应一个 MySQL 表,消息队列名就是表名,表结构设计为……(此处请自行补充)

]

[技巧:常见的关键设计点包括高性能、高可用、可扩展、安全等]

数据存储可靠性

学生信息存储在 MySQL 中,有一主一备 MySQL 服务器,MySQL 服务器之间复制消息以保证消息存储高可用。如果主备件出现复制延迟,恰好此时 MySQL 主服务器宕机导致数据无法恢复,则部分消息会永久丢失,这种情况不做针对性设计,DBA 需要对著备件的复制延迟进行监控,当复制延迟超过 30s 的时候需要即时告警并进行处理。

业务场景

分别建立考试子系统,学生子系统,课程子系统,有助于组内同事协助


4.3 设计规范

[必选,描述 Role 和 Relation 相关的开发框架、连接协议、数据包格式等]

[样例:

1)消息队列服务器使用 Spring Boot + Netty 开发

2)MySQL 使用 Innodb 存储引擎

3)TCP 包的结构设计……(此处省略,请自行补充)

]

[技巧:如果某个规范涉及内容比较多,请独立章节描述,例如数据包格式定义]

1、Mysql 使用 Innodb 存储引擎。

2、开发框架使用 springboot2.5.2。

3、系统间通信使用 Http 协议。

4、通信数据格式使用 Json。

5. 质量设计

[必选,描述和质量相关的设计,包括:可测试性、可维护性、可观测性、成本等设计]

[样例:

5.1 消息队列管理后台

5.2 成本

]

[技巧:如果某个维度不涉及,也请在文档中说明,避免评审的时候被认为考虑不周全]

可测试性:无

可维护性:由甲方维护,不需要考虑可维护性

成本:无需考虑成本


6. 演进规划

[必选,可以是演进规划,也可以是项目计划,需要描述每个里程碑或者版本具体要实现的能力]

[样例:

6.1 消息队列一期

6.2 消息队列二期

]

[技巧:开发阶段快速迭代,小步快跑,但要基本完善后才能正式推出给其他人用]

用户头像

Asha

关注

还未添加个人签名 2019.12.26 加入

还未添加个人简介

评论

发布
暂无评论
模块三 架构文档