做这个东西之前我其实已经看过不少毕业设计和课设选题十个人里至少有六七个会选管理系统类。但真正上手去写一个发布出来、能跑通、能提交的完整项目时很多人卡壳的点根本不是不会写代码而是不知道一个像样的系统到底该有哪些模块、数据库怎么设计、前端怎么跟后端配合。这也是我想把这个基于 Java Vue 的房产租赁管理系统拆开来聊一聊的原因。这套系统的核心价值很直接房源信息归集、租客资料管理、合同台账、租金账单、历史租约记录全部通过一个 Web 系统串起来。后端我用的是 Java 系主流框架 Spring Boot MyBatis Plus前端是 Vue 2 Element UI数据库选的 MySQL 5.7。整体难度正好卡在能锻炼工程能力又不至于写完吐血的区间。无论你是准备交课程设计、毕业设计还是想在公司内部搞一套小工具这套系统的底层逻辑都能直接用。下面我按实际开发顺序把从选型、设计到联调、部署的全过程掰开讲顺带把每次踩坑的细节也写进去你会看到哪些坑是人人都会遇到的。1. 为什么选 Java Vue这套组合到底好在哪有人选 Python 的 Django有人选 PHP但管理系统的课设题里Java 依然是出镜率最高的那个。原因不是我偏心而是 Java 的技术栈在业务管理系统这个场景下有着别的组合很难复制的三个特点。1.1 Spring Boot 让后端开发回归业务本身如果早几年用 SSH 那套写法光配置文件就能写半本笔记。但换成 Spring Boot 之后你只需要一个启动类、一个 application.yml再加上几个注解Controller 就出来了。MyBatis Plus 更进一步连单表的增删改查都不用写 XML直接用 BaseMapper 里的方法就能完成大部分操作这让我能把精力集中在业务逻辑上而不是跟 JDBC 的 try-catch 搏斗。1.2 Vue 的前后端分离体验比模板引擎好太多过去用 JSP 写管理系统最痛苦的是 HTML、Java、SQL 混在一起改一个表格样式都可能连带碰到后端代码。Vue 这套玩法是彻底分离前端写页面通过 Axios 调后端接口再把拿到的 JSON 数据渲染成表格。你在开发时甚至可以同时开着两个本地端口前端 8080、后端 8081互相之间用代理转发调试体验非常顺畅。1.3 这套组合的学习成本到底高不高说句实话如果你已经有 Java Web 基础学 Spring Boot 的入门成本并不高。Vue 也一样只要弄懂数据绑定组件通信路由跳转这三个概念初中级别的管理系统前端就能写。真正的难度在于完整地做出来这个动作比如打包、部署、跨域、登录状态保持这恰恰是很多教程不会细讲的部分也是这篇文章后续会重点覆盖的内容。2. 业务模块拆解一套系统到底在管哪些事很多同学拿到房产租赁管理系统这个题目时脑子里只有要能添加房源但真正到了选题答辩老师问一句你系统里租房合同到期怎么提醒就卡住了。一个合格的租赁管理系统至少需要覆盖五个核心业务域我把他们拆开列一下。2.1 基础数据管理房源与租客房源和租客是整个系统的数据地基。房源需要记录的字段包括房源编号、产权证号、房屋地址、所在小区、户型几室几厅、面积、楼层、朝向、装修情况、配置设施空调、洗衣机、宽带、当前状态未出租/已出租/停用、租金定价等。租客的表单比房源简单一些但身份证号、居住证、紧急联系人这类字段必须预留而且要加入学籍校验——证件号输入错了后面合同签了后台数据改起来非常麻烦。我用的是前端做格式校验后端再用 Hibernate Validator 做一次兜底校验两边都不能少。2.2 合同管理租期、租金、押金一体的核心业务合同表是整个系统的核心很多关键业务逻辑都在此体现常见的字段如合同编号、租客 ID、房源 ID、签约日期、起租日期、到期日期、月租金、押金、付款方式月付/季付/半年付/年付、物业费归属、违约金条款、合同状态执行中/已到期/已退租等。最值得做的业务操作是自动算租期给定起租日期和租期月数自动算出到期日。还要支持提前退租和续租两套流程提前退租要计算违约金续租要更新合同起止日期而不产生新的房源状态切换。2.3 账单管理租金、物业费与水电气台账账单模块让系统从台账记录升级为业务系统。我建议拆成两张表一张是应收账单表记录每期该收多少钱另外一张是收款记录表记录实际收到的金额和收款时间。一对比就能看出哪些租客欠费。应收账单的生成逻辑根据合同里的付款周期在合同生效的那一刻就自动生成未来 6 个月甚至整个租期的账单这件事用定时任务最好也可以做成点击生成账单的按钮优先用按钮因为课设里演示效果更直观。2.4 统计报表让数据在首页说话管理系统如果没有首页统计就像账本没有封面虽然能用但总觉得缺了点什么。我用 ECharts 做了三块统计每月租金收入折线图、房源状态占比饼图、到期的合同列表。这些数据的后端接口就几个 SQL 聚合查询并不复杂但在答辩演示时非常加分。2.5 权限控制区分管理员与普通操作员最基础的做法是用户表里用 role 字段区分 admin 和 operatoradmin 能看所有菜单、能删除数据operator 只能管理租客和房源不能动合同和财务报表。后端用拦截器拦截请求判断 session 里的用户角色权限不足直接返回 403。这部分的重点是讲解为什么不能只在前端隐藏按钮——因为只要知道了接口地址就能直接调所以后端必须做同样的拦截。3. 数据库设计7张核心表是怎么规划出来的数据库设计是整个项目里最考验预判能力的部分。表建好了后面所有业务延伸都会很顺手表建烂了后期每个功能都像在补窟窿。我最终按下面这个结构设计一共 7 张核心表再加一张系统日志表和一张用户表一共 9 张。3.1 表的清单与职责划分表名中文名主要字段简写关键说明sys_user系统用户id, username, password, real_name, rolepassword 存储 MD5 或 BCrypt 加密后的值house房屋信息id, house_code, address, unit_type, area, floor, orientation, renovation, facilities, statusstatus 为 0 未出租、1 已出租、2 停用tenant租客信息id, tenant_no, name, id_card, phone, emergency_name, emergency_phone, remark身份证唯一索引lease_contract租赁合同id, contract_no, house_id, tenant_id, start_date, end_date, monthly_rent, deposit, pay_cycle, statushouse_id 和 tenant_id 建立外键索引bill_receivable应收账单id, contract_id, period, amount, due_date, statusstatus0 未收、1 已收、2 逾期payment_record收款记录id, bill_id, contract_id, pay_amount, pay_time, pay_method保留 contract_id 便于按合同查历史house_change_log房屋变更记录id, house_id, old_status, new_status, change_time, reason退租、入住都会产生记录3.2 设计时反复推敲的几个决策主键统一用自增 int不折腾雪花算法单机课设完全够用。身份证号在 tenant 表上加了唯一索引避免同一个租客录入两次。合同与房屋是一对一关系但因为存在退租——新合同的切换所以房屋状态要用独立 status 字段而不能靠是否有合同来判断否则一旦合同做废就会出逻辑漏洞。另一个重要的决策是应收账单独立成表。有同学会把租金直接写进合同表每月收没收到只改一个 SELECT 查询里的值。这样表面省事但无法追溯这个月这笔钱到底收没收、哪一天收的。拆成 bill 和 payment 两张表后业务上可以做对账也就有了做数据可视化的基础数据。3.3 SQL 示例创建房屋表下面给出房屋表的创建语句其他表的思路类似。需要说明的是抵押字段和默认值要根据你自己的物管产品设计定我这里只是一个参考。CREATE TABLE house ( id int(11) NOT NULL AUTO_INCREMENT, house_code varchar(32) NOT NULL COMMENT 房源编号, address varchar(255) NOT NULL COMMENT 详细地址, unit_type varchar(32) DEFAULT 1室1厅 COMMENT 户型, area decimal(10,2) DEFAULT NULL COMMENT 面积, floor varchar(16) DEFAULT NULL COMMENT 楼层, orientation varchar(16) DEFAULT NULL COMMENT 朝向, renovation varchar(32) DEFAULT NULL COMMENT 装修情况, facilities varchar(255) DEFAULT NULL COMMENT 配置设施逗号分隔, rent_price decimal(10,2) DEFAULT NULL COMMENT 参考月租价, status tinyint(1) DEFAULT 0 COMMENT 0未出租 1已出租 2停用, create_time datetime DEFAULT NULL, update_time datetime DEFAULT NULL, PRIMARY KEY (id), UNIQUE KEY uk_house_code (house_code) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT房屋信息表;注意rent_price代表的是参考售价实际成交租金应该以合同里的 monthly_rent 为准。一开始我把两个字段放混了导致改价后合同里也自动变逻辑上很危险。后来改成房源表只存参考价合同表存成交价两者不再互相影响。4. 后端实现中的关键逻辑登录、合同、租金计算后端代码里最容易丢分的点往往不是 CRUD而是那些不直接对应一张表的业务逻辑。这里我挑三个重点讲每个都附上实现思路你可以直接抄作业。4.1 登录鉴权与会话保持单机管理系统不需要引入 JWT 这种复杂的方案用 Servlet 的 Session 就够了。用户登录成功后把 user 对象放进 session前端每次请求携带 cookie后端用一个拦截器统一校验。拦截器里需要注意的是放行名单登录接口、静态资源、前端首页的路由接口不需要鉴权其余 API 全部拦截。举例来说如果没登录就请求/api/house/list后端直接返回 401 状态码。前端在 axios 的响应拦截器里统一判断 401然后强制跳回登录页。public class AuthInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { HttpSession session request.getSession(); Object user session.getAttribute(loginUser); if (user null) { response.setStatus(401); return false; } return true; } }要额外处理的一点是前端路由鉴权你可以在 Vue 的路由配置里写 meta 字段比如{ path: /house, component: HouseList, meta: { requiresAuth: true } }在 beforeEach 导航守卫里检查 token 或自己的登录状态。4.2 自动计算租期与续租/退租逻辑这是最容易被人问你这里是怎么处理的的地方。租期计算用 Java 的LocalDate非常方便且不易踩坑。比如合同起租日是 2023-07-01租期 12 个月到期日就是startDate.plusMonths(12).minusDays(1)注意一定要减一天因为租到 2024-07-01 的 0 点结束实际最后一天是 2024-06-30。续租操作把旧合同状态改为已续租然后创建一个新合同起租日期为旧合同到期日加一天租期重新填。房屋状态在旧合同退租和新合同生效中间要维护好。退租操作首先校验是不是有未缴纳的应收账单有的话提示先结清账单然后清空租客与房源之间的绑定house.status设为 0未出租收押金退回记录 house_change_log。这里必须用一个事务方法包起来任何一步抛异常都整体回滚避免出现房子解绑了但账单还挂着这种脏数据。Transactional(rollbackFor Exception.class) public void terminateContract(Contract contract) { // 1. 校验账单 int unpaid billReceivableMapper.countUnpaid(contract.getId()); if (unpaid 0) throw new BizException(该合同存在未结清账单请先收款处理); // 2. 更新合同状态 contract.setStatus(3); // 已退租 contractMapper.updateById(contract); // 3. 房屋释放 houseMapper.updateStatus(contract.getHouseId(), 0); // 4. 记录日志 houseChangeLogMapper.insert(new HouseChangeLog(...)); }4.3 账单自动生成的算法应收账单生成规则按合同里的付款周期把租期拆成多个期数。如果租期是 12 个月、月付那就生成 12 条 bill。如果租期是 12 个月、季付那就生成 4 条 bill。生成时每期金额相同到期日按起租日期逐期增加。这里要特别注意跨年或中途价格调整的情况所以账单里的 amount 字段应该在生成时冻结下来不要关联合同金额做实时计算。合同签的是月租 1800首月到期日前系统自动账单哪怕后面改合同金额之前已生成的账单也不能随之变化不然对账就对不上了。5. 前端页面的组织方式与 API 对接案例前端我用的 Vue CLI 2.x 版本对应 Vue 2配 Element UI 组件库。页面结构上不怎么需要精细到布局重点是把按钮、表格、弹窗、表单校验串起来。5.1 页面结构分包与复用项目目录我会分成views、components、api和router四块。页面按业务模块建目录views/house/index.vue房源列表、views/tenant/index.vue租客列表、views/contract/index.vue合同列表、views/bill/index.vue账单列表。每个页面里如果有新增/编辑弹窗单独拆一个 dialog 组件放在同目录下不要全部堆在一个文件里改起来会心态爆炸。5.2 请求封装与跨域处理axios 的封装是前端工程化的第一步核心是统一 baseURL、统一携带 cookie、统一处理 401。我一般在api/request.js里创建一个实例设置baseURL: /api并配置withCredentials: true这样会话 cookie 才能被后端识别。本地开发时的跨域问题用 Vue CLI 里的 devServer 代理解决。修改vue.config.jsmodule.exports { devServer: { port: 8080, proxy: { /api: { target: http://localhost:8081, changeOrigin: true } } } }在这套配置下前端请求/api/house/list会被转发到后端的/api/house/list后端不会再出现跨域报错。生产环境部署时把后端接口通过 Nginx 反向代理到同一域名下也基本是同理。5.3 列表展示的实战代码片段下面这段代码是从合同列表页面抽出来的核心思路。重点是翻页数据回填和操作按钮的事件绑定。template div el-table :datatableData border stripe v-loadingloading el-table-column propcontractNo label合同编号 / el-table-column proptenantName label租客 / el-table-column prophouseAddress label房源地址 / el-table-column propmonthlyRent label月租金 / el-table-column propendDate label到期日 / el-table-column label操作 template slot-scope{ row } el-button typetext clickopenDetail(row)详情/el-button el-button typetext clickdoTerminate(row)退租/el-button /template /el-table-column /el-table el-pagination layouttotal, prev, pager, next :totaltotal :current-pagequeryParams.pageNum :page-sizequeryParams.pageSize current-changehandlePageChange / /div /template script import { listContract } from /api/contract export default { data() { return { tableData: [], total: 0, loading: false, queryParams: { pageNum: 1, pageSize: 10 } } }, created() { this.fetchList() }, methods: { async fetchList() { this.loading true const res await listContract(this.queryParams) this.tableData res.data.rows this.total res.data.total this.loading false }, handlePageChange(page) { this.queryParams.pageNum page this.fetchList() } } } /script值得提的一个小坑表格里的tenantName和houseAddress在合同表里其实并不存在是后端在做列表查询时通过 left join 查出并封装到 VO 里的。前端直接绑 VO 的字段名省了每行去调一个详情接口。这个设计在课设里是加分项。5.4 Element UI 表单校验收不住手租客身份证号校验、手机号校验、金额输入范围这些都是 EL-Form 自带能力。我在租客表单里用rules对象配置了required: true和pattern其中身份证的pattern是从网上搜到的通用正则。关键并不是这条正则多准确而是在提交按钮里不要忘了加上this.$refs.form.validate()的判断否则校验不出声也照样提交很影响体验。6. 运行部署全流程从代码到本地跑起来项目交付时能跑起来是第一印象。很多人源码写了最后却因为环境搭建问题在老师面前翻车。我整理了一套近乎保姆级别的步骤配好环境后十分钟内就能把整站跑起来。6.1 本地环境要求软件版本建议说明JDK8 或 11太新的版本如 17 可能遇到兼容性问题Maven3.6用来拉依赖和打包MySQL5.7 或 8.0注意 8.0 的驱动差异Node.js14 或 16Vue 2 项目尽量避免 Node 18 以上浏览器Chrome/Edge仅调试用6.2 数据库初始化的步骤项目目录下会有sql/rent_manage.sql文件里面包含建表和示例数据。如果你拿到的源码里没有那就自己导一份。执行顺序很重要先建库再选库再导入 SQL。mysql -uroot -p create database rent_manage default character set utf8mb4; use rent_manage; source /你的绝对路径/rent_manage.sql;导入后检查一下表数量我这次是 9 张表并且sys_user里已经有admin用户。如果 SQL 里没有初始用户你要在启动后端前手动插入一条记录否则会登录不了。6.3 后端启动三步走第一步用 IDEA 打开后端工程等 Maven 下载完依赖时间可能较长。第二步修改application.yml里的数据库连接参数spring: datasource: url: jdbc:mysql://localhost:3306/rent_manage?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai username: root password: yourpassword第三步运行RentManageApplication.java的主方法看到控制台输出 Started RentManageApplication 就算启动成功。默认端口 8081简单验证浏览器访问http://localhost:8081/api/house/list未登录时应该返回 401 JSON说明接口已经活着。6.4 前端启动与打包前端在另一个终端窗口中执行npm install npm run serve如果npm install太慢可以用npm config set registry https://registry.npmmirror.com换源。启动后访问http://localhost:8080。开发环境接口代理已经在vue.config.js里配好直接登录即可。要打包上传到服务器的话执行npm run build把生成的dist/目录用 Nginx 托管并把接口路径/api反向代理到后端端口类似location /api/ { proxy_pass http://127.0.0.1:8081/api/; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; }如果不做代理前端打包后请求会 404这是最常见的一个部署误区。7. 排错实录与扩展建议我踩过的坑和后续玩法这是本篇最想让你仔细看的部分全是实际开发里冒出来的问题有些甚至教材里根本不会提。7.1 列表接口能通但是跨域报错了开发模式下只要出现跨域报错十次里有九次是后端没把数据正确返回或者代理没配置生效。先确认前端请求地址是/api/house/list而不是http://localhost:8081/api/house/list。前者经过代理是同源请求后者是跨域请求请避免直接在 axios 里写死端口号。7.2 合同日期计算的经典翻车现场我最早写租期计算时endDate startDate.plusMonths(month)没有减一天结果合同显示 2024-07-01 到期当天系统判定为逾期。后来改为减一天逻辑才通顺。如果你拿到任何源码里有类似的日期 bug不要犹豫直接用 LocalDate 重写一遍。7.3 数据库字符集导致中文乱码这几乎是必现的坑。创建表时如果是默认 latin1全部中文都会变成问号。解决办法是确保建库语句带default character set utf8mb4并且 Spring 的配置里加上characterEncodingutf8。两个地方都做对才能彻底避免乱码。7.4 扩展成多角色、多租户甚至小程序端现在这套系统的用户表只有 admin 和 operator 两种角色但稍微扩展一下就能变成多房东多门店的系统给house表加owner_id给contract表加branch_id再用一个数据权限拦截器让不同门店只能看自己的数据。前端如果想做小程序或移动端可以直接复用这套 Java 后端接口用 uni-app 或原生小程序框架再写一个壳就行。7.5 把文档写清楚比功能全还重要你的交付物里包含文档那就一定要在 README 里写清楚环境依赖、数据库导入命令、默认账号、后端启动入口、前端启动入口、项目结构说明。很多评阅老师不看源码只看你能不能按文档把东西跑起来。我建议你在写完项目后从零开始按 README 走一遍流程会发现我以为自己写清楚了结果还是有地方漏了。写到最后想说的这套系统的开发过程本质上是一场从零开始把一个业务域变成数据模型的练习。你会遇到接口设计时的纠结、遇到前端表格渲染不出数据时的沮丧、也会遇到部署成功后眼睁睁看着系统跑通的满足感。我在实际开发里最大的体会是别想着一步到位先把最核心的房源、合同、账单闭环跑通再加入统计、权限这类增值模块。而且一定要记住源码只是初始材料数据库里每一条样例数据、文档里每一句使用说明都体现了你对这个业务域的理解程度。做完之后强烈建议你再回头把house_change_log和应收账单的对账功能完善一下这两块很多人会忽略但它们恰恰是现实中租赁业务真正离不开的底子。
做这个东西之前我其实已经看过不少毕业设计和课设选题十个人里至少有六七个会选管理系统类。但真正上手去写一个发布出来、能跑通、能提交的完整项目时很多人卡壳的点根本不是不会写代码而是不知道一个像样的系统到底该有哪些模块、数据库怎么设计、前端怎么跟后端配合。这也是我想把这个基于 Java Vue 的房产租赁管理系统拆开来聊一聊的原因。这套系统的核心价值很直接房源信息归集、租客资料管理、合同台账、租金账单、历史租约记录全部通过一个 Web 系统串起来。后端我用的是 Java 系主流框架 Spring Boot MyBatis Plus前端是 Vue 2 Element UI数据库选的 MySQL 5.7。整体难度正好卡在能锻炼工程能力又不至于写完吐血的区间。无论你是准备交课程设计、毕业设计还是想在公司内部搞一套小工具这套系统的底层逻辑都能直接用。下面我按实际开发顺序把从选型、设计到联调、部署的全过程掰开讲顺带把每次踩坑的细节也写进去你会看到哪些坑是人人都会遇到的。1. 为什么选 Java Vue这套组合到底好在哪有人选 Python 的 Django有人选 PHP但管理系统的课设题里Java 依然是出镜率最高的那个。原因不是我偏心而是 Java 的技术栈在业务管理系统这个场景下有着别的组合很难复制的三个特点。1.1 Spring Boot 让后端开发回归业务本身如果早几年用 SSH 那套写法光配置文件就能写半本笔记。但换成 Spring Boot 之后你只需要一个启动类、一个 application.yml再加上几个注解Controller 就出来了。MyBatis Plus 更进一步连单表的增删改查都不用写 XML直接用 BaseMapper 里的方法就能完成大部分操作这让我能把精力集中在业务逻辑上而不是跟 JDBC 的 try-catch 搏斗。1.2 Vue 的前后端分离体验比模板引擎好太多过去用 JSP 写管理系统最痛苦的是 HTML、Java、SQL 混在一起改一个表格样式都可能连带碰到后端代码。Vue 这套玩法是彻底分离前端写页面通过 Axios 调后端接口再把拿到的 JSON 数据渲染成表格。你在开发时甚至可以同时开着两个本地端口前端 8080、后端 8081互相之间用代理转发调试体验非常顺畅。1.3 这套组合的学习成本到底高不高说句实话如果你已经有 Java Web 基础学 Spring Boot 的入门成本并不高。Vue 也一样只要弄懂数据绑定组件通信路由跳转这三个概念初中级别的管理系统前端就能写。真正的难度在于完整地做出来这个动作比如打包、部署、跨域、登录状态保持这恰恰是很多教程不会细讲的部分也是这篇文章后续会重点覆盖的内容。2. 业务模块拆解一套系统到底在管哪些事很多同学拿到房产租赁管理系统这个题目时脑子里只有要能添加房源但真正到了选题答辩老师问一句你系统里租房合同到期怎么提醒就卡住了。一个合格的租赁管理系统至少需要覆盖五个核心业务域我把他们拆开列一下。2.1 基础数据管理房源与租客房源和租客是整个系统的数据地基。房源需要记录的字段包括房源编号、产权证号、房屋地址、所在小区、户型几室几厅、面积、楼层、朝向、装修情况、配置设施空调、洗衣机、宽带、当前状态未出租/已出租/停用、租金定价等。租客的表单比房源简单一些但身份证号、居住证、紧急联系人这类字段必须预留而且要加入学籍校验——证件号输入错了后面合同签了后台数据改起来非常麻烦。我用的是前端做格式校验后端再用 Hibernate Validator 做一次兜底校验两边都不能少。2.2 合同管理租期、租金、押金一体的核心业务合同表是整个系统的核心很多关键业务逻辑都在此体现常见的字段如合同编号、租客 ID、房源 ID、签约日期、起租日期、到期日期、月租金、押金、付款方式月付/季付/半年付/年付、物业费归属、违约金条款、合同状态执行中/已到期/已退租等。最值得做的业务操作是自动算租期给定起租日期和租期月数自动算出到期日。还要支持提前退租和续租两套流程提前退租要计算违约金续租要更新合同起止日期而不产生新的房源状态切换。2.3 账单管理租金、物业费与水电气台账账单模块让系统从台账记录升级为业务系统。我建议拆成两张表一张是应收账单表记录每期该收多少钱另外一张是收款记录表记录实际收到的金额和收款时间。一对比就能看出哪些租客欠费。应收账单的生成逻辑根据合同里的付款周期在合同生效的那一刻就自动生成未来 6 个月甚至整个租期的账单这件事用定时任务最好也可以做成点击生成账单的按钮优先用按钮因为课设里演示效果更直观。2.4 统计报表让数据在首页说话管理系统如果没有首页统计就像账本没有封面虽然能用但总觉得缺了点什么。我用 ECharts 做了三块统计每月租金收入折线图、房源状态占比饼图、到期的合同列表。这些数据的后端接口就几个 SQL 聚合查询并不复杂但在答辩演示时非常加分。2.5 权限控制区分管理员与普通操作员最基础的做法是用户表里用 role 字段区分 admin 和 operatoradmin 能看所有菜单、能删除数据operator 只能管理租客和房源不能动合同和财务报表。后端用拦截器拦截请求判断 session 里的用户角色权限不足直接返回 403。这部分的重点是讲解为什么不能只在前端隐藏按钮——因为只要知道了接口地址就能直接调所以后端必须做同样的拦截。3. 数据库设计7张核心表是怎么规划出来的数据库设计是整个项目里最考验预判能力的部分。表建好了后面所有业务延伸都会很顺手表建烂了后期每个功能都像在补窟窿。我最终按下面这个结构设计一共 7 张核心表再加一张系统日志表和一张用户表一共 9 张。3.1 表的清单与职责划分表名中文名主要字段简写关键说明sys_user系统用户id, username, password, real_name, rolepassword 存储 MD5 或 BCrypt 加密后的值house房屋信息id, house_code, address, unit_type, area, floor, orientation, renovation, facilities, statusstatus 为 0 未出租、1 已出租、2 停用tenant租客信息id, tenant_no, name, id_card, phone, emergency_name, emergency_phone, remark身份证唯一索引lease_contract租赁合同id, contract_no, house_id, tenant_id, start_date, end_date, monthly_rent, deposit, pay_cycle, statushouse_id 和 tenant_id 建立外键索引bill_receivable应收账单id, contract_id, period, amount, due_date, statusstatus0 未收、1 已收、2 逾期payment_record收款记录id, bill_id, contract_id, pay_amount, pay_time, pay_method保留 contract_id 便于按合同查历史house_change_log房屋变更记录id, house_id, old_status, new_status, change_time, reason退租、入住都会产生记录3.2 设计时反复推敲的几个决策主键统一用自增 int不折腾雪花算法单机课设完全够用。身份证号在 tenant 表上加了唯一索引避免同一个租客录入两次。合同与房屋是一对一关系但因为存在退租——新合同的切换所以房屋状态要用独立 status 字段而不能靠是否有合同来判断否则一旦合同做废就会出逻辑漏洞。另一个重要的决策是应收账单独立成表。有同学会把租金直接写进合同表每月收没收到只改一个 SELECT 查询里的值。这样表面省事但无法追溯这个月这笔钱到底收没收、哪一天收的。拆成 bill 和 payment 两张表后业务上可以做对账也就有了做数据可视化的基础数据。3.3 SQL 示例创建房屋表下面给出房屋表的创建语句其他表的思路类似。需要说明的是抵押字段和默认值要根据你自己的物管产品设计定我这里只是一个参考。CREATE TABLE house ( id int(11) NOT NULL AUTO_INCREMENT, house_code varchar(32) NOT NULL COMMENT 房源编号, address varchar(255) NOT NULL COMMENT 详细地址, unit_type varchar(32) DEFAULT 1室1厅 COMMENT 户型, area decimal(10,2) DEFAULT NULL COMMENT 面积, floor varchar(16) DEFAULT NULL COMMENT 楼层, orientation varchar(16) DEFAULT NULL COMMENT 朝向, renovation varchar(32) DEFAULT NULL COMMENT 装修情况, facilities varchar(255) DEFAULT NULL COMMENT 配置设施逗号分隔, rent_price decimal(10,2) DEFAULT NULL COMMENT 参考月租价, status tinyint(1) DEFAULT 0 COMMENT 0未出租 1已出租 2停用, create_time datetime DEFAULT NULL, update_time datetime DEFAULT NULL, PRIMARY KEY (id), UNIQUE KEY uk_house_code (house_code) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT房屋信息表;注意rent_price代表的是参考售价实际成交租金应该以合同里的 monthly_rent 为准。一开始我把两个字段放混了导致改价后合同里也自动变逻辑上很危险。后来改成房源表只存参考价合同表存成交价两者不再互相影响。4. 后端实现中的关键逻辑登录、合同、租金计算后端代码里最容易丢分的点往往不是 CRUD而是那些不直接对应一张表的业务逻辑。这里我挑三个重点讲每个都附上实现思路你可以直接抄作业。4.1 登录鉴权与会话保持单机管理系统不需要引入 JWT 这种复杂的方案用 Servlet 的 Session 就够了。用户登录成功后把 user 对象放进 session前端每次请求携带 cookie后端用一个拦截器统一校验。拦截器里需要注意的是放行名单登录接口、静态资源、前端首页的路由接口不需要鉴权其余 API 全部拦截。举例来说如果没登录就请求/api/house/list后端直接返回 401 状态码。前端在 axios 的响应拦截器里统一判断 401然后强制跳回登录页。public class AuthInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { HttpSession session request.getSession(); Object user session.getAttribute(loginUser); if (user null) { response.setStatus(401); return false; } return true; } }要额外处理的一点是前端路由鉴权你可以在 Vue 的路由配置里写 meta 字段比如{ path: /house, component: HouseList, meta: { requiresAuth: true } }在 beforeEach 导航守卫里检查 token 或自己的登录状态。4.2 自动计算租期与续租/退租逻辑这是最容易被人问你这里是怎么处理的的地方。租期计算用 Java 的LocalDate非常方便且不易踩坑。比如合同起租日是 2023-07-01租期 12 个月到期日就是startDate.plusMonths(12).minusDays(1)注意一定要减一天因为租到 2024-07-01 的 0 点结束实际最后一天是 2024-06-30。续租操作把旧合同状态改为已续租然后创建一个新合同起租日期为旧合同到期日加一天租期重新填。房屋状态在旧合同退租和新合同生效中间要维护好。退租操作首先校验是不是有未缴纳的应收账单有的话提示先结清账单然后清空租客与房源之间的绑定house.status设为 0未出租收押金退回记录 house_change_log。这里必须用一个事务方法包起来任何一步抛异常都整体回滚避免出现房子解绑了但账单还挂着这种脏数据。Transactional(rollbackFor Exception.class) public void terminateContract(Contract contract) { // 1. 校验账单 int unpaid billReceivableMapper.countUnpaid(contract.getId()); if (unpaid 0) throw new BizException(该合同存在未结清账单请先收款处理); // 2. 更新合同状态 contract.setStatus(3); // 已退租 contractMapper.updateById(contract); // 3. 房屋释放 houseMapper.updateStatus(contract.getHouseId(), 0); // 4. 记录日志 houseChangeLogMapper.insert(new HouseChangeLog(...)); }4.3 账单自动生成的算法应收账单生成规则按合同里的付款周期把租期拆成多个期数。如果租期是 12 个月、月付那就生成 12 条 bill。如果租期是 12 个月、季付那就生成 4 条 bill。生成时每期金额相同到期日按起租日期逐期增加。这里要特别注意跨年或中途价格调整的情况所以账单里的 amount 字段应该在生成时冻结下来不要关联合同金额做实时计算。合同签的是月租 1800首月到期日前系统自动账单哪怕后面改合同金额之前已生成的账单也不能随之变化不然对账就对不上了。5. 前端页面的组织方式与 API 对接案例前端我用的 Vue CLI 2.x 版本对应 Vue 2配 Element UI 组件库。页面结构上不怎么需要精细到布局重点是把按钮、表格、弹窗、表单校验串起来。5.1 页面结构分包与复用项目目录我会分成views、components、api和router四块。页面按业务模块建目录views/house/index.vue房源列表、views/tenant/index.vue租客列表、views/contract/index.vue合同列表、views/bill/index.vue账单列表。每个页面里如果有新增/编辑弹窗单独拆一个 dialog 组件放在同目录下不要全部堆在一个文件里改起来会心态爆炸。5.2 请求封装与跨域处理axios 的封装是前端工程化的第一步核心是统一 baseURL、统一携带 cookie、统一处理 401。我一般在api/request.js里创建一个实例设置baseURL: /api并配置withCredentials: true这样会话 cookie 才能被后端识别。本地开发时的跨域问题用 Vue CLI 里的 devServer 代理解决。修改vue.config.jsmodule.exports { devServer: { port: 8080, proxy: { /api: { target: http://localhost:8081, changeOrigin: true } } } }在这套配置下前端请求/api/house/list会被转发到后端的/api/house/list后端不会再出现跨域报错。生产环境部署时把后端接口通过 Nginx 反向代理到同一域名下也基本是同理。5.3 列表展示的实战代码片段下面这段代码是从合同列表页面抽出来的核心思路。重点是翻页数据回填和操作按钮的事件绑定。template div el-table :datatableData border stripe v-loadingloading el-table-column propcontractNo label合同编号 / el-table-column proptenantName label租客 / el-table-column prophouseAddress label房源地址 / el-table-column propmonthlyRent label月租金 / el-table-column propendDate label到期日 / el-table-column label操作 template slot-scope{ row } el-button typetext clickopenDetail(row)详情/el-button el-button typetext clickdoTerminate(row)退租/el-button /template /el-table-column /el-table el-pagination layouttotal, prev, pager, next :totaltotal :current-pagequeryParams.pageNum :page-sizequeryParams.pageSize current-changehandlePageChange / /div /template script import { listContract } from /api/contract export default { data() { return { tableData: [], total: 0, loading: false, queryParams: { pageNum: 1, pageSize: 10 } } }, created() { this.fetchList() }, methods: { async fetchList() { this.loading true const res await listContract(this.queryParams) this.tableData res.data.rows this.total res.data.total this.loading false }, handlePageChange(page) { this.queryParams.pageNum page this.fetchList() } } } /script值得提的一个小坑表格里的tenantName和houseAddress在合同表里其实并不存在是后端在做列表查询时通过 left join 查出并封装到 VO 里的。前端直接绑 VO 的字段名省了每行去调一个详情接口。这个设计在课设里是加分项。5.4 Element UI 表单校验收不住手租客身份证号校验、手机号校验、金额输入范围这些都是 EL-Form 自带能力。我在租客表单里用rules对象配置了required: true和pattern其中身份证的pattern是从网上搜到的通用正则。关键并不是这条正则多准确而是在提交按钮里不要忘了加上this.$refs.form.validate()的判断否则校验不出声也照样提交很影响体验。6. 运行部署全流程从代码到本地跑起来项目交付时能跑起来是第一印象。很多人源码写了最后却因为环境搭建问题在老师面前翻车。我整理了一套近乎保姆级别的步骤配好环境后十分钟内就能把整站跑起来。6.1 本地环境要求软件版本建议说明JDK8 或 11太新的版本如 17 可能遇到兼容性问题Maven3.6用来拉依赖和打包MySQL5.7 或 8.0注意 8.0 的驱动差异Node.js14 或 16Vue 2 项目尽量避免 Node 18 以上浏览器Chrome/Edge仅调试用6.2 数据库初始化的步骤项目目录下会有sql/rent_manage.sql文件里面包含建表和示例数据。如果你拿到的源码里没有那就自己导一份。执行顺序很重要先建库再选库再导入 SQL。mysql -uroot -p create database rent_manage default character set utf8mb4; use rent_manage; source /你的绝对路径/rent_manage.sql;导入后检查一下表数量我这次是 9 张表并且sys_user里已经有admin用户。如果 SQL 里没有初始用户你要在启动后端前手动插入一条记录否则会登录不了。6.3 后端启动三步走第一步用 IDEA 打开后端工程等 Maven 下载完依赖时间可能较长。第二步修改application.yml里的数据库连接参数spring: datasource: url: jdbc:mysql://localhost:3306/rent_manage?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai username: root password: yourpassword第三步运行RentManageApplication.java的主方法看到控制台输出 Started RentManageApplication 就算启动成功。默认端口 8081简单验证浏览器访问http://localhost:8081/api/house/list未登录时应该返回 401 JSON说明接口已经活着。6.4 前端启动与打包前端在另一个终端窗口中执行npm install npm run serve如果npm install太慢可以用npm config set registry https://registry.npmmirror.com换源。启动后访问http://localhost:8080。开发环境接口代理已经在vue.config.js里配好直接登录即可。要打包上传到服务器的话执行npm run build把生成的dist/目录用 Nginx 托管并把接口路径/api反向代理到后端端口类似location /api/ { proxy_pass http://127.0.0.1:8081/api/; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; }如果不做代理前端打包后请求会 404这是最常见的一个部署误区。7. 排错实录与扩展建议我踩过的坑和后续玩法这是本篇最想让你仔细看的部分全是实际开发里冒出来的问题有些甚至教材里根本不会提。7.1 列表接口能通但是跨域报错了开发模式下只要出现跨域报错十次里有九次是后端没把数据正确返回或者代理没配置生效。先确认前端请求地址是/api/house/list而不是http://localhost:8081/api/house/list。前者经过代理是同源请求后者是跨域请求请避免直接在 axios 里写死端口号。7.2 合同日期计算的经典翻车现场我最早写租期计算时endDate startDate.plusMonths(month)没有减一天结果合同显示 2024-07-01 到期当天系统判定为逾期。后来改为减一天逻辑才通顺。如果你拿到任何源码里有类似的日期 bug不要犹豫直接用 LocalDate 重写一遍。7.3 数据库字符集导致中文乱码这几乎是必现的坑。创建表时如果是默认 latin1全部中文都会变成问号。解决办法是确保建库语句带default character set utf8mb4并且 Spring 的配置里加上characterEncodingutf8。两个地方都做对才能彻底避免乱码。7.4 扩展成多角色、多租户甚至小程序端现在这套系统的用户表只有 admin 和 operator 两种角色但稍微扩展一下就能变成多房东多门店的系统给house表加owner_id给contract表加branch_id再用一个数据权限拦截器让不同门店只能看自己的数据。前端如果想做小程序或移动端可以直接复用这套 Java 后端接口用 uni-app 或原生小程序框架再写一个壳就行。7.5 把文档写清楚比功能全还重要你的交付物里包含文档那就一定要在 README 里写清楚环境依赖、数据库导入命令、默认账号、后端启动入口、前端启动入口、项目结构说明。很多评阅老师不看源码只看你能不能按文档把东西跑起来。我建议你在写完项目后从零开始按 README 走一遍流程会发现我以为自己写清楚了结果还是有地方漏了。写到最后想说的这套系统的开发过程本质上是一场从零开始把一个业务域变成数据模型的练习。你会遇到接口设计时的纠结、遇到前端表格渲染不出数据时的沮丧、也会遇到部署成功后眼睁睁看着系统跑通的满足感。我在实际开发里最大的体会是别想着一步到位先把最核心的房源、合同、账单闭环跑通再加入统计、权限这类增值模块。而且一定要记住源码只是初始材料数据库里每一条样例数据、文档里每一句使用说明都体现了你对这个业务域的理解程度。做完之后强烈建议你再回头把house_change_log和应收账单的对账功能完善一下这两块很多人会忽略但它们恰恰是现实中租赁业务真正离不开的底子。
攻防全解析：从浏览器特性到纵深防御)
