企业官网建设流程全解析

简介：本资源是一份完整的在线教育平台项目需求分析说明书，面向IT系统分析师、软件开发工程师及高校计算机专业师生，用于指导B/S架构在线教育系统的规划与开发。文档覆盖项目背景、功能模块（学员管理、网上教学、校园信息、在线考试）、用户环境（Windows 2000 Server + .NET 2.0 + Oracle 9i + IE6+）、权限体系（角色/栏目/模块三级管理）及UML/E-R建模规范（Rational Rose、PowerDesigner 11.0），具备强工程落地性与教学参考价值。压缩包为单文件DOC格式，大小2.21MB，结构清晰、用例详实，含多张用例图与功能编号清单，便于快速定位权限配置逻辑、教学资料管理流程及在线考试全流程设计。目前已有1584人学习下载，是理解传统教育信息化系统需求建模的典型范例。

1. 这不是模板套话：一份能直接驱动开发的在线教育网需求说明书，为什么它比90%的“需求文档”更值得你花20分钟细读？

你有没有遇到过这样的情况：开发团队拿到一份《XX系统需求说明书》，翻了三页就卡在“角色权限管理”那段模糊描述上——“支持灵活配置”“满足多级权限控制”“兼顾安全性与易用性”……然后项目经理开始循环提问：“到底几个角色？”“菜单栏谁能看到？”“学生能不能删自己提的问题？”最后所有人对着Word文档干瞪眼，会议开了两小时，结论是“下周再对一版”。这份《在线教育网系统需求分析说明书》不是那种。它用编号到042的颗粒度拆解栏目管理，用021/022/023明确区分“角色对模块的权限”“功能模块管理”“角色的管理”三个正交能力，甚至把“教师改卷”和“系统改卷”拆成0401与0401（原文此处编号重复，但功能边界清晰）——这不是文字游戏，是开发时能直接映射到数据库表字段、API接口名、前端路由守卫的硬约束。它诞生于某高校真实教学场景迭代中，目标很土但很实：让老师不用培训就能上传课件，让学生点三次以内找到上周数学测验答案，让教务员改个“校园动态”栏目样式不需重启服务。如果你正在启动一个B/S架构的校内教育平台，或需要给外包团队交付不可争议的需求基线，这份文档不是参考，是开工令。

2. 从用例编号到代码字段：如何把“021角色对模块的权限”翻译成可落地的权限模型

需求文档里最常被跳过的其实是编号体系。这份说明书里所有功能编号都不是随意编排：02开头的权限相关功能（021/022/023）、003开头的教学资料管理（00301特指教学进度联动），这种结构本身就是领域建模的线索。我们来把它焊接到真实技术实现上。

2.1 权限模型设计：为什么RBAC不够用，必须加一层“模块-功能”二维矩阵

很多团队看到“角色管理”就直接套用RBAC（基于角色的访问控制），结果上线后发现：管理员想让“年级组长”能删本年级公告但不能删全校通知，而RBAC里“年级组长”角色一旦赋予“删除公告”权限，就全局生效。这份说明书用021编号明确切出“角色对模块的权限”，本质是要求模块级权限控制（Module-Level ACL）。正确做法是建立三张核心表：

-- 模块表：对应说明书中的"模块功能管理"（01） CREATE TABLE sys_module ( id VARCHAR(32) PRIMARY KEY, code VARCHAR(50) NOT NULL UNIQUE, -- 如 'STUDENT_MANAGE', 'EXAM_SYSTEM' name VARCHAR(100) NOT NULL, -- 如 '学员管理', '在线考试系统' parent_id VARCHAR(32), -- 支持树形模块（如'在线考试系统'下有'试卷管理'） sort_order INT DEFAULT 0 ); -- 功能点表：对应说明书中的"功能模块管理"（022） CREATE TABLE sys_function ( id VARCHAR(32) PRIMARY KEY, module_code VARCHAR(50) NOT NULL, -- 关联sys_module.code code VARCHAR(50) NOT NULL, -- 如 'CREATE_CLASS', 'UPLOAD_COURSEWARE' name VARCHAR(100) NOT NULL, -- 如 '创建班级', '上传教学资料' http_method VARCHAR(10), -- GET/POST/DELETE，用于API鉴权 uri_pattern VARCHAR(200), -- 如 '/api/class', '/api/courseware/upload' CONSTRAINT uk_module_func UNIQUE (module_code, code) ); -- 角色-功能权限表：对应说明书021"角色对模块的权限" CREATE TABLE sys_role_function ( role_id VARCHAR(32) NOT NULL, function_id VARCHAR(32) NOT NULL, enabled TINYINT DEFAULT 1, -- 1=启用，0=禁用（比删记录更安全） PRIMARY KEY (role_id, function_id), FOREIGN KEY (function_id) REFERENCES sys_function(id) );

提示：sys_function.uri_pattern字段是关键。说明书里“在线考试系统”包含“登录”（0101）、“手工选题”（0201）等子功能，每个都应有独立URI。不要把所有考试接口塞进/api/exam/*，否则权限控制会退化为粗粒度开关。

2.2 栏目管理的动态性：如何实现“042栏目内容动态设置”而不写死前端

说明书04节“栏目管理”要求支持“图文并茂的信息管理”，且能“增加、修改、删除”。新手常犯的错误是为每个栏目（如“校园风光”“名师风范”）单独建表。正确做法是抽象出通用栏目内容模型：

-- 栏目类型表：定义栏目骨架（对应041外观样式设置） CREATE TABLE cms_column_type ( id VARCHAR(32) PRIMARY KEY, code VARCHAR(50) NOT NULL UNIQUE, -- 如 'IMAGE_TEXT', 'VIDEO_LIST' name VARCHAR(100) NOT NULL, -- 如 '图文混排', '视频列表' template_path VARCHAR(200) NOT NULL -- 前端组件路径，如 '/components/ImageText.vue' ); -- 栏目实例表：具体栏目（如“校园风光”是IMAGE_TEXT类型的一个实例） CREATE TABLE cms_column ( id VARCHAR(32) PRIMARY KEY, type_code VARCHAR(50) NOT NULL, -- 关联cms_column_type.code title VARCHAR(100) NOT NULL, -- 如 '校园风光' description TEXT, sort_order INT DEFAULT 0, status TINYINT DEFAULT 1, -- 0=下线，1=上线 FOREIGN KEY (type_code) REFERENCES cms_column_type(code) ); -- 栏目内容表：存储具体数据（对应042内容动态设置） CREATE TABLE cms_column_content ( id VARCHAR(32) PRIMARY KEY, column_id VARCHAR(32) NOT NULL, -- 所属栏目 content_type ENUM('TEXT','IMAGE','VIDEO','LINK') NOT NULL, content_data TEXT NOT NULL, -- JSON格式，如 {"url":"/img/campus1.jpg","caption":"主教学楼"} sort_order INT DEFAULT 0, FOREIGN KEY (column_id) REFERENCES cms_column(id) );

这样，当教务员在后台新增一个“体育项目”栏目时，只需在cms_column插入一行，选择type_code='IMAGE_TEXT'，前端自动加载/components/ImageText.vue组件渲染；后续增删图文内容，只操作cms_column_content表，完全不碰代码。

2.3 教学资料管理的版本陷阱：为什么00301“教学进度管理”必须绑定课程节点

说明书00301要求“根据教学进度和节次的需求，科目发布教学资料”。这里藏着一个典型坑：如果只建一张courseware表存文件，当老师更新“高一数学第一章”课件时，已学习该章节的学生看到的还是旧版。必须引入教学进度节点（Lesson Node）概念：

-- 课程大纲表（静态结构） CREATE TABLE curriculum_outline ( id VARCHAR(32) PRIMARY KEY, subject VARCHAR(50) NOT NULL, -- 'Mathematics' grade_level VARCHAR(20) NOT NULL, -- 'Grade10' version VARCHAR(20) NOT NULL -- '2024-Spring' ); -- 教学节点表（动态进度，对应00301） CREATE TABLE lesson_node ( id VARCHAR(32) PRIMARY KEY, outline_id VARCHAR(32) NOT NULL, -- 关联大纲 node_code VARCHAR(50) NOT NULL, -- 'MATH10-CH1-SEC1'，唯一标识节点 title VARCHAR(100) NOT NULL, -- '集合的概念' sequence INT NOT NULL, -- 在章节内的序号 start_date DATE, -- 计划开始日期 FOREIGN KEY (outline_id) REFERENCES curriculum_outline(id) ); -- 教学资料与节点绑定（解决版本问题） CREATE TABLE courseware_node_link ( courseware_id VARCHAR(32) NOT NULL, node_id VARCHAR(32) NOT NULL, version_tag VARCHAR(20) NOT NULL, -- 'v1.0', 'v1.1'，每次更新生成新tag is_current TINYINT DEFAULT 0, -- 1=当前有效版本，一个node_id只有一条is_current=1 PRIMARY KEY (courseware_id, node_id, version_tag), FOREIGN KEY (courseware_id) REFERENCES courseware(id), FOREIGN KEY (node_id) REFERENCES lesson_node(id) );

当老师更新课件时，系统生成新version_tag并置is_current=1，旧记录is_current=0。学生查看“集合的概念”时，后端查lesson_node得到node_id，再查courseware_node_link中is_current=1的记录，自然获取最新版——这才是00301“根据教学进度发布”的工程实现。

3. 避坑指南：那些在说明书里没写明、但上线前必踩的5个血泪坑

需求文档不会告诉你“哪里会翻车”，但一线工程师必须预判。以下5个坑，全部来自某高校在线教育平台真实上线过程，每个都导致过至少1天的紧急回滚。

3.1 现象：IE6浏览器下“在线考试”页面按钮点击无响应

原因：说明书要求客户端“IE6.0或以上”，但IE6不支持addEventListener，而前端考试系统用了现代JS框架的事件绑定。更致命的是，IE6的XMLHttpRequest对象名是ActiveXObject("Microsoft.XMLHTTP")，而非标准XMLHttpRequest。
解决：在入口JS中强制注入兼容层：

// 兼容IE6的XMLHttpRequest封装 if (!window.XMLHttpRequest && window.ActiveXObject) { window.XMLHttpRequest = function() { return new ActiveXObject("Microsoft.XMLHTTP"); }; } // 按钮事件绑定必须用attachEvent而非addEventListener if (document.getElementById('submitBtn').attachEvent) { document.getElementById('submitBtn').attachEvent('onclick', handleExamSubmit); } else { document.getElementById('submitBtn').addEventListener('click', handleExamSubmit); }

注意：不要试图用Babel转译ES6代码来兼容IE6——Babel只处理语法，不处理DOM API缺失。必须手写兼容逻辑。

3.2 现象：Oracle 9i数据库中“试卷管理”查询超时，执行计划显示全表扫描

原因：说明书未指定数据量级，但实际运行中试卷表（exam_paper）达10万行。WHERE status='published' AND subject='Mathematics'查询未建复合索引，且Oracle 9i对VARCHAR2字段的索引长度限制为30字节，subject字段设为VARCHAR2(100)导致索引失效。
解决：重建索引并约束字段长度：

-- 删除原无效索引 DROP INDEX idx_exam_paper_status; -- 创建符合Oracle 9i限制的复合索引（subject前30字符足够区分学科） CREATE INDEX idx_exam_paper_status_subj ON exam_paper(status, SUBSTR(subject,1,30)); -- 同时修改表结构，避免未来插入超长学科名 ALTER TABLE exam_paper MODIFY subject VARCHAR2(30);

3.3 现象：教师用“手工选题”（0201）生成试卷时，随机抽题结果重复率高达40%

原因：说明书只要求“手工选题”，未定义“手工”的语义。开发理解为“教师从题库勾选题目”，但实际业务中教师需要“从指定知识点范围随机抽取N道题”，而题库表question_bank缺少knowledge_point字段，导致只能按ID随机取，同一知识点题目物理相邻造成重复。
解决：紧急补全知识维度，并重写抽题逻辑：

-- 为题库添加知识点字段（允许逗号分隔多个知识点） ALTER TABLE question_bank ADD knowledge_points VARCHAR2(200); -- 抽题SQL改为按知识点分组随机（Oracle 9i语法） SELECT * FROM ( SELECT q.*, ROW_NUMBER() OVER (PARTITION BY q.knowledge_points ORDER BY DBMS_RANDOM.VALUE) rn FROM question_bank q WHERE q.knowledge_points LIKE '%algebra%' ) WHERE rn <= 5; -- 取每个知识点下5道随机题

3.4 现象：“学生登录”（0102）成功后，首页显示的“校园动态”栏目内容为空

原因：说明书“校园信息管理系统”要求“动态信息管理”，但未明确栏目内容与用户角色的关联规则。开发默认所有栏目对所有学生可见，而生产环境因安全策略，cms_column表中status=0（下线）的栏目被前端过滤，但教务员忘记将新建的“校园动态”栏目状态设为1。
解决：在栏目管理后台强制增加状态校验：

// 栏目保存前校验 function validateColumnStatus(column) { if (column.type_code === 'DYNAMIC_NEWS' && column.status !== 1) { throw new Error('校园动态栏目必须上线才能显示'); } } // 同时在CMS内容查询SQL中加NOT NULL检查 SELECT * FROM cms_column c JOIN cms_column_content cc ON c.id = cc.column_id WHERE c.status = 1 AND cc.content_data IS NOT NULL;

3.5 现象：用PowerDesigner 11.0绘制的E-R图导入Oracle 9i后，外键约束名超长报错

原因：PowerDesigner默认生成外键名如FK_STUDENT_MANAGE_SYS_USER_ID，长度达30字符，而Oracle 9i限制约束名不超过30字节（中文字符占2字节，实际可用29字节）。
解决：在PowerDesigner中全局修改命名模板：

Options → Model Options → Naming Conventions → Foreign Key 将模板改为：FK_{ParentTable}_{ChildTable}_{Column} 例如：FK_EXAM_PAPER_STUDENT_ID（24字符，安全）

血泪经验：所有数据库对象名（表、字段、约束）在PowerDesigner中必须预设长度检查规则，否则设计图无法落地。

4. 用例驱动开发：如何把“005浏览教学内容”这个用例变成可测试的API契约

需求文档的价值不在描述有多全，而在能否被验证。说明书里“005浏览教学内容”只有一行描述：“可以浏览本年级以及以下年级的教学内容（教师或管理员不受限制）”，但这恰恰是测试用例的黄金入口。我们把它拆解为可执行的API契约。

4.1 接口定义：GET /api/curriculum/{grade}/{subject} 的精确语义

说明书说“本年级以及以下年级”，但“以下”是数学概念（≤）还是组织概念（同年级及低年级）？结合某高校学制，“高一”以下即“初中部”，需跨学段。因此接口必须明确年级编码规则：

则“高一学生浏览内容”的请求为GET /api/curriculum/SENIOR1/Mathematics，后端需返回JUNIOR1,JUNIOR2,SENIOR1三个年级的数学内容。接口响应体必须包含年级来源字段：

{ "data": [ { "id": "lesson-001", "title": "集合的概念", "grade_code": "SENIOR1", // 明确标注内容所属年级 "subject": "Mathematics", "content_url": "/courseware/sets_intro.pdf" } ], "meta": { "requested_grade": "SENIOR1", "available_grades": ["JUNIOR1","JUNIOR2","SENIOR1"] // 实际返回的年级列表 } }

4.2 权限中间件：如何用30行代码实现“教师不受限制”的逻辑

说明书005括号里那句“教师或管理员不受限制”是权限控制的例外条款，不能靠前端隐藏按钮，必须在API层拦截。在.NET Framework 2.0中，用HttpModule实现轻量级鉴权：

// CurriculumAuthModule.cs public class CurriculumAuthModule : IHttpModule { public void Init(HttpApplication context) { context.AuthorizeRequest += OnAuthorizeRequest; } private void OnAuthorizeRequest(object sender, EventArgs e) { HttpContext ctx = HttpContext.Current; string path = ctx.Request.Path; if (!path.StartsWith("/api/curriculum/")) return; string[] parts = path.Split('/'); if (parts.Length < 4) return; string requestedGrade = parts[3]; // 如 SENIOR1 // 获取当前用户角色（从Session或Token解析） string userRole = GetUserRole(ctx); if (userRole == "TEACHER" || userRole == "ADMIN") { return; // 教师/管理员放行 } // 学生：检查年级权限 string studentGrade = GetStudentGrade(ctx.User.Identity.Name); if (!IsGradeAccessible(requestedGrade, studentGrade)) { ctx.Response.StatusCode = 403; ctx.Response.Write("Forbidden: Grade not accessible"); ctx.Response.End(); } } private bool IsGradeAccessible(string requested, string student) { // 定义年级顺序：JUNIOR1 < JUNIOR2 < SENIOR1 < SENIOR2 var order = new Dictionary<string, int> { {"JUNIOR1",1}, {"JUNIOR2",2}, {"SENIOR1",3}, {"SENIOR2",4} }; return order.ContainsKey(requested) && order.ContainsKey(student) && order[requested] <= order[student]; } }

注意：GetUserRole()必须从可信源（如登录态Session）获取，绝不能依赖前端传参。这是005用例安全落地的底线。

4.3 测试用例表：覆盖说明书所有隐含条件

用例005表面简单，实则需覆盖7种边界场景。以下为QA团队执行的测试矩阵，每行对应一个curl命令：

这些测试用例全部源自对说明书005的逐字推敲——没有一行是凭空想象。当你把需求文档当成测试输入而非阅读材料时，它才真正活起来。

5. 从Rational Rose到真实交付：如何用说明书里的UML线索反向验证系统完整性

说明书第二部分明确要求“绘制UML所需要的Rational Rose”，但很多团队把UML当交付物凑数，画完就扔。其实，UML图（尤其是用例图）是检验系统是否遗漏功能的终极探针。我们以说明书第一部分的“后台系统用例图”为蓝本，演示如何用它做上线前的完整性审计。

5.1 用例图逆向映射：建立“功能编号→代码模块→测试覆盖率”的铁三角

说明书用例图中，021/022/023三个功能编号构成权限管理闭环。我们据此建立追踪矩阵：

提示：覆盖率数字必须精确到方法级。例如checkModuleAccess()方法有5个分支，测试必须覆盖全部5个，不能只测“有权限”和“无权限”两个主干。

5.2 用例参与者验证：为什么“管理员”和“教师”必须是不同认证体系

说明书所有用例都明确标注参与者：02权限设置的参与者是“管理员”，003教学资料管理的参与者是“教师”，005浏览内容的参与者是“学员”。这暗示着三类用户必须有独立的认证上下文：

• 管理员：拥有sys_admin角色，可访问/admin/**所有接口，密码策略最严（90天强制更换）
• 教师：拥有teacher角色，可访问/teacher/**，但禁止进入/admin/module（即使有权限也不该有入口）
• 学员：拥有student角色，仅能访问/student/**，且所有接口必须校验student.grade字段

若用同一套JWT Token承载所有角色，极易因role字段误设导致越权。正确做法是分离认证流：

// .NET Web.config 中配置独立认证模块 <system.web> <authentication mode="Forms"> <forms loginUrl="~/Admin/Login.aspx" name="ADMIN_AUTH" /> </authentication> </system.web> <system.web> <authentication mode="Forms"> <forms loginUrl="~/Teacher/Login.aspx" name="TEACHER_AUTH" /> </authentication> </system.web>

这样，教师访问/admin/module时，因Cookie中无ADMIN_AUTH票据，直接跳转到管理员登录页，从机制上杜绝越权可能——这是说明书用例参与者分离带来的架构启示。

5.3 用例扩展关系挖掘：022“功能模块管理”如何驱动前端路由自动化

说明书022描述：“权限设置管理扩展了功能模块的管理”。这里的“扩展”是UML术语，指022功能模块管理用例是02权限设置管理的扩展用例。这意味着：当管理员在后台新增一个模块（如“AI作业批改”），系统必须自动完成三件事：

1. 数据库插入sys_module记录
2. 生成对应前端路由（如/ai-grading）
3. 为该路由添加权限守卫（需ai_grading:read权限）

我们用脚本实现自动化：

# generate-routes.sh：监听sys_module表变更，自动生成Vue路由 mysql -u root -p$PASS school_db -e " SELECT CONCAT(' { path: \"/', LOWER(code), '\", name: \"', name, '\", component: () => import(\"@/views/', UPPER(code), '.vue\") },') FROM sys_module WHERE status = 1 " | sed 's/^ *//; s/ *$//' > src/router/auto-routes.js

同时，在路由守卫中注入动态权限检查：

// router/index.js router.beforeEach((to, from, next) => { const requiredPermission = to.name?.toLowerCase().replace(' ', '_') + ':read'; if (store.getters.hasPermission(requiredPermission)) { next(); } else { next('/403'); } });

这样，当教务处提出新增“心理健康测评”模块时，开发只需在后台录入模块信息，前端自动出现新菜单，无需改一行代码——这才是说明书里“扩展”二字的工程价值。

从那以后我每次评审需求文档，第一件事就是掏出笔，把所有带编号的功能点（021/00301/0102…）挨个圈出来，然后问自己：这个编号对应的数据库表建了吗？API接口写了几个测试用例？前端路由有没有权限守卫？如果任何一个环节答不上来，我就知道这份文档还没活过来。希望帮到你。

本文还有配套的精品资源，点击获取