简介这份在线教育网系统需求分析说明书面向学校信息化建设者、软件工程专业学生及项目开发人员用于指导构建服务于校内学生的在线教育平台。文档围绕学员管理、网上教学与校园信息管理三大模块展开涵盖会员权限分配、栏目维护、教学资料上传下载、试卷制定与成绩汇总等业务场景并给出基于B/S架构的用户环境要求包括Windows 2000 Server、.Net Framework 2.0、Oracle 9i及IE6.0以上浏览器。资源包内含1个doc文件大小约2.21MB完整收录项目背景、功能清单、界面权限管理、网上教学、在线考试及用例描述等内容配有UML模型与E-R图设计说明可帮助读者理解需求分析文档的编写规范与系统建模思路。目前已有1583人学习适合作为课程设计或实际项目立项阶段的需求参考。1. 从一份需求说明书说起在线教育网系统到底该怎么落地见过太多团队拿到“在线教育网”这类项目第一反应就是打开 IDE 开始建表、拉页面结果做到一半发现权限模型没定、角色和栏目耦合死、考试系统的改卷流程来回返工。这份《在线教育网系统需求分析说明书》的价值恰恰在这里——它不是代码但它把 B/S 架构下的学员管理、网上教学、校园信息、在线考试四条业务线的边界和用例关系全部钉死了。文档基于 .Net Framework 2.0 Oracle 9i 的技术栈用 Rational Rose 画 UML、PowerDesigner 11.0 画 E-R 图面向的是学校内部学生群体采用会员制权限分配。适合谁适合正在做教育类 B/S 系统、需要一份能直接对照拆解的需求基线文档的开发者也适合想理解“需求文档怎么指导建表和接口设计”的初中级工程师。下面我按实际落地顺序把这份文档拆成能复现的步骤。2. 权限模型怎么拆从角色管理到栏目动态设置的建表逻辑2.1 为什么先做权限而不是先做页面这份文档第三部分“界面权限”里列了四组功能模块功能管理、权限设置、角色管理、栏目管理。很多人会跳过这块直接去做教学资料上传结果就是后面每加一个功能都要改一遍权限判断代码。正确的顺序是先把 RBAC 模型落成表结构再让业务模块挂上去。文档里的关系是这样的角色对模块有权限021功能模块本身可管理022角色可创建/修改/删除031-033权限设置管理又扩展了功能模块管理和角色管理。翻译成表就是五张核心表sys_module功能模块、sys_role角色、sys_role_module角色-模块权限关联、sys_column栏目、sys_column_style栏目外观样式。注意文档里“栏目管理”包含了“外观样式设置”和“栏目内容动态设置”这意味着栏目表要留出模板标识字段不能把样式硬编码在 JSP/ASPX 里。-- 功能模块表对应文档中的“模块功能管理” CREATE TABLE sys_module ( module_id NUMBER(10) PRIMARY KEY, module_name VARCHAR2(100) NOT NULL, parent_id NUMBER(10) DEFAULT 0, -- 支持树形模块结构 module_url VARCHAR2(200), -- 模块入口地址 sort_order NUMBER(5) DEFAULT 0, status NUMBER(1) DEFAULT 1 -- 1启用 0禁用 ); -- 角色表对应“角色管理”的创建/修改/删除 CREATE TABLE sys_role ( role_id NUMBER(10) PRIMARY KEY, role_name VARCHAR2(50) NOT NULL, role_desc VARCHAR2(200), create_time DATE DEFAULT SYSDATE ); -- 角色-模块权限关联对应“角色对模块的权限” CREATE TABLE sys_role_module ( id NUMBER(10) PRIMARY KEY, role_id NUMBER(10) NOT NULL, module_id NUMBER(10) NOT NULL, can_view NUMBER(1) DEFAULT 0, can_edit 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) );逻辑说明sys_module用parent_id自关联实现文档中“模块功能管理”的层级结构sys_role_module把权限粒度拆到查看/编辑/删除三个动作而不是简单一个“有无权限”字段。参数上status字段用于软禁用模块而不物理删除避免历史权限记录变成孤儿数据。Oracle 9i 下建表注意NUMBER不要用INTDATE默认值用SYSDATE。2.2 栏目动态设置与外观样式的分离文档里“栏目管理”明确拆成 041 外观样式设置和 042 栏目内容动态设置。这意味着栏目表不能只存一个标题和内容还要有一个样式模板标识。常见做法是CREATE TABLE sys_column ( column_id NUMBER(10) PRIMARY KEY, column_name VARCHAR2(100) NOT NULL, column_type NUMBER(2) NOT NULL, -- 1学校概况 2校园动态 3师资力量等 template_code VARCHAR2(50), -- 对应外观样式模板 parent_id NUMBER(10) DEFAULT 0, sort_order NUMBER(5) DEFAULT 0, status NUMBER(1) DEFAULT 1 ); CREATE TABLE sys_column_content ( content_id NUMBER(10) PRIMARY KEY, column_id NUMBER(10) NOT NULL, title VARCHAR2(200), content CLOB, -- 图文并茂内容用CLOB publish_time DATE DEFAULT SYSDATE, publisher VARCHAR2(50), CONSTRAINT fk_cc_column FOREIGN KEY (column_id) REFERENCES sys_column(column_id) );template_code是关键字段前端根据它去加载不同的展示模板这样“校园风光”和“校园动态”可以共用同一套内容表但渲染出完全不同的页面。content用CLOB而不是VARCHAR2(4000)因为文档要求“图文并茂”富文本内容很容易超长。提示Oracle 9i 中CLOB字段在SELECT时如果不加DBMS_LOB.SUBSTR处理某些旧版驱动会直接报错建议在数据访问层统一封装读取方法。3. 网上教学模块的用例落地班级、科目、教师与教学资料管理3.1 班级与教师的关联建表文档“网上教学”部分的功能清单 001 到 007 覆盖了班级科目创建、教师管理、教学资料管理、学员注册、浏览内容、提问和答疑。先看班级和教师的关系管理员创建班级和教师教师负责发布教学资料学员浏览本年级及以下年级内容。这里有个容易翻车的点——文档说“可以浏览本年级以及以下年级的教学内容”意味着年级是有序的不能只存一个年级名称字符串要有一个可比较的年级序号。-- 班级表 CREATE TABLE edu_class ( class_id NUMBER(10) PRIMARY KEY, class_name VARCHAR2(100) NOT NULL, grade_level NUMBER(3) NOT NULL, -- 年级序号用于“以下年级”判断 subject_id NUMBER(10), -- 关联科目 create_time DATE DEFAULT SYSDATE ); -- 教师表 CREATE TABLE edu_teacher ( teacher_id NUMBER(10) PRIMARY KEY, teacher_name VARCHAR2(50) NOT NULL, login_name VARCHAR2(50) UNIQUE, password VARCHAR2(100), class_id NUMBER(10), -- 所属班级 status NUMBER(1) DEFAULT 1 ); -- 教学资料表对应“教学资料管理” CREATE TABLE edu_material ( material_id NUMBER(10) PRIMARY KEY, class_id NUMBER(10) NOT NULL, subject_id NUMBER(10), material_type NUMBER(2), -- 1FLASH 2视频 3课件 file_path VARCHAR2(500), upload_teacher NUMBER(10), upload_time DATE DEFAULT SYSDATE, progress_ref NUMBER(10), -- 关联教学进度 CONSTRAINT fk_em_class FOREIGN KEY (class_id) REFERENCES edu_class(class_id) );grade_level用数字而不是字符串查询“本年级及以下”时直接WHERE grade_level :currentGrade不用做字符串比较。material_type对应文档明确列出的 FLASH 动画、视频、课件三类progress_ref对应 00301 教学进度管理把资料和进度节点绑定。3.2 学员注册与提问答疑的接口设计学员注册004和提问发表意见006、疑问解答007是三个独立用例但数据上有关联。学员提问要能定位到具体章节的教学内容教师解答要能关联到原问题。常见做法是-- 学员表 CREATE TABLE edu_student ( student_id NUMBER(10) PRIMARY KEY, student_name VARCHAR2(50) NOT NULL, login_name VARCHAR2(50) UNIQUE, password VARCHAR2(100), class_id NUMBER(10), grade_level NUMBER(3), register_time DATE DEFAULT SYSDATE ); -- 问答表 CREATE TABLE edu_qa ( qa_id NUMBER(10) PRIMARY KEY, student_id NUMBER(10) NOT NULL, material_id NUMBER(10), -- 针对哪份教学资料提问 question VARCHAR2(2000), answer VARCHAR2(2000), answer_teacher NUMBER(10), ask_time DATE DEFAULT SYSDATE, answer_time DATE, status NUMBER(1) DEFAULT 0 -- 0未解答 1已解答 );material_id把问题和具体教学内容绑定教师端按status0筛选待解答问题。这里有个参数细节question和answer用VARCHAR2(2000)而不是CLOB因为问答内容通常不会太长用CLOB反而增加查询复杂度。如果实际场景中问题会附带截图那就要额外加附件表不要硬塞进VARCHAR2。注意文档中“浏览本年级以及以下年级的教学内容”这个规则在学员登录后要把grade_level写入会话每次查询教学资料时作为过滤条件不要在前端做过滤否则接口被直接调用时会越权。4. 在线考试系统的流程实现从登录到改卷到查分4.1 题目类型与试卷生成文档“在线考试系统”功能清单里0201 手动选题和 0202 系统选题是两条不同的出题路径。手动选题是教师指定题目组成试卷系统选题是按规则随机抽题。这两种模式在数据层要统一到一张试卷表但用字段区分生成方式。-- 题库表 CREATE TABLE exam_question ( question_id NUMBER(10) PRIMARY KEY, subject_id NUMBER(10) NOT NULL, question_type NUMBER(2) NOT NULL, -- 1单选 2多选 3判断 4简答 question_text VARCHAR2(2000), option_a VARCHAR2(500), option_b VARCHAR2(500), option_c VARCHAR2(500), option_d VARCHAR2(500), correct_answer VARCHAR2(200), score NUMBER(5,1) DEFAULT 0 ); -- 试卷表 CREATE TABLE exam_paper ( paper_id NUMBER(10) PRIMARY KEY, paper_name VARCHAR2(200), subject_id NUMBER(10), create_type NUMBER(1) NOT NULL, -- 1手动选题 2系统选题 create_teacher NUMBER(10), total_score NUMBER(6,1), create_time DATE DEFAULT SYSDATE, status NUMBER(1) DEFAULT 0 -- 0未发布 1已发布 ); -- 试卷题目关联 CREATE TABLE exam_paper_question ( id NUMBER(10) PRIMARY KEY, paper_id NUMBER(10) NOT NULL, question_id NUMBER(10) NOT NULL, sort_order NUMBER(5), score NUMBER(5,1), CONSTRAINT fk_epq_paper FOREIGN KEY (paper_id) REFERENCES exam_paper(paper_id), CONSTRAINT fk_epq_question FOREIGN KEY (question_id) REFERENCES exam_question(question_id) );create_type区分手动和系统选题系统选题时按subject_id和question_type随机抽取手动选题时教师直接指定question_id列表。exam_paper_question里单独存score而不是直接用题库的score因为同一道题在不同试卷里可以赋不同分值。4.2 在线考试与改卷流程文档里 03 在线考试、0401 系统改卷、0402 教师改卷、0501 教师查分、0502 学员查分。系统改卷只适用于客观题单选、多选、判断教师改卷针对简答题。考试记录表要同时支持两种改卷状态。-- 考试记录表 CREATE TABLE exam_record ( record_id NUMBER(10) PRIMARY KEY, paper_id NUMBER(10) NOT NULL, student_id NUMBER(10) NOT NULL, start_time DATE, submit_time DATE, objective_score NUMBER(6,1) DEFAULT 0, -- 系统改卷得分 subjective_score NUMBER(6,1) DEFAULT 0, -- 教师改卷得分 total_score NUMBER(6,1) DEFAULT 0, grade_status NUMBER(1) DEFAULT 0, -- 0未改完 1已改完 CONSTRAINT fk_er_paper FOREIGN KEY (paper_id) REFERENCES exam_paper(paper_id), CONSTRAINT fk_er_student FOREIGN KEY (student_id) REFERENCES edu_student(student_id) ); -- 答题明细表 CREATE TABLE exam_answer ( answer_id NUMBER(10) PRIMARY KEY, record_id NUMBER(10) NOT NULL, question_id NUMBER(10) NOT NULL, student_answer VARCHAR2(2000), is_correct NUMBER(1), -- 客观题自动判定 got_score NUMBER(5,1) DEFAULT 0, CONSTRAINT fk_ea_record FOREIGN KEY (record_id) REFERENCES exam_record(record_id) );学员提交试卷时系统遍历exam_answer中客观题比对correct_answer自动打分写入objective_score同时把grade_status置为 0。教师改卷时只处理简答题改完后累加subjective_score把grade_status置为 1。查分接口根据grade_status决定是否显示最终成绩避免学员在教师改卷完成前就看到不完整的分数。提示Oracle 9i 下批量更新答题得分时用FORALL或BULK COLLECT比逐条UPDATE快一个数量级尤其是班级规模超过 50 人时差异明显。5. 避坑与排查这份需求文档落地时最容易翻车的五个点5.1 权限判断散落在各页面改一处漏三处现象新增一个功能模块后部分角色能看到入口但点进去报 403部分角色看不到入口但直接输 URL 能访问。原因权限判断写在了页面加载事件里而不是统一拦截器或基类里。文档中“角色对模块的权限”是一个集中式模型但实现时容易被拆散。解决在Global.asax或HttpModule里统一做 URL 到module_id的映射每次请求先查sys_role_module无权限直接跳转页面层不再重复判断。5.2 教学资料的“以下年级”规则被前端绕过现象学员通过修改浏览器地址栏参数看到了高年级的教学内容。原因年级过滤只在前端下拉框做了限制后端接口没有校验。解决学员登录时把grade_level写入Session所有教学资料查询接口强制从Session取年级不接受前端传参。文档明确写了“可以浏览本年级以及以下年级”这是业务规则不是 UI 约束。5.3 Oracle 9i 下 CLOB 字段读取报“流已关闭”现象栏目内容用CLOB存储后列表页读取正常详情页偶尔报“流已关闭”或乱码。原因Oracle 9i 的CLOB在 DataReader 中需要保持连接打开状态才能读取如果先关闭连接再取CLOB值就会失败。解决在数据访问层用OracleDataReader的GetOracleLob方法在while循环内直接读取并转成字符串不要先Close再取。或者统一用DBMS_LOB.SUBSTR(content, 4000, 1)在 SQL 层截取但超过 4000 字符的内容会截断适合列表页不适合详情页。5.4 系统选题时随机抽题导致试卷重复率过高现象同一科目多次生成试卷题目重复率超过 70%学员反馈“考来考去就这些题”。原因系统选题用了ORDER BY DBMS_RANDOM.VALUE全表随机但题库总量小的时候随机结果高度重叠。解决在exam_paper_question里记录最近 N 次已抽过的question_id生成新试卷时先排除这些题目题库不足时再降级允许重复。文档中 0202 系统选题没有规定去重策略但实际运营中这是必须补的规则。5.5 教师改卷后学员查分仍显示“未改完”现象教师已经提交了简答题分数学员端查分页面仍然显示“成绩未发布”。原因教师改卷只更新了subjective_score忘记把grade_status置为 1或者置位逻辑写在了另一个事务里没有提交。解决把改卷完成和状态更新放在同一个存储过程里用PRAGMA AUTONOMOUS_TRANSACTION不合适直接用普通事务保证原子性。查分接口同时判断grade_status1和total_score IS NOT NULL双重条件避免中间状态。6. 从需求文档到可运行系统的最后一步E-R 图校验与接口自测文档要求用 PowerDesigner 11.0 画 E-R 图很多人画完就扔一边了。我的习惯是建完表之后把 PowerDesigner 里的实体关系反过来和实际建表语句做一次比对重点看三个东西——外键是否全部落地、字段类型是否和 E-R 图一致、关联关系有没有在代码里被绕过。具体做法是打开 PowerDesigner 的物理数据模型导出建表 SQL和实际数据库的USER_TAB_COLUMNS、USER_CONSTRAINTS做 diff。Oracle 下可以这样查-- 查实际外键约束 SELECT a.table_name, a.constraint_name, a.constraint_type, b.column_name, c.table_name AS ref_table FROM user_constraints a JOIN user_cons_columns b ON a.constraint_name b.constraint_name JOIN user_constraints c ON a.r_constraint_name c.constraint_name WHERE a.constraint_type R ORDER BY a.table_name;把结果和 PowerDesigner 导出的 SQL 对比如果 E-R 图里画了关系但数据库里没有外键要么是建表时漏了要么是开发觉得“外键影响性能”手动去掉了。后者在 Oracle 9i 时代很常见但这份文档的规模校内使用、并发不高完全没必要去掉外键去掉反而容易产生脏数据。接口自测我一般按用例编号走一遍01 模块功能管理 → 02 权限设置 → 03 角色管理 → 04 栏目管理 → 001 班级科目创建 → 002 教师创建 → 003 教学资料上传 → 004 学员注册 → 005 浏览内容 → 006 提问 → 007 解答 → 01 登录 → 02 选题 → 03 考试 → 04 改卷 → 05 查分。每个用例至少测两种角色管理员/教师/学员重点测越权场景。比如用学员账号直接访问教师改卷接口看是否返回 403 而不是 500。注意文档中“学员登录”和“教师登录”是分开的用例0101、0102但实际实现时建议统一登录入口登录后根据角色跳转不同首页。分开做两个登录页会导致会话管理复杂化而且后期加“家长”角色时又要加一个登录页。从那以后我每次拿到需求说明书第一件事不是打开 Visual Studio而是先把用例编号抄到一张纸上建完表之后逐个划掉。这份在线教育网的需求文档结构清晰、用例编号完整照着走一遍能省掉大量返工。希望帮到你。本文还有配套的精品资源点击获取