文件上传与毕业文档管理系统产品系统Vibe Coding

1、立项原因，旨在解决什么产品问题
传统毕业材料收集依赖邮件、U盘拷贝或社交软件传输，存在文件命名混乱、版本覆盖不清、教师逐份手动核对效率低、提交进度无法实时追踪等问题。本项目旨在提供一个统一的 Web平台，让学生端实现个人文件存储与毕业文档的结构化提交，教师端实现按班级筛选、在线审批、批量打包下载和提交率统计，从而替代零散的文件流转方式，减少人工核对工作量，确保毕业材料收集过程可追溯、可量化。
2、行业场景，业务背景高校毕业季通常涉及多个班级、数百名学生的十余种文档材料（如申请表、协议书、实习报告等）的集中提交与审核，时间紧、材料多、格式要求严格。教务处或辅导员需要逐份检查、打回不合格文件、统计提交进度，传统手工方式耗时、易出错。本系统适用于高职院校或本科院校的毕业实务管理场景，将文件网盘功能与毕业审批工作流合二为一，覆盖从学生上传、教师批阅到打包归档的全链路。

1、项目具体功能模块
用户认证模块（login.html、api/login.php）：普通用户、毕业生、教师三类角色登录注册，Session会话监控与过期自动跳转
文件管理模块（files.html、api/相关接口）：文件/文件夹的新建、上传（拖拽+大文件分片）、移动、删除、下载、重命名、共享，支持隐藏文件控制；毕业提交模块（FileUploadGraduationSubmission/）：12种毕业文档类型的结构化提交，模板下载，文件自动规范化命名，重复提交自动覆盖并更新提交时间；教师审批模块（teacher.html、teacher_review.html）：按班级浏览学生文件、通过/不通过快捷审批、自动跳转下一个待办项、连续批阅模式、打回重置、列表自动刷新；班级管理模块（api/admin-manager.php等）：Excel/CSV批量导入学生名单、学生信息编辑、按班级或按文档类型浏览提交情况；统计与导出模块：班级提交率饼图、按未交/已交筛选、多选导出Excel名单、按班级或按学生批量打包下载；个性化设置模块（api/config-manager.php）：默认首页偏好、隐藏文件显示开关
2、项目主要功能描述
本项目是一个面向高校毕业季的文件管理与毕业材料审核系统。学生端提供个人网盘功能，支持文件的上传、整理和共享，同时为毕业生提供结构化的毕业文档提交通道，12种材料按类型分别提交，文件自动按学号+姓名+文档名规范命名。教师端则提供完整的审批工作流，可按班级筛选学生、查看提交进度饼图、逐份审批文档并通过快捷按钮标记通过或不通过，系统自动跳转下一个待办项以提升批阅效率。支持批量导入学生名单、打包下载全班材料，并可按未交/已交状态导出Excel名单，覆盖从学生上传到教师审核再到归档导出的全链路。

1、“我”负责的具体任务
全栈独立开发：数据库双库架构设计、近60个PHP后端API、四个主页面及15个JS模块前端、毛玻璃风格UI、部署方案与全套文档。
2、技术栈、架构及实现亮点与难点
技术栈：PHP + mysqli 原生后端，MySQL 双库（主库 + 用户文件库动态分表），前端原生 HTML/CSS/JS + Vue.js。
亮点：大文件分片上传通用类（支持断点续传与回调解耦），审批工作流快捷按钮 + 自动跳转下一个待办，Database 单例连接管理（SELECT 1 心跳兼容 PHP 8.4+），Session 过期自动检测跳转。
难点：12种毕业文档的数据库列名需适配 MySQL 64字符限制；双库数据一致性（注册时主库+文件库联动建表）；教师审批页跨标签页导航状态同步（改用 localStorage）；60个API文件扁平堆积，已规划向 MVC 架构重构。