README.md 8.5 KB
项目总览
📋 项目基本信息
项目名称：高校后勤校园管理系统 (HZDYJS_XG)
项目类型：企业级 Web 应用系统
开发模式：前后端分离 + 移动端 App
架构模式：微服务架构 + 多租户设计
当前版本：v1.0.0
开发周期：2024.01 - 2024.10
🎯 项目愿景
构建一个现代化、智能化、易用性强的高校后勤管理平台，提升后勤服务效率，改善师生体验，实现后勤管理的数字化转型。
📊 核心业务领域
1. 📋 后勤满意度调查系统
- 目标：收集师生对后勤服务的满意度反馈
- 价值：数据驱动的服务质量改进
- 覆盖范围：餐饮、宿舍、保洁、维修等全方位后勤服务
2. 🏛️ 报告厅预约管理系统
- 目标：优化校园会议室/报告厅资源配置
- 价值：提高场地利用率，减少冲突和浪费
- 覆盖范围：各类会议室、报告厅、活动场所
3. 🔧 后勤维修服务系统
- 目标：建立高效的设施维修服务流程
- 价值：快速响应，提升维修效率
- 覆盖范围：宿舍、教学楼、公共设施维修
4. 🍽️ 餐饮服务管理系统
- 目标：提升校园餐饮服务质量和体验
- 价值：菜品管理、营养配餐、师生反馈
- 覆盖范围：食堂管理、外卖配送、营养健康
🏗️ 技术架构概览
系统架构图
graph TB
subgraph "前端层"
A1[Web管理端<br/>Vue3 + Element Plus]
A2[移动端App<br/>Vue 2 + uni-app + uview-ui]
end
subgraph "网关层"
B1[API Gateway<br/>Spring Cloud Gateway]
end
subgraph "业务服务层"
C1[用户管理服务<br/>Spring Boot]
C2[满意度调查服务<br/>Spring Boot]
C3[报告厅预约服务<br/>Spring Boot]
C4[系统管理服务<br/>Spring Boot]
end
subgraph "数据层"
D1[MySQL 8.0<br/>主数据库]
D2[Redis 7.0<br/>缓存/会话]
D3[MinIO<br/>文件存储]
end
subgraph "基础设施"
E1[Docker<br/>容器化部署]
E2[Nginx<br/>负载均衡]
E3[ELK<br/>日志分析]
E4[Prometheus<br/>监控告警]
end
A1 --> B1
A2 --> B1
B1 --> C1
B1 --> C2
B1 --> C3
B1 --> C4
C1 --> D1
C2 --> D1
C3 --> D1
C4 --> D1
C1 --> D2
C2 --> D2
C3 --> D2
C4 --> D2
C1 --> D3
C2 --> D3
C3 --> D3
C4 --> D3
技术栈详情
后端技术栈
- 核心框架：Spring Boot 3.4.6 + Spring Cloud 2023.0.x
- 开发语言：Java 17/21
- ORM 框架：MyBatis-Plus 3.5.12
- 权限认证：Sa-Token 1.42.0 + JWT
- 数据库：MySQL 8.0（主库）+ Redis 7.0（缓存）
- 消息队列：RabbitMQ 3.12
- 任务调度：SnailJob 1.5.0
- 工作流引擎：Warm-Flow 1.7.3
- 文档管理：SpringDoc + Knife4j
前端技术栈
- Web 框架：Vue 3.5.13 + TypeScript 5.8.3
- UI 组件库：Element Plus 2.9.8
- 构建工具：Vite 7.0.9
- 状态管理：Pinia
- HTTP 客户端：Axios
- 图表组件：ECharts 5.x
移动端技术栈
- 跨平台框架：uni-app 2.x
- 前端框架：Vue 2.6.14
- UI 组件库：uview-ui 2.0.38
- 状态管理：Vuex 3.2.0
- 开发语言：JavaScript + TypeScript 4.5.5
- 地图服务：高德地图 API
部署运维
- 容器化：Docker + Docker Compose
- 容器编排：Kubernetes（生产环境）
- Web 服务器：Nginx（反向代理 + 负载均衡）
- CI/CD：GitLab CI/CD
- 监控告警：Prometheus + Grafana + AlertManager
- 日志管理：ELK Stack（Elasticsearch + Logstash + Kibana）
📈 项目规模指标
代码规模
- 后端代码：约 15 万行 Java 代码
- 前端代码：约 8 万行 Vue/TypeScript 代码
- 移动端代码：约 3 万行 JavaScript 代码
- 数据库表：约 80 张业务表
功能模块
- 核心业务模块：4 个
- 基础支撑模块：6 个
- 管理配置模块：8 个
- API 接口数量：约 200 个
性能指标
- 并发用户数：支持 1000+在线用户
- 响应时间：平均响应时间 < 200ms
- 可用性：99.9%系统可用性
- 数据处理：支持千万级数据查询
👥 团队组织结构
项目团队
- 项目经理：1 人（项目管理 + 需求分析）
- 架构师：1 人（技术架构 + 核心开发）
- 后端开发：2 人（Spring Boot 微服务开发）
- 前端开发：2 人（Vue3 + 移动端开发）
- 测试工程师：1 人（功能测试 + 自动化测试）
- 运维工程师：1 人（部署运维 + 监控告警）
开发分工
| 模块 | 负责人 | 开发重点 |
|---|---|---|
| 用户管理 + 系统管理 | 张三 | 权限体系、多租户架构 |
| 满意度调查系统 | 李四 | 问卷设计器、数据统计 |
| 报告厅预约系统 | 王五 | 工作流引擎、预约算法 |
| 前端 UI + 移动端 | 赵六 | 用户体验、界面设计 |
📅 项目时间线
第一阶段：基础架构搭建（2024.01-2024.02）
- ✅ 技术选型和架构设计
- ✅ 开发环境搭建
- ✅ 基础框架集成
- ✅ 用户权限系统开发
第二阶段：核心功能开发（2024.03-2024.06）
- ✅ 满意度调查系统开发
- 🟡 报告厅预约系统开发（进行中）
- ⭕ 维修服务系统开发（待开始）
- ⭕ 餐饮管理系统开发（待开始）
第三阶段：系统集成测试（2024.07-2024.08）
- ⭕ 功能测试和集成测试
- ⭕ 性能测试和优化
- ⭕ 安全测试和加固
- ⭕ 用户验收测试
第四阶段：部署上线（2024.09-2024.10）
- ⭕ 生产环境部署
- ⭕ 数据迁移和初始化
- ⭕ 用户培训和推广
- ⭕ 运维监控体系建立
🎯 项目目标与 KPI
业务目标
- 服务效率提升：报告厅预约流程效率提升 80%
- 用户满意度：后勤服务满意度达到 90%以上
- 数据驱动决策：建立完善的数据分析和报告体系
- 成本控制：通过系统化管理降低运营成本 15%
技术目标
- 系统稳定性：99.9%系统可用性
- 响应性能：平均响应时间 < 200ms
- 扩展性：支持 10 倍用户增长的架构设计
- 安全性：通过等保三级安全认证
质量目标
- 代码质量：代码覆盖率 > 80%
- 文档完整性：100%API 文档覆盖
- 用户体验：移动端 App 评分 > 4.5 星
- 培训效果：用户培训通过率 > 95%
🔧 开发工具链
开发环境
- IDE：IntelliJ IDEA 2024.x
- 版本控制：Git + GitLab
- 数据库工具：Navicat Premium
- API 测试：Postman + Swagger UI
- 代码质量：SonarQube
协作工具
- 项目管理：禅道 + GitLab Issues
- 文档协作：语雀 + Markdown
- 设计工具：Figma + ProcessOn
- 沟通工具：企业微信 + 腾讯会议
📋 下一步行动计划
近期重点（未来 2 周）
- 完成报告厅预约系统后端开发
- 启动前端界面开发
- 完善 API 文档和测试用例
- 建立 CI/CD 自动化流水线
中期规划（未来 1 个月）
- 完成核心功能模块集成
- 开始系统性能测试
- 完善用户手册和培训材料
- 准备生产环境部署方案
长期愿景（未来 3 个月）
- 系统全面上线运行
- 建立运维监控体系
- 收集用户反馈，持续优化
- 探索 AI 智能化功能集成
🎯 项目愿景：打造高校后勤管理的标杆系统，为数字化校园建设贡献力量！
📖 相关文档
UI 设计系统
主题色规范
- Web 端主题色: rgb(93, 135, 255)
- 定义位置: web/src/assets/styles/art-variables.scss
- CSS 变量: --art-primary
- 更新时间: 2025-01-08
设计语言
- Art Design Pro UI 设计规范
- 轮廓式按钮设计系统
- 响应式布局
- 现代化智慧校园风格