简介这份资源是企业人力资源管理系统课程设计说明书面向计算机相关专业学生与需要完成课程设计、开题报告或概要设计文档的开发者。内容围绕需求分析、数据库设计、功能模块实现与考核评价点展开涵盖部门信息管理、员工信息管理、工资管理、用户管理四大模块并给出部门表、员工表、工资表、权限表、日志表等数据库组成设计以及开发环境、栏目设计、信息维护与查询输出等具体实现思路。压缩包内共1个doc文件约530KB为完整设计说明书文档目录结构清晰便于按章节查阅与引用。目前已有71人学习下载适合作为课程设计参考模板帮助读者快速理清系统分析、数据库建模与模块划分的写作框架也可用于开题报告和概要设计阶段的思路借鉴。1. 从一份 .doc 设计说明书说起课程设计管理系统到底在管什么很多同学拿到“课程设计管理系统-企业人力资源管理系统设计说明书.doc”这个题目时第一反应是把它当成一份 Word 文档来写结果写着写着就变成了功能罗列。实际上这份设计说明书要解决的核心问题是把课程设计从选题、分组、过程记录到答辩评分这条链路用一套信息系统的思路讲清楚并且以企业人力资源管理系统作为业务参照。换句话说它既要有课程设计的教学管理逻辑又要有 HR 系统里岗位、人员、考核、流程的建模思维。适合谁看正在做课程设计选题的本科生、需要交设计说明书的研究生以及第一次带课程设计的年轻老师。它不要求你写出能上线的系统但要求你能把需求、模块、数据、流程、界面、测试这几块讲得自洽。我见过太多说明书翻车在“需求分析和后面模块对不上”这一条上所以这篇笔记按可复现的写法把这份 .doc 拆成能照着填的骨架。2. 先定业务边界课程设计管理和 HR 系统怎么映射2.1 为什么不能直接照搬企业 HR 的功能清单企业人力资源管理系统通常包含组织架构、招聘、入职、考勤、绩效、薪酬、培训、离职等模块。课程设计管理系统如果原样照搬会出现两个问题一是课程设计根本没有“薪酬”和“社保”这类业务写进去就是凑字数二是课程设计的核心是“题目—学生—教师—过程—成绩”和 HR 的“岗位—员工—主管—考核—薪资”只是结构相似不是内容相同。常见做法是保留 HR 系统的建模思路把实体替换掉。比如把“部门”换成“课程设计批次”或“专业方向”把“岗位”换成“设计题目”把“员工”换成“学生”把“绩效考核”换成“阶段检查与答辩评分”。这样设计说明书里的 E-R 图和流程才站得住。2.2 一张映射表把两套业务对齐下面这张表是我在写这类说明书时先填的填完再画图后面章节就不会跑偏。企业 HR 概念课程设计对应概念说明部门 / 岗位批次 / 题目题目有容量、方向、指导教师员工学生学生有学号、班级、选题状态主管指导教师教师有指导名额、评分权限考勤过程记录周报、阶段检查、代码提交绩效成绩平时、中期、答辩、总分入离职选题 / 退选选题有截止时间和冲突检测这张表的作用是让评审老师一眼看出你懂业务迁移而不是把 HR 的字段硬塞进课程设计。参数上要注意题目容量、教师指导名额、选题开放时间这三个字段必须在需求分析里给出取值范围比如题目容量一般 1 到 5 人教师指导名额 3 到 15 人选题开放时间精确到小时。2.3 用一段伪代码把选题冲突检测讲清楚选题冲突是课程设计管理系统里最容易出 bug 的地方设计说明书里必须给出判定逻辑。下面这段 Python 伪代码可以直接写进“详细设计”章节用来解释并发选题时怎么防止一个学生选多个题目、一个题目超容量。# 选题冲突检测伪代码 def check_selection(student_id, topic_id, db): # 1. 学生是否已经选过题目 existing db.query(SELECT topic_id FROM selection WHERE student_id?, student_id) if existing: return False, 该学生已选题不能重复选 # 2. 题目是否还有余量 topic db.query(SELECT capacity, selected_count, status FROM topic WHERE id?, topic_id) if topic.status ! 开放: return False, 题目未开放 if topic.selected_count topic.capacity: return False, 题目容量已满 # 3. 时间窗口校验 now db.now() if now topic.open_time or now topic.close_time: return False, 不在选题时间范围内 # 4. 写入选题记录并更新计数事务内完成 db.execute(INSERT INTO selection(student_id, topic_id, select_time) VALUES(?,?,?), student_id, topic_id, now) db.execute(UPDATE topic SET selected_count selected_count 1 WHERE id?, topic_id) return True, 选题成功逻辑说明先查学生是否已有选题再查题目状态和容量最后校验时间窗口三步都通过才写入。参数说明capacity是题目容量selected_count是已选人数open_time和close_time是选题开放区间。注意事务必须包住插入和更新否则并发下会出现超选。这段逻辑写进说明书比只画一个流程图更有说服力。3. 设计说明书 .doc 的章节骨架怎么搭3.1 一份能过审的目录长什么样课程设计管理系统设计说明书不是论文不需要摘要和文献综述占大篇幅。我一般按下面这个结构写总页数控制在 25 到 40 页具体看学校要求。章节内容要点建议页数1 引言背景、目的、范围、术语22 需求分析角色、功能需求、非功能需求、用例图63 总体设计架构、模块划分、技术选型44 详细设计数据库、接口、关键流程、界面105 测试与验证测试用例、结果、问题记录46 部署与维护环境、备份、权限2附录数据字典、参考文献2这个骨架的好处是每一章都有可检查的交付物。需求分析对应用例图和需求列表总体设计对应架构图和模块表详细设计对应 E-R 图、表结构和接口说明测试对应用例表。评审老师翻到任何一章都能找到具体内容不会觉得空。3.2 需求分析里必须写死的四个角色课程设计管理系统的角色不要写太多四个就够学生、指导教师、教务管理员、系统管理员。学生负责选题、提交周报、查看成绩指导教师负责出题、审核选题、阶段评分教务管理员负责批次设置、时间窗口、成绩汇总系统管理员负责账号和权限。每个角色至少写三条功能需求并且标注优先级。比如学生选题这条优先级为高输入是学号和题目编号输出是选题结果异常包括重复选题、容量已满、不在时间窗口。这样写后面测试用例才有依据。3.3 用 SQL 把核心表结构定下来设计说明书里数据库设计是重头戏。下面这段 SQL 给出课程设计管理系统的核心表字段名和类型可以直接抄进附录的数据字典。-- 学生表 CREATE TABLE student ( student_id VARCHAR(20) PRIMARY KEY, -- 学号 name VARCHAR(50) NOT NULL, -- 姓名 class_name VARCHAR(50), -- 班级 major VARCHAR(50), -- 专业 password VARCHAR(64) -- 密码哈希 ); -- 题目表 CREATE TABLE topic ( topic_id INT PRIMARY KEY AUTO_INCREMENT, title VARCHAR(200) NOT NULL, -- 题目名称 teacher_id VARCHAR(20) NOT NULL, -- 指导教师 capacity INT DEFAULT 1, -- 容量 selected_count INT DEFAULT 0, -- 已选人数 status VARCHAR(10) DEFAULT 开放, open_time DATETIME, -- 开放时间 close_time DATETIME -- 截止时间 ); -- 选题记录表 CREATE TABLE selection ( id INT PRIMARY KEY AUTO_INCREMENT, student_id VARCHAR(20) NOT NULL, topic_id INT NOT NULL, select_time DATETIME, status VARCHAR(10) DEFAULT 有效, UNIQUE KEY uk_student (student_id) -- 一个学生只能有一条有效选题 ); -- 过程记录表 CREATE TABLE progress ( id INT PRIMARY KEY AUTO_INCREMENT, student_id VARCHAR(20) NOT NULL, week_no INT, -- 周次 content TEXT, -- 周报内容 submit_time DATETIME, score DECIMAL(5,2) -- 教师评分 );逻辑说明student和topic是基础表selection用唯一键约束保证一个学生只能选一个题目progress记录过程。参数说明capacity默认 1selected_count默认 0status取值“开放/关闭”week_no从 1 开始。注意selection的唯一键要加在student_id上但如果有退选历史需要改成条件唯一或加status字段做软删除。这个细节很多说明书会漏评审时容易被问。4. 避坑与排查写这份说明书最容易翻车的五件事4.1 需求分析和数据库对不上现象需求分析里写了“学生可以退选”但数据库的selection表只有插入没有状态字段详细设计里也没有退选接口。原因写需求时按功能列写数据库时按实体列两边没有交叉检查。解决每写一条功能需求就在数据字典里找对应的表和字段找不到就补。我一般用一张对照表左边功能编号右边表名和字段名逐条打勾。4.2 用例图只有气泡没有说明现象用例图里画了十几个椭圆但每个用例的参与者、前置条件、后置条件、异常流都没写。原因把用例图当成装饰以为画完就行。解决每个用例至少配一段文字说明格式为“参与者—前置条件—主流程—异常流—后置条件”。比如“学生选题”的前置条件是已登录且未选题主流程是选择题目并提交异常流包括容量已满和时间已过后置条件是选题记录写入。4.3 技术选型写成广告词现象写“采用 Spring Boot 框架具有高效、稳定、易扩展的特点”但没有说为什么选它、版本是多少、和课程设计规模是否匹配。原因复制粘贴技术介绍。解决技术选型要写约束条件。比如“课程设计管理系统用户量不超过 500部署在单台服务器选择 Spring Boot 2.7 加 MySQL 8.0原因是开发周期短、文档多、学校机房环境已预装”。这样写才像自己做的决定。4.4 测试用例只写正常流程现象测试章节只有“输入正确学号和题目编号选题成功”没有异常用例。原因把测试当成走过场。解决每个功能至少三条用例正常、边界、异常各一条。边界比如题目容量剩 1 个时两人同时选异常比如学号不存在、题目已关闭、时间已过。测试结果要写实际输出不能只写“通过”。4.5 界面设计只有文字没有布局现象界面设计章节写“学生登录后进入首页可以看到题目列表”但没有布局描述、控件说明、跳转关系。原因不会画原型图就用文字糊弄。解决用表格描述界面元素列出区域、控件、数据来源、操作。比如首页分三个区域顶部导航显示姓名和退出中间列表显示题目名称、教师、容量、状态底部按钮为“选题”。跳转关系写清楚点击后去哪个页面。5. 从说明书到可演示原型用最小代价把文档变成能跑的东西5.1 为什么建议你顺手做一个可点击原型设计说明书交上去之后很多学校还会要求答辩演示。如果只有 .doc答辩时干讲很吃亏。我的习惯是花半天做一个最小可运行原型不需要完整后端用 Python 的 Flask 加 SQLite 就能把选题和过程记录跑通。这样说明书里的流程、字段、界面都能对应到真实操作评审老师问“这个容量满了怎么办”你可以直接演示。5.2 用 Flask 加 SQLite 跑通选题最小闭环下面这段代码是一个最小选题接口配合前面的表结构使用。数据库用 SQLite省去安装 MySQL 的麻烦。from flask import Flask, request, jsonify import sqlite3 app Flask(__name__) def get_db(): conn sqlite3.connect(course_design.db) conn.row_factory sqlite3.Row return conn app.route(/select, methods[POST]) def select_topic(): data request.get_json() student_id data.get(student_id) topic_id data.get(topic_id) conn get_db() cur conn.cursor() # 检查是否已选题 cur.execute(SELECT 1 FROM selection WHERE student_id? AND status有效, (student_id,)) if cur.fetchone(): return jsonify({ok: False, msg: 已选题}), 400 # 检查题目容量 cur.execute(SELECT capacity, selected_count, status FROM topic WHERE topic_id?, (topic_id,)) topic cur.fetchone() if not topic or topic[status] ! 开放: return jsonify({ok: False, msg: 题目不可选}), 400 if topic[selected_count] topic[capacity]: return jsonify({ok: False, msg: 容量已满}), 400 # 写入选题并更新计数 cur.execute(INSERT INTO selection(student_id, topic_id, select_time, status) VALUES(?,?,datetime(now),有效), (student_id, topic_id)) cur.execute(UPDATE topic SET selected_count selected_count 1 WHERE topic_id?, (topic_id,)) conn.commit() conn.close() return jsonify({ok: True, msg: 选题成功}) if __name__ __main__: app.run(debugTrue)逻辑说明接口接收学号和题目编号先查重再查容量和状态最后写入并更新计数。参数说明student_id是学号字符串topic_id是整数status固定为“有效”。注意 SQLite 的datetime(now)返回 UTC 时间如果说明书里写的是本地时间需要加 8 小时或改用 Python 生成时间。这个细节在答辩时被问到过提前改掉能省事。5.3 把原型截图回填进说明书原型跑通后用浏览器截图把登录页、题目列表、选题结果、周报提交这几个界面贴回说明书的界面设计章节。每张图配一段说明写清楚输入、输出、异常提示。这样说明书里的界面设计不再是文字描述而是有真实操作依据。测试章节也可以把接口返回的 JSON 贴进去作为测试结果。整个文档的可信度会明显提升。5.4 最后检查一遍字段和流程的闭环交稿前我一般做一次闭环检查从需求分析的每条功能出发找到对应的数据库表、接口、界面、测试用例五处都能对上才算完。比如“学生提交周报”这条需求里有数据库有progress表接口有/progress界面有周报提交页测试有用例。任何一处断了就补上。这个习惯让我少返工很多次。希望帮到你。本文还有配套的精品资源点击获取 课程设计管理系统设计说明书撰写指南：从HR系统映射到可运行原型
简介这份资源是企业人力资源管理系统课程设计说明书面向计算机相关专业学生与需要完成课程设计、开题报告或概要设计文档的开发者。内容围绕需求分析、数据库设计、功能模块实现与考核评价点展开涵盖部门信息管理、员工信息管理、工资管理、用户管理四大模块并给出部门表、员工表、工资表、权限表、日志表等数据库组成设计以及开发环境、栏目设计、信息维护与查询输出等具体实现思路。压缩包内共1个doc文件约530KB为完整设计说明书文档目录结构清晰便于按章节查阅与引用。目前已有71人学习下载适合作为课程设计参考模板帮助读者快速理清系统分析、数据库建模与模块划分的写作框架也可用于开题报告和概要设计阶段的思路借鉴。1. 从一份 .doc 设计说明书说起课程设计管理系统到底在管什么很多同学拿到“课程设计管理系统-企业人力资源管理系统设计说明书.doc”这个题目时第一反应是把它当成一份 Word 文档来写结果写着写着就变成了功能罗列。实际上这份设计说明书要解决的核心问题是把课程设计从选题、分组、过程记录到答辩评分这条链路用一套信息系统的思路讲清楚并且以企业人力资源管理系统作为业务参照。换句话说它既要有课程设计的教学管理逻辑又要有 HR 系统里岗位、人员、考核、流程的建模思维。适合谁看正在做课程设计选题的本科生、需要交设计说明书的研究生以及第一次带课程设计的年轻老师。它不要求你写出能上线的系统但要求你能把需求、模块、数据、流程、界面、测试这几块讲得自洽。我见过太多说明书翻车在“需求分析和后面模块对不上”这一条上所以这篇笔记按可复现的写法把这份 .doc 拆成能照着填的骨架。2. 先定业务边界课程设计管理和 HR 系统怎么映射2.1 为什么不能直接照搬企业 HR 的功能清单企业人力资源管理系统通常包含组织架构、招聘、入职、考勤、绩效、薪酬、培训、离职等模块。课程设计管理系统如果原样照搬会出现两个问题一是课程设计根本没有“薪酬”和“社保”这类业务写进去就是凑字数二是课程设计的核心是“题目—学生—教师—过程—成绩”和 HR 的“岗位—员工—主管—考核—薪资”只是结构相似不是内容相同。常见做法是保留 HR 系统的建模思路把实体替换掉。比如把“部门”换成“课程设计批次”或“专业方向”把“岗位”换成“设计题目”把“员工”换成“学生”把“绩效考核”换成“阶段检查与答辩评分”。这样设计说明书里的 E-R 图和流程才站得住。2.2 一张映射表把两套业务对齐下面这张表是我在写这类说明书时先填的填完再画图后面章节就不会跑偏。企业 HR 概念课程设计对应概念说明部门 / 岗位批次 / 题目题目有容量、方向、指导教师员工学生学生有学号、班级、选题状态主管指导教师教师有指导名额、评分权限考勤过程记录周报、阶段检查、代码提交绩效成绩平时、中期、答辩、总分入离职选题 / 退选选题有截止时间和冲突检测这张表的作用是让评审老师一眼看出你懂业务迁移而不是把 HR 的字段硬塞进课程设计。参数上要注意题目容量、教师指导名额、选题开放时间这三个字段必须在需求分析里给出取值范围比如题目容量一般 1 到 5 人教师指导名额 3 到 15 人选题开放时间精确到小时。2.3 用一段伪代码把选题冲突检测讲清楚选题冲突是课程设计管理系统里最容易出 bug 的地方设计说明书里必须给出判定逻辑。下面这段 Python 伪代码可以直接写进“详细设计”章节用来解释并发选题时怎么防止一个学生选多个题目、一个题目超容量。# 选题冲突检测伪代码 def check_selection(student_id, topic_id, db): # 1. 学生是否已经选过题目 existing db.query(SELECT topic_id FROM selection WHERE student_id?, student_id) if existing: return False, 该学生已选题不能重复选 # 2. 题目是否还有余量 topic db.query(SELECT capacity, selected_count, status FROM topic WHERE id?, topic_id) if topic.status ! 开放: return False, 题目未开放 if topic.selected_count topic.capacity: return False, 题目容量已满 # 3. 时间窗口校验 now db.now() if now topic.open_time or now topic.close_time: return False, 不在选题时间范围内 # 4. 写入选题记录并更新计数事务内完成 db.execute(INSERT INTO selection(student_id, topic_id, select_time) VALUES(?,?,?), student_id, topic_id, now) db.execute(UPDATE topic SET selected_count selected_count 1 WHERE id?, topic_id) return True, 选题成功逻辑说明先查学生是否已有选题再查题目状态和容量最后校验时间窗口三步都通过才写入。参数说明capacity是题目容量selected_count是已选人数open_time和close_time是选题开放区间。注意事务必须包住插入和更新否则并发下会出现超选。这段逻辑写进说明书比只画一个流程图更有说服力。3. 设计说明书 .doc 的章节骨架怎么搭3.1 一份能过审的目录长什么样课程设计管理系统设计说明书不是论文不需要摘要和文献综述占大篇幅。我一般按下面这个结构写总页数控制在 25 到 40 页具体看学校要求。章节内容要点建议页数1 引言背景、目的、范围、术语22 需求分析角色、功能需求、非功能需求、用例图63 总体设计架构、模块划分、技术选型44 详细设计数据库、接口、关键流程、界面105 测试与验证测试用例、结果、问题记录46 部署与维护环境、备份、权限2附录数据字典、参考文献2这个骨架的好处是每一章都有可检查的交付物。需求分析对应用例图和需求列表总体设计对应架构图和模块表详细设计对应 E-R 图、表结构和接口说明测试对应用例表。评审老师翻到任何一章都能找到具体内容不会觉得空。3.2 需求分析里必须写死的四个角色课程设计管理系统的角色不要写太多四个就够学生、指导教师、教务管理员、系统管理员。学生负责选题、提交周报、查看成绩指导教师负责出题、审核选题、阶段评分教务管理员负责批次设置、时间窗口、成绩汇总系统管理员负责账号和权限。每个角色至少写三条功能需求并且标注优先级。比如学生选题这条优先级为高输入是学号和题目编号输出是选题结果异常包括重复选题、容量已满、不在时间窗口。这样写后面测试用例才有依据。3.3 用 SQL 把核心表结构定下来设计说明书里数据库设计是重头戏。下面这段 SQL 给出课程设计管理系统的核心表字段名和类型可以直接抄进附录的数据字典。-- 学生表 CREATE TABLE student ( student_id VARCHAR(20) PRIMARY KEY, -- 学号 name VARCHAR(50) NOT NULL, -- 姓名 class_name VARCHAR(50), -- 班级 major VARCHAR(50), -- 专业 password VARCHAR(64) -- 密码哈希 ); -- 题目表 CREATE TABLE topic ( topic_id INT PRIMARY KEY AUTO_INCREMENT, title VARCHAR(200) NOT NULL, -- 题目名称 teacher_id VARCHAR(20) NOT NULL, -- 指导教师 capacity INT DEFAULT 1, -- 容量 selected_count INT DEFAULT 0, -- 已选人数 status VARCHAR(10) DEFAULT 开放, open_time DATETIME, -- 开放时间 close_time DATETIME -- 截止时间 ); -- 选题记录表 CREATE TABLE selection ( id INT PRIMARY KEY AUTO_INCREMENT, student_id VARCHAR(20) NOT NULL, topic_id INT NOT NULL, select_time DATETIME, status VARCHAR(10) DEFAULT 有效, UNIQUE KEY uk_student (student_id) -- 一个学生只能有一条有效选题 ); -- 过程记录表 CREATE TABLE progress ( id INT PRIMARY KEY AUTO_INCREMENT, student_id VARCHAR(20) NOT NULL, week_no INT, -- 周次 content TEXT, -- 周报内容 submit_time DATETIME, score DECIMAL(5,2) -- 教师评分 );逻辑说明student和topic是基础表selection用唯一键约束保证一个学生只能选一个题目progress记录过程。参数说明capacity默认 1selected_count默认 0status取值“开放/关闭”week_no从 1 开始。注意selection的唯一键要加在student_id上但如果有退选历史需要改成条件唯一或加status字段做软删除。这个细节很多说明书会漏评审时容易被问。4. 避坑与排查写这份说明书最容易翻车的五件事4.1 需求分析和数据库对不上现象需求分析里写了“学生可以退选”但数据库的selection表只有插入没有状态字段详细设计里也没有退选接口。原因写需求时按功能列写数据库时按实体列两边没有交叉检查。解决每写一条功能需求就在数据字典里找对应的表和字段找不到就补。我一般用一张对照表左边功能编号右边表名和字段名逐条打勾。4.2 用例图只有气泡没有说明现象用例图里画了十几个椭圆但每个用例的参与者、前置条件、后置条件、异常流都没写。原因把用例图当成装饰以为画完就行。解决每个用例至少配一段文字说明格式为“参与者—前置条件—主流程—异常流—后置条件”。比如“学生选题”的前置条件是已登录且未选题主流程是选择题目并提交异常流包括容量已满和时间已过后置条件是选题记录写入。4.3 技术选型写成广告词现象写“采用 Spring Boot 框架具有高效、稳定、易扩展的特点”但没有说为什么选它、版本是多少、和课程设计规模是否匹配。原因复制粘贴技术介绍。解决技术选型要写约束条件。比如“课程设计管理系统用户量不超过 500部署在单台服务器选择 Spring Boot 2.7 加 MySQL 8.0原因是开发周期短、文档多、学校机房环境已预装”。这样写才像自己做的决定。4.4 测试用例只写正常流程现象测试章节只有“输入正确学号和题目编号选题成功”没有异常用例。原因把测试当成走过场。解决每个功能至少三条用例正常、边界、异常各一条。边界比如题目容量剩 1 个时两人同时选异常比如学号不存在、题目已关闭、时间已过。测试结果要写实际输出不能只写“通过”。4.5 界面设计只有文字没有布局现象界面设计章节写“学生登录后进入首页可以看到题目列表”但没有布局描述、控件说明、跳转关系。原因不会画原型图就用文字糊弄。解决用表格描述界面元素列出区域、控件、数据来源、操作。比如首页分三个区域顶部导航显示姓名和退出中间列表显示题目名称、教师、容量、状态底部按钮为“选题”。跳转关系写清楚点击后去哪个页面。5. 从说明书到可演示原型用最小代价把文档变成能跑的东西5.1 为什么建议你顺手做一个可点击原型设计说明书交上去之后很多学校还会要求答辩演示。如果只有 .doc答辩时干讲很吃亏。我的习惯是花半天做一个最小可运行原型不需要完整后端用 Python 的 Flask 加 SQLite 就能把选题和过程记录跑通。这样说明书里的流程、字段、界面都能对应到真实操作评审老师问“这个容量满了怎么办”你可以直接演示。5.2 用 Flask 加 SQLite 跑通选题最小闭环下面这段代码是一个最小选题接口配合前面的表结构使用。数据库用 SQLite省去安装 MySQL 的麻烦。from flask import Flask, request, jsonify import sqlite3 app Flask(__name__) def get_db(): conn sqlite3.connect(course_design.db) conn.row_factory sqlite3.Row return conn app.route(/select, methods[POST]) def select_topic(): data request.get_json() student_id data.get(student_id) topic_id data.get(topic_id) conn get_db() cur conn.cursor() # 检查是否已选题 cur.execute(SELECT 1 FROM selection WHERE student_id? AND status有效, (student_id,)) if cur.fetchone(): return jsonify({ok: False, msg: 已选题}), 400 # 检查题目容量 cur.execute(SELECT capacity, selected_count, status FROM topic WHERE topic_id?, (topic_id,)) topic cur.fetchone() if not topic or topic[status] ! 开放: return jsonify({ok: False, msg: 题目不可选}), 400 if topic[selected_count] topic[capacity]: return jsonify({ok: False, msg: 容量已满}), 400 # 写入选题并更新计数 cur.execute(INSERT INTO selection(student_id, topic_id, select_time, status) VALUES(?,?,datetime(now),有效), (student_id, topic_id)) cur.execute(UPDATE topic SET selected_count selected_count 1 WHERE topic_id?, (topic_id,)) conn.commit() conn.close() return jsonify({ok: True, msg: 选题成功}) if __name__ __main__: app.run(debugTrue)逻辑说明接口接收学号和题目编号先查重再查容量和状态最后写入并更新计数。参数说明student_id是学号字符串topic_id是整数status固定为“有效”。注意 SQLite 的datetime(now)返回 UTC 时间如果说明书里写的是本地时间需要加 8 小时或改用 Python 生成时间。这个细节在答辩时被问到过提前改掉能省事。5.3 把原型截图回填进说明书原型跑通后用浏览器截图把登录页、题目列表、选题结果、周报提交这几个界面贴回说明书的界面设计章节。每张图配一段说明写清楚输入、输出、异常提示。这样说明书里的界面设计不再是文字描述而是有真实操作依据。测试章节也可以把接口返回的 JSON 贴进去作为测试结果。整个文档的可信度会明显提升。5.4 最后检查一遍字段和流程的闭环交稿前我一般做一次闭环检查从需求分析的每条功能出发找到对应的数据库表、接口、界面、测试用例五处都能对上才算完。比如“学生提交周报”这条需求里有数据库有progress表接口有/progress界面有周报提交页测试有用例。任何一处断了就补上。这个习惯让我少返工很多次。希望帮到你。本文还有配套的精品资源点击获取