网上那些毕设选题表里“高校固定资产管理系统”几乎是每届都出现的熟面孔。但你真去搜代码跑一遍就会发现大量版本连资产领用记录都只有一张表硬怼状态流转靠改一行 update别说答辩了自己演示时都会被老师问住。我手上这套 SpringBoot Vue 的高校固定资产管理系统源码之所以拿出来写是因为它更像一个能落地的真实项目后端有 SpringBoot 工程结构前端有 Vue 页面组织数据库有完整的 SQL 脚本交付物里还带了接口文档。这篇文章就把这套系统的设计逻辑、表结构、接口约定和跑通步骤逐层拆开顺带把我实际跑项目时踩过的坑一并说清楚。1. 这类系统真正的难点不在增删改查而在业务闭环固定资产管理系统听起来就是个常规 CRUD但高校场景比一般公司复杂得多。公司做资产台账可能只需要登记、折旧、报废三件事高校至少要管住“从申购到处置”的整条链路而且参与的人多、角色多、审批多。如果项目只做一张资产表前端能录入、能修改就说是完整系统那是自欺欺人。1.1 高校资产场景的特殊性管人、管地、管状态高校固定资产有几个特点分布散从行政楼到实验室再到学生活动中心责任人变化频繁教师调岗、学生毕业、实验室交接资产必须跟着换人状态多有在用、闲置、维修中、已报废、外借等每种状态背后都要有对应记录支撑。所以系统里资产表和记录表必须分开设计资产表只保留当前最新状态所有历史变化都落到各类型的操作记录表里比如领用记录、维修记录、盘点记录、处置记录。这不仅是数据结构问题也是业务闭环问题一条资产从入库到报废每一步在系统里都查得到痕迹。1.2 从用户视角拆出六个核心闭环我第一次跑这个项目时没急着看代码先从角色页面反推业务最后归纳出六个闭环这也是系统功能列表的主干业务闭环触发动作涉及页面状态变化资产入库新增资产、批量导入资产录入、资产列表未审核 - 正常/闲置领用与归还教师申请领用、资产管理员确认我的申请、资产台账正常 - 领用中 - 正常维修管理报修申请、维修登记维修工单正常 - 维修中 - 正常盘点管理发起盘点、逐项录入结果盘点任务、盘点明细正常/闲置 - 盘盈/盘亏调拨交接部门调拨、保管人变更调拨记录原部门 - 新部门处置报废申请报废、审批处置申请、审批列表正常/闲置 - 待报废 - 已报废每个闭环都不是单表能完成的。领用要有申请表、审批记录、归还记录维修要有工单、费用、处理人报废要有申请人和审批人分离。这也是评审老师最爱问的地方资产状态是谁改的有没有留痕只要表顺序乱一步系统基本就废了。1.3 角色设计决定了权限模型用户角色在这个系统里天然分三层超级管理员管系统和全部数据资产管理员负责日常业务处理比如录入资产、处理领用、登记维修、发起盘点普通教职工只能申请、查询和自己相关的资产。权限模型不需要上 Spring Security 那一整套重武器用 RBAC 三张基础表用户表、角色表、用户角色关联表后端接口按角色码校验前端菜单按角色码动态渲染毕业设计这个体量完全够用也更容易在答辩时讲清楚。2. SpringBoot Vue 分离架构里每层该干什么项目采用前后端分离SpringBoot 负责提供 RESTful APIVue 负责页面渲染和交互。分离的好处是后端不用管页面长什么样前端也不用关心 SQL 怎么执行两边只通过 JSON 通信。整个项目拆成 backend 和 frontend 两个目录各自独立启动联调时靠 HTTP 访问。2.1 后端工程目录与技术选型后端核心是 SpringBoot 2.7.x MyBatis-Plus MySQL权限校验用 JWT接口文档用 Knife4j。工程目录按经典分层组织com.zcms ├── controller // 接口入口只做参数接收和结果封装 ├── service // 业务逻辑层事务与状态流转在这里控制 ├── mapper // MyBatis-Plus 持久层 ├── entity // 数据库实体类 ├── dto // 前端交互对象 ├── vo // 返回视图对象 ├── config // 全局配置拦截器、CORS、Knife4j ├── utils // JWT、Excel 工具类 └── common // 统一返回结果、异常处理、常量分层原则是 controller 里不写业务、mapper 里不写逻辑。拿领用资产举例controller 接受前端传来的资产 ID 和受益人 ID真正干活的在 service 层先生成领用记录再把资产状态改成“领用中”最后记录操作日志。这三步必须放在同一个事务方法里否则中途断电会出现资产状态和记录对不上的情况。2.2 前端工程结构与组件组织前端基于 Vue 2 Element UI 或者 Vue 3 Element Plus 都能跑主要看目录里装的是哪个版本。页面结构一般如下src ├── api // axios 请求封装与接口定义 ├── router // 路由表含守卫控制登录 ├── store // 登录用户信息与权限存储 ├── views │ ├── login │ ├── dashboard │ ├── asset // 资产台账、新增、编辑 │ ├── apply // 领用申请、我的申请 │ ├── repair // 报修、维修工单 │ ├── inventory // 盘点任务、盘点明细 │ ├── dispose // 处置申请 │ └── system // 用户管理、角色管理、部门管理 ├── components // 通用组件 └── utils // 请求封装、时间格式化等前端最关键的是对登录状态的管理。路由守卫里做两件事没登录就跳转登录页已登录但角色不匹配的页面直接拦截。配合动态菜单渲染普通教职工根本看不到用户管理入口这比后端接口校验更直观也是答辩时容易加分的点。2.3 接口文档为什么是项目交付物里的硬通货很多人以为接口文档是给公司团队协作用的毕设用不上这是误解。接口文档至少有四个实际作用第一前端开发时能独立 mock 数据不用等后端启动第二答辩时老师关注“接口是不是你自己设计的”文档能证明这点第三代码里如果出了问题文档能帮忙快速定位参数名是否一致第四项目验收时要交材料文档属于必备交付物。这套系统用的 Knife4j 是 Swagger 的增强版页面比原生 UI 好看接口分组清晰启动后端后访问 /doc.html 就能在线调试。3. SQL 脚本怎么读从表设计反推业务逻辑拿到一套完整项目第一步别急着启动先打开 sql 脚本看表结构。看懂了表基本就看懂了整个系统。这套项目的 SQL 脚本做得比较完整包含了建库、建表、初始化菜单、初始化字典、造演示数据。下面按业务模块把核心表拆开讲一遍。3.1 基础权限四表用户、角色、部门、菜单用户表存账号密码和基础信息密码是加密后的密文不是明文这一点必须注意。角色表存角色名称和角色编码比如 admin、asset_admin、teacher。部门和资产归属直接相关部门表带 parent_id支持树形结构因为高校通常是学院-系-实验室多级。菜单表用于前端动态生成路由每个菜单项绑定一个权限标识后端校验接口时拿的就是这个标识。权限相关的表设计相对固定但有一个细节容易被忽略用户表和部门表要用逻辑上的关联字段而不是在用户表里堆部门名称。查询时 join 出部门名称页面上显示用业务上操作的是部门 ID。这样做的好处是部门改名后用户所属部门跟着变不会出现资产记录上还是旧部门名的尴尬。3.2 资产台账表与分类表编号规则是灵魂资产信息表是核心中的核心字段至少包括资产编号、资产名称、资产分类、规格型号、单位、数量、原值、购置日期、使用部门、使用人、存放地点、当前状态、备注。要注意“数量”这个字段很容易被新手忽略高校里同一型号的电脑可能批量采购几十台如果一台一台录入工作量巨大。所以严格来说应该有资产主表和资产明细表主表记录采购批次明细表记录单件资产方便做标签打印和单台状态管理。分类表用树形结构父分类为一级分类比如“办公设备”“教学仪器”“图书资料”子分类更具体比如“台式计算机”“笔记本电脑”“投影仪”。每个分类定义一个编码前缀这个前缀直接拼进资产编号里。比如ZC-BG-2024-0001拆开来看ZC 是固定资产的固定前缀BG 是办公设备分类编码2024 是购置年份0001 是当年的流水序号。用 SQL 查当前分类当年最大流水号再加一就能自动生成新编号。这种规则在答辩时讲起来非常加分因为面试官会追问“资产编号是手输还是自动生成”如果回答自动生成说明你想过业务标准化问题。3.3 状态流转记录表领用、维修、盘点、处置资产表里的状态字段只是当前值真正体现系统价值的是记录表。领用申请表要有申请人、申请类型领用/归还、资产 ID、申请时间、审批状态、审批人、审批时间、预计归还时间、实际归还时间。审批状态一般用字典值比如 0 待审批、1 已通过、2 已驳回状态流转是申请后待审批审批通过后资产状态变为领用中归还操作后资产恢复为正常。维修表记录报修人、资产 ID、故障描述、处理方式、维修费用、维修时间、处理人。这里有个实用设计报修后资产状态置为维修中维修完成再置回正常闲置资产报修也不会被当作正常在用资产领走避免业务混乱。盘点表则要分开两步主表记录盘点编号、开始时间、结束时间、盘点范围明细表记录每个资产的盘点结果是正常、盘盈还是盘亏。盘亏资产要额外关联到处置流程里不能只标记一下就没下文。3.4 字典表与初始化数据的重要性SQL 脚本里除了建表还要初始化字典数据比如资产状态字典、审批状态字典、资产分类数据、部门数据、管理员账号。初始化数据这块很多人图省事只建空表结果前端下拉框什么都没有连管理员都登不进去。完整的 SQL 脚本应该保证执行完建库建表后直接启动后端和前端就能用管理员账号登录、看到演示数据。这个细节直接影响老师验收时的第一印象。4. 接口文档该怎么组织前后端才不吵架接口设计是前后端协作的桥梁。一套随便写的接口后端觉得自己写完了前端却因为字段名对不上反复联调是最浪费时间的事。这套项目的接口文档可以从接口域、统一返回结构、分页约定、权限校验四个维度去理解。4.1 接口域划分与统一返回结构接口按业务域划分。登录认证模块一组资产管理一组领用归还一组维修一组盘点一组处置一组系统管理一组。每个域下有增删改查和业务操作两类接口。比如资产管理域有查询、新增、修改、删除基础接口还有批量导入、资产标签打印这类业务接口领用域有申请、审批、归还三个核心接口。统一返回结构是前后端协作最关键的部分。后端所有接口返回格式保持{ code: 200, message: 操作成功, data: {} }code 为 200 表示成功401 表示未登录或 token 过期500 表示业务异常。前端 axios 响应拦截器统一判断 code非 200 就直接弹错误提示不用每个页面重复写错误分支。分页查询的返回结构也要统一data 里固定包含 total 和 records 两个字段records 是当前页数据列表前端拿到后直接绑定表格。4.2 JWT 登录认证与接口鉴权登录接口收到用户名密码后校验通过生成一个 JWT tokentoken 里包含用户 ID 和角色编码有效时间一般是 24 小时。后续所有接口请求在 header 里带 Authorization: Bearer token后端拦截器统一解析 token拿到当前用户信息后放到 ThreadLocal 里业务层可以直接取当前操作人。接口鉴权不需要在每个方法里写判断。用自定义注解定义权限标识比如 RequirePermission(asset:add)拦截器解析注解后跟当前用户的权限集合做匹配。没有权限直接返回 code 403。这种设计在代码层面很干净答辩时也容易讲清楚。需要注意拦截器要放行登录接口和 doc.html 接口否则前端没法登录、接口文档也打不开这个坑我见过不少人踩。4.3 分页查询与模糊搜索的通用约定分页查询是列表页的核心。接口参数约定为 pageNum、pageSize条件参数按业务追加。例如资产查询接口 GET /api/asset/query?pageNum1pageSize10assetName笔记本deptId2status1。后端用 MyBatis-Plus 的 Page 对象接收条件构造器按非空参数拼接模糊查询。模糊查询默认用 like 而不是等于静态工具类里统一处理。这样每个列表页只需要传一个对象不用为每种查询条件单独写方法。5. 从零跑通项目环境、配置与初始化实操我第一次跑这套项目时前后端花了半小时才全起来踩了几个不高明但很真实的坑。下面把最顺畅的启动路径写一遍照着操作基本不会卡。5.1 环境清单版本别乱配后端依赖 Java 和 Maven前端依赖 Node.js。常用的搭配是 JDK 1.8 或 11、Maven 3.6、Node 14 到 16 之间、MySQL 5.7 或 8.0。特别注意 Java 17 上跑 SpringBoot 2.7 基本没问题但有些老版本 JDK 编译参数会报错最好直接按项目内 .gitignore 或 pom.xml 里的版本约定来。Node 版本太高容易触发依赖安装失败我建议用 nvm 管理多版本装 Node 14 最稳。5.2 导入 SQL 脚本并初始化数据库用 Navicat 或命令行登录 MySQL新建数据库 zcms字符集选 utf8mb4然后执行 sql 脚本。执行完后确认一下表数量和初始化数据条数。常见问题有两个一是 MySQL 8.0 和 5.7 的驱动 URL 写法略有差异8.0 需要加时区参数 serverTimezoneAsia/Shanghai二是如果表名或字段名用了 keyword 关键字比如 order、status在 SQL 里要用反引号包起来。执行脚本报错时先看第一个报错通常第一个错就是根因后面的错误往往是连锁反应。5.3 后端启动配置与常见报错后端启动前改 application.yml 里的数据库连接用户名和密码改成自己的。如果数据库端口不是默认 3306也要一并改。启动 SpringBoot 后看控制台日志出现 Tomcat started on port 8080 说明启动成功。常见报错是数据库连接失败先 ping 数据库地址再检查密码注意 MySQL 8.0 的密码加密方式默认 caching_sha2_password旧驱动不兼容要换 mysql-connector-java 版本或改用 mysql_native_password。Knife4j 接口文档地址是 http://localhost:8080/doc.html启动后先打开它验证接口是否正常。登录接口可以先在文档页面直接调试返回 code 200 说明后端全链路没问题。5.4 前端安装依赖与代理配置前端目录打开终端执行 npm install如果网络不好可以在项目里配置淘宝镜像源。安装成功后 npm run dev 启动开发服务器默认端口 8081 或 9527看配置。前端页面要访问后端接口开发环境下通过 proxy 代理避免跨域。vue.config.js 里配置 devServer 的 proxy把 /api 前缀的请求转发到 http://localhost:8080。这样浏览器里请求的是前端地址后端收不到跨域报错。如果不用代理直接请求后端需要后端开启 CORS但毕设项目建议用代理少一个跨域问题。5.5 登录系统验证核心链路浏览器打开前端地址用 SQL 脚本里初始化的管理员账号登录。登录成功后先看仪表盘统计是否能显示再看资产列表能不能查出数据。接着走一遍核心链路验证系统完整性新增一条资产给这台资产发起领用申请用审批账号通过申请再执行归还。这几个操作连续做完说明前后端、数据库、权限四条链路全部通畅。6. 开发和答辩时最容易暴露的三个薄弱点代码跑通只是及格要拿高分得把几个薄弱点提前补上。这些点是我看过很多毕设代码后总结出来的共性问题这个项目里虽然已经处理过但建议从原理上理解因为答辩大概率会被问到。6.1 时间、金额与 ID 精度问题前端表格里时间显示成时间戳或带 T 的字符串是最常见的低级问题。解决办法是后端全局配置 Jackson 序列化格式统一为 yyyy-MM-dd HH:mm:ss前端再配合 dayjs 做一次格式化双保险。金额字段必须用 BigDecimal不能用 double否则 Excel 导入数据后可能出现 0.001 的精度误差。如果资产表主键用了雪花 IDLong 类型传到前端会因为 JS 精度限制丢最后几位解决办法是后端在 VO 里把 ID 转成字符串返回。这个项目如果用自增 ID 就没这问题但知道总比不知道好。6.2 演示数据准备别让老师看空列表实际验收演示时如果数据库里只有几条测试数据页面稀稀拉拉观感很差。建议在 SQL 脚本之外单独准备一份演示数据脚本至少包含十个左右部门、三级资产分类、五十条左右的资产记录覆盖不同状态、几条待审批的领用申请、几条维修记录、一条进行中的盘点任务。这样打开页面每个模块都有内容可点演示节奏也顺。6.3 高频答辩问题与回答思路老师最常问的方向有五个。为什么用 JWT 而不用 Session回答点是无状态、适合前后端分离、扩展性好。资产状态怎么保证一致回答点是所有状态变更走 service 层事务方法记录表和资产表在同一事务里更新。权限控制怎么实现的回答点是 RBAC 注解 拦截器三件套。前端权限和后端权限怎么配合回答点是菜单动态渲染和接口注解双重控制。报表统计怎么做的回答点是用 SQL 聚合查询按分类、部门、状态分组。每个问题都要能从表结构讲到代码位置不要只会念 PPT。6.4 一个能提升项目档次的扩展方向如果还有余力建议给系统加一个 Excel 批量导入导出功能。高校资产盘点时不可能一条条录通常用模板导入。后端集成 EasyExcel前端用上传组件提交文件模板里包含资产分类、型号、价格等字段导入时按编号规则自动生成资产编号导出时把查询结果直接写回 Excel。这个功能能同时覆盖导入、导出、文件解析三个考点答辩时非常能打。说到最后这套系统的每个表、每个接口、每段代码跑通并不难难的是理解它为什么这么设计。我实际跑项目时最大的体会是先把 SQL 脚本读懂再去调接口、看页面效率比从 controller 硬啃高很多。如果你想拿它做毕设建议在跑通之后把分类表改成教材分类、把处置流程改成报废审批流程这类小改造做一遍——既证明代码是看懂的又能让项目脱离模板感。遇到启动问题也别慌先看日志、再看配置、最后查网络九成问题都出在这三处。
高校固定资产管理系统实战：SpringBoot+Vue表结构设计与接口文档详解
网上那些毕设选题表里“高校固定资产管理系统”几乎是每届都出现的熟面孔。但你真去搜代码跑一遍就会发现大量版本连资产领用记录都只有一张表硬怼状态流转靠改一行 update别说答辩了自己演示时都会被老师问住。我手上这套 SpringBoot Vue 的高校固定资产管理系统源码之所以拿出来写是因为它更像一个能落地的真实项目后端有 SpringBoot 工程结构前端有 Vue 页面组织数据库有完整的 SQL 脚本交付物里还带了接口文档。这篇文章就把这套系统的设计逻辑、表结构、接口约定和跑通步骤逐层拆开顺带把我实际跑项目时踩过的坑一并说清楚。1. 这类系统真正的难点不在增删改查而在业务闭环固定资产管理系统听起来就是个常规 CRUD但高校场景比一般公司复杂得多。公司做资产台账可能只需要登记、折旧、报废三件事高校至少要管住“从申购到处置”的整条链路而且参与的人多、角色多、审批多。如果项目只做一张资产表前端能录入、能修改就说是完整系统那是自欺欺人。1.1 高校资产场景的特殊性管人、管地、管状态高校固定资产有几个特点分布散从行政楼到实验室再到学生活动中心责任人变化频繁教师调岗、学生毕业、实验室交接资产必须跟着换人状态多有在用、闲置、维修中、已报废、外借等每种状态背后都要有对应记录支撑。所以系统里资产表和记录表必须分开设计资产表只保留当前最新状态所有历史变化都落到各类型的操作记录表里比如领用记录、维修记录、盘点记录、处置记录。这不仅是数据结构问题也是业务闭环问题一条资产从入库到报废每一步在系统里都查得到痕迹。1.2 从用户视角拆出六个核心闭环我第一次跑这个项目时没急着看代码先从角色页面反推业务最后归纳出六个闭环这也是系统功能列表的主干业务闭环触发动作涉及页面状态变化资产入库新增资产、批量导入资产录入、资产列表未审核 - 正常/闲置领用与归还教师申请领用、资产管理员确认我的申请、资产台账正常 - 领用中 - 正常维修管理报修申请、维修登记维修工单正常 - 维修中 - 正常盘点管理发起盘点、逐项录入结果盘点任务、盘点明细正常/闲置 - 盘盈/盘亏调拨交接部门调拨、保管人变更调拨记录原部门 - 新部门处置报废申请报废、审批处置申请、审批列表正常/闲置 - 待报废 - 已报废每个闭环都不是单表能完成的。领用要有申请表、审批记录、归还记录维修要有工单、费用、处理人报废要有申请人和审批人分离。这也是评审老师最爱问的地方资产状态是谁改的有没有留痕只要表顺序乱一步系统基本就废了。1.3 角色设计决定了权限模型用户角色在这个系统里天然分三层超级管理员管系统和全部数据资产管理员负责日常业务处理比如录入资产、处理领用、登记维修、发起盘点普通教职工只能申请、查询和自己相关的资产。权限模型不需要上 Spring Security 那一整套重武器用 RBAC 三张基础表用户表、角色表、用户角色关联表后端接口按角色码校验前端菜单按角色码动态渲染毕业设计这个体量完全够用也更容易在答辩时讲清楚。2. SpringBoot Vue 分离架构里每层该干什么项目采用前后端分离SpringBoot 负责提供 RESTful APIVue 负责页面渲染和交互。分离的好处是后端不用管页面长什么样前端也不用关心 SQL 怎么执行两边只通过 JSON 通信。整个项目拆成 backend 和 frontend 两个目录各自独立启动联调时靠 HTTP 访问。2.1 后端工程目录与技术选型后端核心是 SpringBoot 2.7.x MyBatis-Plus MySQL权限校验用 JWT接口文档用 Knife4j。工程目录按经典分层组织com.zcms ├── controller // 接口入口只做参数接收和结果封装 ├── service // 业务逻辑层事务与状态流转在这里控制 ├── mapper // MyBatis-Plus 持久层 ├── entity // 数据库实体类 ├── dto // 前端交互对象 ├── vo // 返回视图对象 ├── config // 全局配置拦截器、CORS、Knife4j ├── utils // JWT、Excel 工具类 └── common // 统一返回结果、异常处理、常量分层原则是 controller 里不写业务、mapper 里不写逻辑。拿领用资产举例controller 接受前端传来的资产 ID 和受益人 ID真正干活的在 service 层先生成领用记录再把资产状态改成“领用中”最后记录操作日志。这三步必须放在同一个事务方法里否则中途断电会出现资产状态和记录对不上的情况。2.2 前端工程结构与组件组织前端基于 Vue 2 Element UI 或者 Vue 3 Element Plus 都能跑主要看目录里装的是哪个版本。页面结构一般如下src ├── api // axios 请求封装与接口定义 ├── router // 路由表含守卫控制登录 ├── store // 登录用户信息与权限存储 ├── views │ ├── login │ ├── dashboard │ ├── asset // 资产台账、新增、编辑 │ ├── apply // 领用申请、我的申请 │ ├── repair // 报修、维修工单 │ ├── inventory // 盘点任务、盘点明细 │ ├── dispose // 处置申请 │ └── system // 用户管理、角色管理、部门管理 ├── components // 通用组件 └── utils // 请求封装、时间格式化等前端最关键的是对登录状态的管理。路由守卫里做两件事没登录就跳转登录页已登录但角色不匹配的页面直接拦截。配合动态菜单渲染普通教职工根本看不到用户管理入口这比后端接口校验更直观也是答辩时容易加分的点。2.3 接口文档为什么是项目交付物里的硬通货很多人以为接口文档是给公司团队协作用的毕设用不上这是误解。接口文档至少有四个实际作用第一前端开发时能独立 mock 数据不用等后端启动第二答辩时老师关注“接口是不是你自己设计的”文档能证明这点第三代码里如果出了问题文档能帮忙快速定位参数名是否一致第四项目验收时要交材料文档属于必备交付物。这套系统用的 Knife4j 是 Swagger 的增强版页面比原生 UI 好看接口分组清晰启动后端后访问 /doc.html 就能在线调试。3. SQL 脚本怎么读从表设计反推业务逻辑拿到一套完整项目第一步别急着启动先打开 sql 脚本看表结构。看懂了表基本就看懂了整个系统。这套项目的 SQL 脚本做得比较完整包含了建库、建表、初始化菜单、初始化字典、造演示数据。下面按业务模块把核心表拆开讲一遍。3.1 基础权限四表用户、角色、部门、菜单用户表存账号密码和基础信息密码是加密后的密文不是明文这一点必须注意。角色表存角色名称和角色编码比如 admin、asset_admin、teacher。部门和资产归属直接相关部门表带 parent_id支持树形结构因为高校通常是学院-系-实验室多级。菜单表用于前端动态生成路由每个菜单项绑定一个权限标识后端校验接口时拿的就是这个标识。权限相关的表设计相对固定但有一个细节容易被忽略用户表和部门表要用逻辑上的关联字段而不是在用户表里堆部门名称。查询时 join 出部门名称页面上显示用业务上操作的是部门 ID。这样做的好处是部门改名后用户所属部门跟着变不会出现资产记录上还是旧部门名的尴尬。3.2 资产台账表与分类表编号规则是灵魂资产信息表是核心中的核心字段至少包括资产编号、资产名称、资产分类、规格型号、单位、数量、原值、购置日期、使用部门、使用人、存放地点、当前状态、备注。要注意“数量”这个字段很容易被新手忽略高校里同一型号的电脑可能批量采购几十台如果一台一台录入工作量巨大。所以严格来说应该有资产主表和资产明细表主表记录采购批次明细表记录单件资产方便做标签打印和单台状态管理。分类表用树形结构父分类为一级分类比如“办公设备”“教学仪器”“图书资料”子分类更具体比如“台式计算机”“笔记本电脑”“投影仪”。每个分类定义一个编码前缀这个前缀直接拼进资产编号里。比如ZC-BG-2024-0001拆开来看ZC 是固定资产的固定前缀BG 是办公设备分类编码2024 是购置年份0001 是当年的流水序号。用 SQL 查当前分类当年最大流水号再加一就能自动生成新编号。这种规则在答辩时讲起来非常加分因为面试官会追问“资产编号是手输还是自动生成”如果回答自动生成说明你想过业务标准化问题。3.3 状态流转记录表领用、维修、盘点、处置资产表里的状态字段只是当前值真正体现系统价值的是记录表。领用申请表要有申请人、申请类型领用/归还、资产 ID、申请时间、审批状态、审批人、审批时间、预计归还时间、实际归还时间。审批状态一般用字典值比如 0 待审批、1 已通过、2 已驳回状态流转是申请后待审批审批通过后资产状态变为领用中归还操作后资产恢复为正常。维修表记录报修人、资产 ID、故障描述、处理方式、维修费用、维修时间、处理人。这里有个实用设计报修后资产状态置为维修中维修完成再置回正常闲置资产报修也不会被当作正常在用资产领走避免业务混乱。盘点表则要分开两步主表记录盘点编号、开始时间、结束时间、盘点范围明细表记录每个资产的盘点结果是正常、盘盈还是盘亏。盘亏资产要额外关联到处置流程里不能只标记一下就没下文。3.4 字典表与初始化数据的重要性SQL 脚本里除了建表还要初始化字典数据比如资产状态字典、审批状态字典、资产分类数据、部门数据、管理员账号。初始化数据这块很多人图省事只建空表结果前端下拉框什么都没有连管理员都登不进去。完整的 SQL 脚本应该保证执行完建库建表后直接启动后端和前端就能用管理员账号登录、看到演示数据。这个细节直接影响老师验收时的第一印象。4. 接口文档该怎么组织前后端才不吵架接口设计是前后端协作的桥梁。一套随便写的接口后端觉得自己写完了前端却因为字段名对不上反复联调是最浪费时间的事。这套项目的接口文档可以从接口域、统一返回结构、分页约定、权限校验四个维度去理解。4.1 接口域划分与统一返回结构接口按业务域划分。登录认证模块一组资产管理一组领用归还一组维修一组盘点一组处置一组系统管理一组。每个域下有增删改查和业务操作两类接口。比如资产管理域有查询、新增、修改、删除基础接口还有批量导入、资产标签打印这类业务接口领用域有申请、审批、归还三个核心接口。统一返回结构是前后端协作最关键的部分。后端所有接口返回格式保持{ code: 200, message: 操作成功, data: {} }code 为 200 表示成功401 表示未登录或 token 过期500 表示业务异常。前端 axios 响应拦截器统一判断 code非 200 就直接弹错误提示不用每个页面重复写错误分支。分页查询的返回结构也要统一data 里固定包含 total 和 records 两个字段records 是当前页数据列表前端拿到后直接绑定表格。4.2 JWT 登录认证与接口鉴权登录接口收到用户名密码后校验通过生成一个 JWT tokentoken 里包含用户 ID 和角色编码有效时间一般是 24 小时。后续所有接口请求在 header 里带 Authorization: Bearer token后端拦截器统一解析 token拿到当前用户信息后放到 ThreadLocal 里业务层可以直接取当前操作人。接口鉴权不需要在每个方法里写判断。用自定义注解定义权限标识比如 RequirePermission(asset:add)拦截器解析注解后跟当前用户的权限集合做匹配。没有权限直接返回 code 403。这种设计在代码层面很干净答辩时也容易讲清楚。需要注意拦截器要放行登录接口和 doc.html 接口否则前端没法登录、接口文档也打不开这个坑我见过不少人踩。4.3 分页查询与模糊搜索的通用约定分页查询是列表页的核心。接口参数约定为 pageNum、pageSize条件参数按业务追加。例如资产查询接口 GET /api/asset/query?pageNum1pageSize10assetName笔记本deptId2status1。后端用 MyBatis-Plus 的 Page 对象接收条件构造器按非空参数拼接模糊查询。模糊查询默认用 like 而不是等于静态工具类里统一处理。这样每个列表页只需要传一个对象不用为每种查询条件单独写方法。5. 从零跑通项目环境、配置与初始化实操我第一次跑这套项目时前后端花了半小时才全起来踩了几个不高明但很真实的坑。下面把最顺畅的启动路径写一遍照着操作基本不会卡。5.1 环境清单版本别乱配后端依赖 Java 和 Maven前端依赖 Node.js。常用的搭配是 JDK 1.8 或 11、Maven 3.6、Node 14 到 16 之间、MySQL 5.7 或 8.0。特别注意 Java 17 上跑 SpringBoot 2.7 基本没问题但有些老版本 JDK 编译参数会报错最好直接按项目内 .gitignore 或 pom.xml 里的版本约定来。Node 版本太高容易触发依赖安装失败我建议用 nvm 管理多版本装 Node 14 最稳。5.2 导入 SQL 脚本并初始化数据库用 Navicat 或命令行登录 MySQL新建数据库 zcms字符集选 utf8mb4然后执行 sql 脚本。执行完后确认一下表数量和初始化数据条数。常见问题有两个一是 MySQL 8.0 和 5.7 的驱动 URL 写法略有差异8.0 需要加时区参数 serverTimezoneAsia/Shanghai二是如果表名或字段名用了 keyword 关键字比如 order、status在 SQL 里要用反引号包起来。执行脚本报错时先看第一个报错通常第一个错就是根因后面的错误往往是连锁反应。5.3 后端启动配置与常见报错后端启动前改 application.yml 里的数据库连接用户名和密码改成自己的。如果数据库端口不是默认 3306也要一并改。启动 SpringBoot 后看控制台日志出现 Tomcat started on port 8080 说明启动成功。常见报错是数据库连接失败先 ping 数据库地址再检查密码注意 MySQL 8.0 的密码加密方式默认 caching_sha2_password旧驱动不兼容要换 mysql-connector-java 版本或改用 mysql_native_password。Knife4j 接口文档地址是 http://localhost:8080/doc.html启动后先打开它验证接口是否正常。登录接口可以先在文档页面直接调试返回 code 200 说明后端全链路没问题。5.4 前端安装依赖与代理配置前端目录打开终端执行 npm install如果网络不好可以在项目里配置淘宝镜像源。安装成功后 npm run dev 启动开发服务器默认端口 8081 或 9527看配置。前端页面要访问后端接口开发环境下通过 proxy 代理避免跨域。vue.config.js 里配置 devServer 的 proxy把 /api 前缀的请求转发到 http://localhost:8080。这样浏览器里请求的是前端地址后端收不到跨域报错。如果不用代理直接请求后端需要后端开启 CORS但毕设项目建议用代理少一个跨域问题。5.5 登录系统验证核心链路浏览器打开前端地址用 SQL 脚本里初始化的管理员账号登录。登录成功后先看仪表盘统计是否能显示再看资产列表能不能查出数据。接着走一遍核心链路验证系统完整性新增一条资产给这台资产发起领用申请用审批账号通过申请再执行归还。这几个操作连续做完说明前后端、数据库、权限四条链路全部通畅。6. 开发和答辩时最容易暴露的三个薄弱点代码跑通只是及格要拿高分得把几个薄弱点提前补上。这些点是我看过很多毕设代码后总结出来的共性问题这个项目里虽然已经处理过但建议从原理上理解因为答辩大概率会被问到。6.1 时间、金额与 ID 精度问题前端表格里时间显示成时间戳或带 T 的字符串是最常见的低级问题。解决办法是后端全局配置 Jackson 序列化格式统一为 yyyy-MM-dd HH:mm:ss前端再配合 dayjs 做一次格式化双保险。金额字段必须用 BigDecimal不能用 double否则 Excel 导入数据后可能出现 0.001 的精度误差。如果资产表主键用了雪花 IDLong 类型传到前端会因为 JS 精度限制丢最后几位解决办法是后端在 VO 里把 ID 转成字符串返回。这个项目如果用自增 ID 就没这问题但知道总比不知道好。6.2 演示数据准备别让老师看空列表实际验收演示时如果数据库里只有几条测试数据页面稀稀拉拉观感很差。建议在 SQL 脚本之外单独准备一份演示数据脚本至少包含十个左右部门、三级资产分类、五十条左右的资产记录覆盖不同状态、几条待审批的领用申请、几条维修记录、一条进行中的盘点任务。这样打开页面每个模块都有内容可点演示节奏也顺。6.3 高频答辩问题与回答思路老师最常问的方向有五个。为什么用 JWT 而不用 Session回答点是无状态、适合前后端分离、扩展性好。资产状态怎么保证一致回答点是所有状态变更走 service 层事务方法记录表和资产表在同一事务里更新。权限控制怎么实现的回答点是 RBAC 注解 拦截器三件套。前端权限和后端权限怎么配合回答点是菜单动态渲染和接口注解双重控制。报表统计怎么做的回答点是用 SQL 聚合查询按分类、部门、状态分组。每个问题都要能从表结构讲到代码位置不要只会念 PPT。6.4 一个能提升项目档次的扩展方向如果还有余力建议给系统加一个 Excel 批量导入导出功能。高校资产盘点时不可能一条条录通常用模板导入。后端集成 EasyExcel前端用上传组件提交文件模板里包含资产分类、型号、价格等字段导入时按编号规则自动生成资产编号导出时把查询结果直接写回 Excel。这个功能能同时覆盖导入、导出、文件解析三个考点答辩时非常能打。说到最后这套系统的每个表、每个接口、每段代码跑通并不难难的是理解它为什么这么设计。我实际跑项目时最大的体会是先把 SQL 脚本读懂再去调接口、看页面效率比从 controller 硬啃高很多。如果你想拿它做毕设建议在跑通之后把分类表改成教材分类、把处置流程改成报废审批流程这类小改造做一遍——既证明代码是看懂的又能让项目脱离模板感。遇到启动问题也别慌先看日志、再看配置、最后查网络九成问题都出在这三处。
