Java 项目教程《尚庭公寓-下》，单体架构项目，从开发到部署
一、参考资料
【Java项目教程《尚庭公寓》java项目从开发到部署，适合新手其含金量高的Java项目实战】 https://www.bilibili.com/video/BV1At421K7gP/?share_source=copy_web\&vd_source=855891859b2dc554eace9de3f28b4528
尚庭公寓项目 Gitee 地址 https://gitee.com/yangjunbo-jetli/shangting-apartment.git
二、笔记总结
50、用户管理
51、岗位管理
52、用户信息概述
53、用户信息分页查询
54、根据 ID 查询用户信息
55、用户信息保存或更新
56、用户信息剩余接口
57、租约信息分页查询
这个应该是跟着第 46 节后面
58、登录管理认证方案
59、JWT 概述
60、登录流程
61、获取验证码准备工作
62、获取验证码实现
63、登录接口上
64、登录接口下
65、登录管理拦截器
66、查询登录用户信息
67、前后端联调
68、移动端项目初始化
69、登录管理交互流程
70、获取短信验证码上
71、获取短信验证码下
72、注册和登录
73、获取个人信息
74、找房、地区、支付方式接口
75、分页查询房间列表
76、找房剩余接口
77、查询浏览历史接口
78、保存浏览历史接口
79、看房预约接口
80、租约管理接口
81、前后端联调
82、缓存优化
83、部署方案
84、Nginx 快速入门概述
85、Nginx 快速入门案例实操
86、配置域名映射
87、部署后端项目
88、部署前端项目
三、AI 嘚吧（直接忽略）
🏢 Java项目实战：尚庭公寓租赁平台开发与部署全流程
📝 项目背景与概述
尚庭公寓是一个基于单体架构的公寓租赁平台，旨在为用户提供便捷的在线找房、看房预约及租约管理服务，同时为管理员提供强大的后台管理系统。项目采用前后端分离模式开发，涵盖了从公寓信息管理、房间管理、用户管理到核心的签约、续约、退租等完整的租赁业务流程。
🚀 技术选型与架构
项目的技术栈覆盖了当前Java企业级开发的主流框架与中间件，构建了一个高性能、易维护的单体应用。
| 模块 | 技术栈 | 说明 |
|---|---|---|
| 后端框架 | Spring Boot 、Spring MVC | 快速构建应用，处理Web请求与响应 |
| 数据持久层 | MyBatis 、MyBatis Plus | 简化数据库操作，增强CRUD效率 |
| 数据库 | MySQL | 关系型数据库，存储核心业务数据 |
| 缓存 | Redis | 提升数据读取速度，减轻数据库压力 |
| 对象存储 | MinIO | 开源对象存储，用于存储图片等非结构化数据 |
| 前端技术 | Vue3 | 构建移动端与后台管理端的用户界面 |
| Web服务器 | Nginx | 静态资源服务、反向代理与负载均衡 |
| 接口文档 | Knife4j | 为前后端分离开发提供强大的API文档支持 |
🗄️ 核心模块与业务流程
1. 核心模块
- 公寓与房间管理：管理员可以对公寓信息（如名称、地址、配套设施）和具体的房间信息（如租金、户型、状态）进行增删改查。
- 看房预约管理：用户可通过移动端提交预约，管理员在后台进行审核与安排。
- 租约管理：系统的核心，涵盖租约的创建、修改、终止以及状态流转。
- 用户管理：分别管理后台系统操作员和移动端注册用户的信息。
2. 核心业务流程
项目的业务流转围绕"签约 -> 续约/退租"展开，租约状态在各个节点间精准切换。
- 签约流程：后台创建租约 -> 移动端确认 -> 状态变更为"已签约"。
- 续约流程：用户发起续约 -> 后台审核 -> 状态更新。
- 退租流程：用户申请退租 -> 后台审核 -> 状态变更为"已退租"。
🛠️ 开发与部署实战
1. 开发准备
- 环境搭建：配置JDK 17、Maven、MySQL、Redis及MinIO服务。
- 数据库设计：基于ER模型，设计公寓、房间、用户、租约等实体表，明确一对一、一对多等关系。
- 接口定义：使用Knife4j进行接口文档的编写与管理，确保前后端开发并行不悖。
2. 项目部署
- 后端打包：使用Maven插件将项目打包为可执行的JAR文件（如web-admin-1.0-SNAPSHOT.jar）。
- Linux部署：将JAR包上传至服务器（如server01），编写Systemd服务配置文件（.service），实现服务的开机自启与便捷管理。
- 前端部署：通过npm run build打包前端项目，将生成的静态文件部署到Nginx的html目录下。
- Nginx配置：配置虚拟主机与反向代理，将前端请求代理至后端服务端口，同时解决跨域问题。
💡 关键技术点解析
MinIO对象存储
- 用于存储房源图片等非结构化数据。上传文件后，MinIO会生成一个唯一的URL标识符，前端可直接通过HTTP协议访问，既减轻了应用服务器的存储压力，又提高了访问速度。
Redis缓存
- 在用户频繁访问的房源详情等接口中，利用Redis缓存数据。当用户请求时，优先从缓存中读取，若无再查询数据库并回填缓存，显著提升了系统响应速度与并发处理能力。
Nginx反向代理
- 作为前端的HTTP服务器和后端的代理，Nginx不仅隐藏了后端真实IP地址，提高了安全性，还通过负载均衡策略为未来的集群扩展打下基础。
📌 总结
尚庭公寓项目作为一个典型的单体架构Java应用，完整复现了从需求分析、数据库设计、接口开发到Linux部署上线的全过程。通过该项目的实战，开发者不仅能巩固Spring Boot、MyBatis Plus等框架的使用，还能深入理解Redis缓存、Nginx代理、对象存储等中间件在实际业务场景中的集成与应用，是迈向Java高级开发的绝佳练手项目。