教学管理网站产品系统Vibe Coding

立项原因

这个系统是为了解决高数/考研数学学习过程中“任务布置难、执行跟踪难、请假顺延乱、学生进度不透明”的问题。

在实际教学或督学场景里，老师或助教通常会给学生安排每日学习任务，但如果靠微信、表格、群消息或人工记录，很容易出现几个问题：学生不知道今天该做什么，老师不知道学生是否完成，任务打卡证明分散在聊天记录里，学生请假或未完成后任务顺延容易混乱，管理端批量维护学生和任务也很耗时。

所以这个系统的核心目标，是把“学生每日学习任务”变成一个可管理、可追踪、可顺延、可统计的流程。

旨在解决的产品问题

学生端任务不清晰
学生每天登录后能直接看到今日任务、完成状态、请假入口和个人资料，不需要反复问老师或翻聊天记录。

老师/管理员布置任务成本高
管理端支持学生管理、任务模板、Excel 批量导入、任务查看和统计，减少人工逐个分配任务的成本。

学习进度缺少可信记录
学生可以打卡、上传证明图片或记录完成信息，老师可以回看任务完成情况，而不是只依赖口头反馈。

请假和未完成任务容易打乱计划
系统支持请假记录和任务顺延逻辑，避免学生第一天没完成、第二天又请假后，后续任务彻底错位。

学生规模扩大后管理困难
当学生数量变多后，靠人工表格维护账号、任务、状态、密码和资料会越来越慢，系统化管理能降低运营压力。

行业场景

这个系统适合教育培训、考研辅导、数学督学、陪跑学习营、线上小班课、私域教学服务等场景。

尤其适合那种“不是单纯卖课，而是持续监督学生完成每日学习计划”的业务模式。它更像一个轻量级 LMS 加督学打卡系统，重点不在内容播放，而在任务执行、学习节奏和过程管理。

业务背景

这类教学服务通常面对的是需要长期备考的学生。考研数学、高数、线代、概率等学习周期长，任务密度高，学生容易拖延，也容易因为请假、补课、未完成任务导致节奏失控。因此，业务上需要一个系统来承接。

功能模块

学生端登录与账号
学生可通过学号和密码登录系统，支持退出登录、修改密码、首次登录强制改密、账号禁用校验等功能。

今日任务
学生登录后可查看当天任务列表，包括任务类型、任务标题、完成状态、预计/实际用时等。学生可以勾选完成任务，并提交完成证明。

任务打卡与证明
任务支持上传图片作为完成证明，也支持记录完成时间和用时。管理员后续可以查看学生任务完成情况和证明材料。

月度任务 / 日历任务
学生可以按月份查看任务安排，通过日期切换查看不同日期的任务状态，方便了解近期学习计划和完成进度。

请假管理
学生可以申请当天请假，也可以取消请假。系统会记录请假日期，并在任务调度时避开请假日，避免任务安排混乱。

任务顺延
当学生当天未完成任务，或遇到请假、休息日时，系统会根据规则将任务顺延到后续可学习日期，保持学习计划连续。

个人资料
学生可以查看和维护个人档案信息，包括性别、年龄、学习状态、目标分数、考试信息、购买资料、备注等。

管理员登录与权限
管理员通过独立后台登录。系统区分普通管理员和超级管理员，超级管理员拥有更高权限，例如管理员账号管理等。

学生管理
管理员可以新增学生、查看学生列表、搜索学生、修改学生资料、禁用/启用学生、重置学生密码、删除学生及相关数据。

任务管理
管理员可以查看学生任务，按学生、日期、任务类型等维度管理任务，支持任务统计和任务状态查看。

Excel 批量导入
系统支持下载学生模板和任务模板，管理员可以通过 Excel 批量导入学生或任务，适合大批量运营场景。

任务导入模式
任务导入支持追加或替换，方便管理员根据不同教学安排批量更新学生学习计划。

报表与统计
管理员可以查看任务完成情况、学生学习进度、任务统计等数据，用于判断学生执行情况和整体运营状态。

管理员账号管理
超级管理员可以创建普通管理员、禁用管理员、重置管理员密码。

项目实现概述

我负责了该学生任务管理系统的核心功能设计、前后端开发、数据库建模、任务调度逻辑、管理端运营工具、测试环境搭建以及线上测试站部署支持。项目主要面向高数/考研数学督学场景，用系统化方式管理学生每日任务、打卡证明、请假顺延、批量导入和管理员运营流程。

技术栈

前端：Next.js 14、React 18、TypeScript、Tailwind CSS
后端：Next.js API Routes、Node.js
数据库：PostgreSQL、Prisma ORM
认证：JWT、bcryptjs、Cookie 鉴权
文件处理：XLSX，用于学生和任务模板导入导出
部署：Nginx、PM2、独立测试域名、HTTPS
测试：Playwright、本地 E2E 数据构造、测试环境隔离
架构亮点

采用 Next.js 全栈架构，前端页面和后端 API 在同一项目中维护，降低部署和协作成本。
使用 Prisma 对学生、任务、请假、档案、管理员、操作日志等核心数据建模，数据关系清晰。
学生端和管理端权限分离，支持学生、普通管理员、超级管理员不同访问权限。
任务调度逻辑独立封装，支持未完成任务结转、整体顺延、请假日跳过、休息日跳过等业务规则。
Excel 导入支持批量运营，适合真实教学场景下大规模学生和任务维护。
测试数据和真实数据隔离，测试站使用独立数据库，避免测试操作影响生产数据。
项目难点

最大难点是任务日期调度。学生可能连续未完成、第二天请假、后续还有原计划任务，如果处理不好，任务会重复、丢失或挤到请假日。
另一个难点是数据稳定性。导入模板、图片证明、学生资料、任务状态都可能存在异常数据，需要后端做兼容和校验。
管理端性能也有挑战。学生数量和证明图片变多后，列表接口不能一次性加载过重数据，需要分页和字段裁剪。