从零搭建可直接落地的中小学版综合档案管理系统实操指南

一、前期环境准备（零门槛，所有工具直接下载安装）

提前准备以下工具，全部给出直接下载链接，点击即可下载对应Windows版本安装包，步骤全部可复制操作：

• JDK 1.8（必须指定版本）：https://download.oracle.com/java/8/latest/jdk-8u391-windows-x64.exe，安装时勾选「添加到环境变量」，安装完成后打开CMD输入java -version，输出版本号即为成功
• Maven 3.6.3：https://archive.apache.org/dist/maven/maven-3/3.6.3/binaries/apache-maven-3.6.3-bin.zip，解压后将解压目录的bin文件夹路径添加到系统环境变量Path，CMD输入mvn -v输出版本号即为成功
• Node.js 16：https://nodejs.org/dist/v16.18.1/node-v16.18.1-x64.msi，安装默认勾选添加环境变量，CMD输入node -v输出版本号即为成功
• MySQL 8.0：https://cdn.mysql.com/Downloads/MySQL-8.0/mysql-8.0.31-winx64.zip，解压后配置root密码，记住密码后续配置要用

二、获取适配中小学版的源码包

直接下载已经梳理好基础框架的源码包，链接：https://gitee.com/itbase-cn/school-ams/raw/master/school-ams-base.zip，下载后解压，得到back-end（后端服务）和front-end（前端界面）两个文件夹。

三、数据库初始化与配置

3.1 创建专用数据库

打开CMD，登录MySQL，输入以下命令回车，按提示输入root密码后执行，完成数据库创建：

``` CREATE DATABASE school_ams DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; ```

3.2 导入初始表结构

回到解压后的源码文件夹，找到sql/school_ams.sql文件，在CMD执行以下命令，将路径替换为你本地的实际解压路径：

``` mysql -u root -p school_ams < C:\你的解压路径\school-ams-base\sql\school_ams.sql ```

3.3 修改后端数据库连接配置

打开后端文件夹下的src/main/resources/application.yml，直接替换为以下完整配置，只需要修改其中的数据库密码为你自己的MySQL root密码：

``` spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://127.0.0.1:3306/school_ams?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&useSSL=false username: root password: 这里改成你的MySQLroot密码 servlet: multipart: max-file-size: 100MB max-request-size: 100MB server: port: 9090 ```

四、启动后端服务

打开CMD，进入后端项目的根目录（就是pom.xml所在的文件夹），依次执行以下两条命令：

• 第一步：打包编译，执行mvn clean install，等待控制台出现「BUILD SUCCESS」即为成功
• 第二步：启动服务，执行java -jar target/school-ams-1.0.0.jar

控制台输出「Started SchoolAmsApplication」即为后端启动成功，如果提示端口占用，打开上文的application.yml，修改server.port为其他未占用端口即可。

五、启动前端服务

打开新的CMD窗口，进入前端项目的根目录（就是package.json所在的文件夹），依次执行以下命令：

1. 安装依赖，使用国内镜像避免下载失败：npm install --registry=https://registry.npmmirror.com，等待安装完成
2. 启动前端服务：npm run serve

控制台输出「App running at: http://localhost:8080」即为启动成功，打开浏览器访问这个地址即可进入系统登录页。

六、配置中小学专属档案模块（10分钟完成）

使用默认管理员账号登录：账号admin，密码123456，登录后按照以下步骤配置专属模块：

• 进入左侧菜单系统管理 > 档案分类管理，点击「新增一级分类」，依次添加：学生档案、教职工档案、学校文书档案三个核心分类
• 点击每个分类后的「编辑字段」，为每个分类配置对应业务字段：
  • 学生档案：添加学号、姓名、班级、入学时间、学籍状态、家庭住址、监护人联系方式，全部勾选「必填」，保存
  • 教职工档案：添加工号、姓名、部门、职称、入职时间、合同期限、教师资格证编号，保存
  • 文书档案：添加文件编号、文件名称、发文部门、发文时间、保密等级、存放位置，保存
• 配置权限隔离：进入系统管理 > 角色管理，新增「班主任」「教务员」角色，班主任只开放本班学生档案查看权限，教务员开放教职工和文书档案管理权限，分配给对应用户即可，避免敏感信息泄露

七、日常使用核心操作

• 档案录入：进入对应档案分类，点击「新增」，填写信息后可上传附件（如学生体检表、教师资格证扫描件），保存即可
• 查询导出：支持按任意字段模糊搜索筛选，点击「导出Excel」即可批量导出所有符合条件的档案，直接用于上级统计上报
• 数据备份：进入系统管理 > 数据备份，点击「立即备份」，可下载备份文件到本地存储，建议每周备份一次

八、全校内网访问配置

如果需要全校内网访问，只需要把后端和前端部署到学校内网服务器，把配置文件中的localhost改为服务器的内网IP即可，前端打包执行npm run build，把生成的dist文件夹部署到nginx即可，完整nginx配置如下：

``` server { listen 80; location / { root /usr/share/nginx/dist; index index.html; try_files $uri $uri/ /index.html; } location /api/ { proxy_pass http://localhost:9090; } } ```

配置完成后重启nginx，所有校内设备通过内网IP即可访问使用。