1. 项目概述：装饰工程管理系统的技术架构解析
这套基于SpringBoot+Vue3+MyBatis的装饰工程管理系统，是当前企业数字化转型过程中典型的全栈解决方案。我在实际部署和二次开发过程中发现，它完美融合了Java后端的技术沉淀与前端现代化的开发体验。系统采用前后端分离架构，后端使用SpringBoot 2.7.x构建RESTful API，前端基于Vue3的组合式API开发，数据持久层采用MyBatis-Plus增强工具，数据库选用MySQL 8.0作为存储引擎。
提示：这套系统特别适合中小型装饰企业实施信息化管理，也适合开发者学习现代企业级应用开发的全套技术栈。
2. 核心模块设计与技术实现
2.1 后端SpringBoot架构设计
后端采用经典的三层架构模式，但有几个值得注意的优化点：
- 全局异常处理使用
@ControllerAdvice统一拦截，返回标准化的JSON错误格式 - 采用Swagger3 + Knife4j实现API文档自动化生成
- 权限控制使用Sa-Token框架，比传统Shiro更轻量
- 数据库连接池默认使用HikariCP，配置了合理的连接超时参数
// 典型Controller示例 @RestController @RequestMapping("/api/project") @Api(tags = "项目管理接口") public class ProjectController { @Autowired private ProjectService projectService; @PostMapping @SaCheckPermission("project:add") public Result addProject(@Valid @RequestBody ProjectDTO dto) { return Result.success(projectService.addProject(dto)); } }2.2 Vue3前端工程化实践
前端项目采用Vite4构建工具，显著提升了开发时的热更新速度。几个关键技术点：
- 使用Pinia替代Vuex进行状态管理
- 基于Element Plus组件库二次封装了业务组件
- 采用Axios拦截器实现统一的请求/响应处理
- 路由守卫结合后端权限系统实现动态路由加载
// 典型API请求封装 export const getProjectList = (params) => { return request({ url: '/api/project', method: 'get', params }) }2.3 MyBatis-Plus的高级应用
系统没有使用原生MyBatis，而是采用MyBatis-Plus 3.5.x版本，主要优化点包括：
- 自动填充功能处理创建时间、更新时间等通用字段
- 逻辑删除注解实现软删除
- 性能分析插件拦截慢SQL
- 分页插件与前端表格组件完美配合
<!-- 自定义SQL示例 --> <select id="selectProjectWithStats" resultMap="ProjectResultMap"> SELECT p.*, COUNT(t.task_id) AS task_count FROM project p LEFT JOIN task t ON p.project_id = t.project_id WHERE p.deleted = 0 GROUP BY p.project_id </select>3. 数据库设计与优化
3.1 MySQL表结构设计
核心表包括：
- 项目表(project)：存储工程基本信息
- 客户表(customer)：关联项目所属客户
- 材料表(material)：记录装修材料信息
- 进度表(schedule)：跟踪项目时间节点
- 员工表(employee)：系统用户数据
CREATE TABLE `project` ( `project_id` bigint NOT NULL AUTO_INCREMENT, `project_name` varchar(100) NOT NULL, `customer_id` bigint NOT NULL, `start_date` date DEFAULT NULL, `end_date` date DEFAULT NULL, `budget` decimal(12,2) DEFAULT NULL, `status` tinyint DEFAULT '0' COMMENT '0-未开始 1-进行中 2-已完工', `deleted` tinyint DEFAULT '0', `create_time` datetime DEFAULT CURRENT_TIMESTAMP, `update_time` datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, PRIMARY KEY (`project_id`), KEY `idx_customer` (`customer_id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;3.2 性能优化实践
- 为所有外键字段添加索引
- 大文本字段使用TEXT类型单独存储
- 金额字段使用DECIMAL(12,2)确保精度
- 建立合理的复合索引避免全表扫描
- 配置了定时的数据库备份任务
4. 系统部署与运维方案
4.1 开发环境搭建
推荐使用以下工具链：
- JDK17 + IntelliJ IDEA
- Node.js 16.x + VSCode
- MySQL 8.0 + Redis 6.x
- Docker Desktop（可选）
注意：MySQL字符集必须设置为utf8mb4以支持完整Unicode字符，包括emoji
4.2 生产环境部署
提供两种部署方案：
传统部署：
- 后端打包为JAR文件使用
nohup java -jar运行 - 前端构建后部署到Nginx
- MySQL配置主从复制
- 后端打包为JAR文件使用
Docker容器化部署：
# 后端Dockerfile示例 FROM openjdk:17-jdk COPY target/decor-system.jar /app.jar ENTRYPOINT ["java","-jar","/app.jar"]4.3 监控与日志
- 使用Spring Boot Actuator暴露健康检查端点
- 配置Logback按天滚动日志文件
- 前端使用Sentry捕获运行时错误
- 关键业务操作记录审计日志
5. 二次开发指南
5.1 常见扩展需求实现
微信小程序端开发：
- 复用现有后端API
- 使用Uni-app框架跨平台开发
第三方系统集成：
- 钉钉/企业微信对接使用OAuth2.0
- 财务系统对接建议使用Webhook
数据可视化大屏：
- 使用ECharts实现
- 单独建立分析数据库避免影响业务
5.2 代码规范建议
- 后端遵循阿里巴巴Java开发手册
- 前端使用ESLint + Prettier统一代码风格
- Git提交信息遵循Conventional Commits规范
- API设计遵循RESTful最佳实践
6. 常见问题排查
6.1 启动问题
数据库连接失败：
- 检查application.yml中的JDBC URL
- 确认MySQL用户有远程连接权限
前端编译报错：
- 确保Node.js版本≥16
- 删除node_modules后重新npm install
6.2 业务逻辑问题
权限不生效：
- 检查Sa-Token的拦截路径配置
- 确认用户角色拥有对应权限码
分页查询异常：
- 检查PageHelper的startPage()调用位置
- 确认没有在分页查询中包含count语句
7. 性能调优实战记录
7.1 后端优化案例
N+1查询问题：
- 使用MyBatis-Plus的
@TableField(exist = false)延迟加载 - 复杂关联查询改为手动编写SQL
- 使用MyBatis-Plus的
接口响应慢：
- 添加Redis缓存热门数据
- 使用@Async异步处理非核心逻辑
7.2 前端优化技巧
打包体积过大：
- 配置Vite的代码分割
- 按需引入Element Plus组件
页面加载慢：
- 启用Gzip压缩
- 配置合理的HTTP缓存头
这套系统在我参与的三个装饰公司项目中成功实施，平均实施周期2-3周。最大的收获是发现Vue3的Composition API比Options API更适合复杂业务场景的开发维护，而MyBatis-Plus的Lambda查询方式大幅减少了SQL编写错误。对于中小型项目，这种技术组合在开发效率和运行性能之间取得了很好的平衡。
