简介这份在线教育网系统需求分析说明书面向学校信息化建设者、软件工程专业学生及项目开发人员用于指导构建一个基于B/S架构的在线教育平台。文档围绕学员管理、网上教学管理与校园信息管理三大模块展开详细梳理了权限设置、角色管理、栏目维护、班级与科目创建、教学资料上传下载、在线考试及成绩查询等业务功能并配有UML用例图与参与者描述明确管理员、教师、学员三类角色的行为边界。资源包内含1个doc文档大小约2.21MB内容涵盖项目背景、用户环境、功能清单与需求分析技术栈涉及.Net Framework 2.0、Oracle 9i及Rational Rose、PowerDesigner建模工具。目前已有1584人学习下载适合需要撰写需求规格说明书、开展课程设计或搭建在线教育平台的读者参考可帮助快速理解系统功能划分与用例建模思路为后续开发提供完整的需求依据。1. 在线教育网系统需求分析说明书从权限矩阵到考试用例的落地拆解很多团队做在线教育平台功能堆了一堆上线后才发现权限乱成一锅粥——学员能改试卷、教师能删班级、管理员被栏目样式卡住。翻车根源往往不在代码而在需求分析阶段没把角色、模块、用例三者关系钉死。这份《在线教育网系统需求分析说明书》就是干这个的它把学员管理、网上教学、校园信息、在线考试四条业务线拆成可编号的功能清单再用 UML 用例图和 E-R 图把参与者与操作边界画清楚。适合正在做 B/S 架构教育系统的产品、后端和测试同学尤其适合需要一份能直接对照写接口和建表的需求基线的人。它不是教程是一份带版本号、带功能编号、带用例描述的需求规格文档拿到手就能往详细设计和测试用例上映射。2. 权限与角色管理功能编号 01-04 的用例拆解与建表思路权限这块是整份说明书里最容易被低估的部分。原文把界面权限拆成模块功能管理、权限设置、角色管理、栏目管理四组每组带功能编号这不是为了好看是为了后面做 RBAC 建表时能一一对应。我一般会先把功能清单转成三张核心表角色表、模块表、角色模块关联表再把用例描述里的“扩展”关系翻译成外键约束。2.1 从用例图到 RBAC 三张表原文的用例说明里反复出现“扩展”这个词比如“权限设置管理扩展了功能模块的管理”“角色的修改和删除扩展了角色的创建”。在 UML 里这是 extend 关系落到数据库就是角色和模块之间的多对多。下面这段建表 SQL 是我按这份说明书的功能编号整理的字段名做了通用化处理Oracle 和 MySQL 都能改改就用。-- 角色表对应功能编号 03 角色管理 CREATE TABLE sys_role ( role_id NUMBER(10) PRIMARY KEY, -- 角色主键 role_name VARCHAR2(64) NOT NULL, -- 角色名称如管理员、教师、学员 role_desc VARCHAR2(256), -- 角色描述 create_time DATE DEFAULT SYSDATE, status NUMBER(1) DEFAULT 1 -- 1 启用 0 停用 ); -- 模块功能表对应功能编号 01 模块功能管理 CREATE TABLE sys_module ( module_id NUMBER(10) PRIMARY KEY, module_name VARCHAR2(64) NOT NULL, -- 模块名如网上教学、在线考试 parent_id NUMBER(10), -- 父模块支持树形栏目 module_url VARCHAR2(128), -- 前端路由或后端接口前缀 sort_no NUMBER(4) DEFAULT 0 ); -- 角色模块关联表对应功能编号 02 权限设置 CREATE TABLE sys_role_module ( id NUMBER(10) PRIMARY KEY, role_id NUMBER(10) NOT NULL, module_id NUMBER(10) NOT NULL, can_read NUMBER(1) DEFAULT 0, -- 读权限 can_write NUMBER(1) DEFAULT 0, -- 写权限 can_delete NUMBER(1) DEFAULT 0, -- 删权限 CONSTRAINT fk_rm_role FOREIGN KEY (role_id) REFERENCES sys_role(role_id), CONSTRAINT fk_rm_module FOREIGN KEY (module_id) REFERENCES sys_module(module_id) );逻辑说明角色表对应原文“角色的创建、修改、删除”模块表对应“功能模块管理”关联表对应“角色对模块的权限”。参数上can_read/can_write/can_delete三个布尔位是我从原文“权限设置管理包含了对角色对模块的权限”这句推出来的最小粒度如果你们学校要求更细可以再加can_export、can_audit字段。parent_id是为了支撑原文“栏目管理”里的树形结构栏目外观样式设置可以另开一张sys_column_style表不要和权限表混在一起。2.2 用例描述里的参与者边界怎么落到接口原文对每个用例都标了参与者管理员、教师、学员。这三类人在接口层必须用不同的鉴权中间件。常见做法是登录时把role_id写进 token网关层根据module_url和sys_role_module做拦截。比如“学员可以浏览本年级以及以下年级的教学内容教师或管理员不受限制”这条就不能简单用角色判断还要在业务层加年级字段的比较。# 伪代码基于角色模块关联表的接口鉴权 def check_permission(user, module_url, action): # user 里带 role_id从 token 解析 rows query( SELECT can_read, can_write, can_delete FROM sys_role_module rm JOIN sys_module m ON rm.module_id m.module_id WHERE rm.role_id %s AND m.module_url %s, (user.role_id, module_url) ) if not rows: return False perm rows[0] if action read: return perm.can_read 1 if action write: return perm.can_write 1 if action delete: return perm.can_delete 1 return False参数说明module_url建议和前端路由保持一致比如/exam/paper/manual对应“手动选题”。这样新增模块时只需要在sys_module插一条记录再给角色勾权限不用改代码。注意原文里“教师或管理员不受限制”这种例外不要硬编码在鉴权函数里应该作为业务规则放在 service 层否则后面加一个“助教”角色就会翻车。3. 网上教学与考试系统教学资料、选题、改卷的流程还原网上教学和在线考试是这份说明书里功能点最密的两块。原文把教学资料管理拆到“FLASH 动画、视频、课件”把考试拆到“手动选题、系统选题、系统改卷、教师改卷、查分”。这些不是随便列的它们决定了文件存储方案和判分引擎的复杂度。3.1 教学资料上传下载的存储与进度绑定原文用例 003 提到“根据教学进度和节次的需求科目发布教学资料”这句话里藏了一个关键设计资料不是孤立挂在课程下的而是绑定到“教学进度”这个维度。我一般会设计成三层课程 → 进度节点 → 资料。资料表里存文件路径和类型不存二进制。-- 教学资料表对应功能编号 003 CREATE TABLE teach_material ( material_id NUMBER(10) PRIMARY KEY, course_id NUMBER(10) NOT NULL, -- 所属科目 progress_id NUMBER(10) NOT NULL, -- 教学进度节点 material_name VARCHAR2(128) NOT NULL, material_type VARCHAR2(16), -- flash/video/ppt/doc file_path VARCHAR2(256) NOT NULL, -- 服务器存储路径 upload_user NUMBER(10), -- 上传教师ID upload_time DATE DEFAULT SYSDATE, download_cnt NUMBER(10) DEFAULT 0 );参数说明material_type用短字符串而不是数字枚举方便前端直接判断渲染方式。file_path建议按course_id/progress_id/分目录避免单目录文件过多导致 IO 慢。原文提到“上传下载配套教学资料”下载计数download_cnt可以在每次下载时UPDATE ... SET download_cnt download_cnt 1但高并发下会有锁竞争常见做法是走 Redis 计数再定时回写。3.2 手动选题与系统选题的组卷策略差异原文功能清单里 0201 手动选题、0202 系统选题这两条对应完全不同的组卷逻辑。手动选题是教师勾题系统选题是按题型和难度随机抽题。下面这段 Python 伪代码展示系统选题的核心逻辑手动选题只需要把随机抽取换成按question_id列表查询。import random def auto_generate_paper(question_bank, rule): question_bank: 题目列表每题带 type 和 difficulty rule: 组卷规则如 {single: 10, multi: 5, judge: 5} paper [] for q_type, count in rule.items(): candidates [q for q in question_bank if q[type] q_type] if len(candidates) count: raise ValueError(f题库中 {q_type} 题型不足需要 {count} 道实际 {len(candidates)} 道) # 按难度分层抽取避免全抽到简单题 random.shuffle(candidates) paper.extend(candidates[:count]) return paper逻辑说明rule字典的 key 是题型value 是抽题数量。参数上random.shuffle之前建议先按难度排序再分层抽样否则系统选题容易变成“随机但偏简单”。原文提到“教师根据题目类型手工生成试卷”手动选题接口应该接收question_ids数组并在保存前校验题目是否属于当前科目防止跨科目组卷。3.3 系统改卷与教师改卷的判分边界原文把改卷拆成 0401 系统改卷和 0402 教师改卷这个拆分很关键。客观题走系统改卷主观题必须留给教师。我一般会在试卷表里加一个need_manual标志交卷后先跑自动判分再把主观题推给教师批改队列。-- 答卷表记录学员作答和判分状态 CREATE TABLE exam_answer ( answer_id NUMBER(10) PRIMARY KEY, paper_id NUMBER(10) NOT NULL, student_id NUMBER(10) NOT NULL, question_id NUMBER(10) NOT NULL, answer_content CLOB, -- 学员答案 score NUMBER(5,1), -- 得分 judge_type NUMBER(1), -- 1 系统改卷 2 教师改卷 judge_status NUMBER(1) DEFAULT 0, -- 0 待判 1 已判 judge_user NUMBER(10) -- 改卷教师ID );参数说明judge_type在交卷时根据题型自动写入客观题写 1主观题写 2。judge_status用于教师批改队列的筛选。注意原文“分数汇总优良登记评分”这条汇总逻辑不要放在答卷表里做应该单独建一张成绩汇总表按paper_id student_id聚合否则每次查分都要扫全表。4. 避坑与排查需求说明书落地时最容易翻车的五个点这份说明书本身写得算细但真正拿它去开发有几个地方如果不提前处理后面返工成本很高。下面五条是我在类似项目里踩过的坑按现象、原因、解决来写。现象一权限表建好了但教师登录后看不到“网上教学”菜单。原因sys_module里模块的module_url和前端路由不一致鉴权时匹配不上。解决在模块表里加一个front_route字段和module_url分开维护前端菜单渲染用front_route后端鉴权用module_url两边通过module_id关联。现象二学员能浏览高年级教学内容。原因原文写的是“浏览本年级以及以下年级”但代码里只判断了角色没判断年级。解决在教学内容查询接口里加grade_id user.grade_id条件教师和管理员角色跳过这个条件。这个逻辑不要写在 SQL 的 where 里硬编码用策略模式按角色拼条件。现象三系统选题组卷时偶尔报“题目不足”。原因题库里题目数量够但按题型和难度分层后某一层不够。解决组卷规则里增加“降级策略”比如某难度题目不足时自动从相邻难度补并在返回结果里标记fallbacktrue让教师知道哪些题是降级抽取的。现象四教学资料上传大视频后下载计数更新很慢。原因每次下载都直接UPDATE数据库大文件下载并发高时行锁等待。解决下载计数走 RedisINCR每 100 次或每 5 分钟回写一次数据库。注意回写时要加download_cnt download_cnt ?不要用SET覆盖。现象五E-R 图用 PowerDesigner 画完导出 SQL 后字段类型和 Oracle 9i 不兼容。原因PowerDesigner 默认可能生成VARCHAR而不是VARCHAR2NUMBER精度也可能不对。解决在 PowerDesigner 的 DBMS 设置里选 Oracle 9i 模板导出前检查CLOB和DATE类型。原文指定 Oracle 9i这个版本对VARCHAR2最大 4000 字节教学资料描述字段别超。提示原文用户环境写的是 Windows 2000 Server .NET Framework 2.0 IE6.0这是很早期的技术栈。如果现在要复现建议把服务端换成 .NET 6 或 Java Spring Boot数据库至少 Oracle 11g 或 MySQL 8浏览器兼容性不用再管 IE6但需求分析里的角色和用例逻辑可以原样保留。5. 从需求说明书到可运行原型用功能编号驱动测试用例这份说明书最大的价值不是让你照着写代码而是让你在写代码之前把边界想清楚。我习惯把功能编号直接映射成测试用例编号比如 021 对应“角色对模块的权限”的测试031 对应“创建角色”的测试。这样需求、开发、测试三条线用同一套编号谁漏了功能一眼就能看出来。具体做法是先把原文功能清单里的每个编号抄进测试管理工具一个编号至少写三条用例——正常流程、权限不足、边界数据。比如 0202 系统选题正常流程是抽够题权限不足是学员调教师接口边界数据是题库刚好差一道题。下面这张表是我按原文功能编号整理的测试覆盖对照可以直接改成你们团队的模板。功能编号功能名称测试重点对应接口01模块功能管理模块树增删改、父子关系/module/tree021角色对模块的权限勾选/取消权限后接口拦截/role/module/bind031创建角色角色名重复、空值/role/create003教学资料管理上传类型限制、进度绑定/material/upload0201手动选题跨科目选题拦截/paper/manual0202系统选题题量不足降级/paper/auto0401系统改卷客观题判分准确性/exam/auto-judge0402教师改卷主观题分数录入范围/exam/manual-judge验证方法上我一般会先跑一遍“管理员建角色 → 给角色勾模块 → 用该角色登录 → 访问未授权模块”这条链路如果拦截生效说明权限表设计没问题。再跑“教师上传资料 → 绑定进度 → 学员按年级浏览”这条链路验证教学资料和年级过滤。最后跑“学员交卷 → 系统改卷 → 教师改主观题 → 学员查分”这条链路验证判分状态流转。三条链路都通了这份需求说明书才算真正落地。从那以后我每次拿到类似的需求分析文档都强制自己先把功能编号抄进测试用例表再开始画 E-R 图。编号对不上后面一定出乱子。希望帮到你。本文还有配套的精品资源点击获取