# water
**Repository Path**: cinnabars/water
## Basic Information
- **Project Name**: water
- **Description**: Water 是一个通用的后台管理系统模板,基于 Spring Boot 3 🌱 和 Vue 3 🌿 构建,包含管理后台、微信小程序 💬 和后端服务三个部分。开箱即用的 RBAC 权限管理 🔒、菜单管理、组织架构管理、角色管理、字典管理、任务调度 ⏱️ 等基础功能,可快速应用于各类业务场景。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 2
- **Forks**: 0
- **Created**: 2026-01-08
- **Last Updated**: 2026-02-12
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
Water 管理系统模板
基于 Spring Boot 3 + Vue 3 的通用后台管理系统模板
🖥️ PC端 + 📱 移动端 + 💬 微信小程序 多端适配
## 📖 项目简介
Water 是一个通用的后台管理系统模板,基于 Spring Boot 3 🌱 和 Vue 3 🌿 构建,包含管理后台、微信小程序 💬 和后端服务三个部分。开箱即用的 RBAC 权限管理 🔒、菜单管理、组织架构管理、角色管理、字典管理、任务调度 ⏱️ 等基础功能,可快速应用于各类业务场景。
## 🌐 在线预览
**管理后台**: [在线预览](http://175.178.233.177)
**体验账号**: `admin` / 请查看数据库脚本
## 📁 项目组成
| 模块 | 说明 | 文档 |
|------|------|------|
| **water-admin** | 管理后台前端 (Vue 3 + Vite + Element Plus) | [查看文档](water-admin/README.md) |
| **water-boot** | 后端服务 (Spring Boot 3 + MyBatis Plus + Sa-Token) | [查看文档](water-boot/README.md) |
| **water-wechat** | 微信小程序 (uni-app Vue3) | [查看文档](water-wechat/README.md) |
## 🎯 核心功能
### 权限管理
- **用户管理**:用户增删改查、用户角色分配
- **角色管理**:角色权限配置、菜单权限、权限标签(AuthLabel)
- **菜单管理**:动态菜单配置,支持多层级菜单结构
- **组织管理**:支持多层级组织结构,树形展示
### 系统功能
- **字典管理**:系统级字典配置,@Dict 注解自动绑定
- **配置管理**:系统配置统一管理(CommonConfig)
- **任务调度**:灵活的定时任务管理(ITask 接口扩展)
- **文件管理**:文件上传、下载、预览
### 多端支持
- **PC 端管理后台**:基于 Element Plus,自适应布局,兼容桌面和平板
- **移动端适配**:管理后台完美适配移动端浏览器(MobileOverlay 遮罩、MobileToggle 切换)
- **微信小程序**:uni-app 开发,微信登录自动注册,Token 认证
## 🛠️ 技术栈
### 后端 (water-boot)
- **框架**: Spring Boot 3.2.2 + Java 17
- **ORM**: MyBatis Plus 3.5.5
- **认证**: Sa-Token 1.39.0(基于 Redis Token 存储)
- **数据库**: MySQL 8.x
- **缓存**: Redis
- **工具**: Hutool 5.8.22、EasyExcel 3.3.2、Fastjson2 2.0.41
### 前端 (water-admin)
- **框架**: Vue 3.5.12 + JavaScript + Vite 5.4.11
- **UI 组件**: Element Plus 2.8.8(响应式布局,支持 PC 和移动端)
- **图标库**: @element-plus/icons-vue 2.3.2 + @icon-park/vue-next 1.4.2
- **状态管理**: Pinia 2.2.8
- **路由**: Vue Router 4.4.5(动态路由)
- **HTTP**: Axios 1.7.7
### 微信小程序 (water-wechat)
- **框架**: uni-app Vue3 + JavaScript
- **后端对接**: 调用 water-boot 统一接口
- **认证方式**: 微信登录 + 自动注册 + Token 认证
## 📚 项目文档
- **[前端文档](water-admin/README.md)** - Vue 管理后台使用教程和目录结构
- **[后端文档](water-boot/README.md)** - Spring Boot 后端使用教程和目录结构
- **[小程序文档](water-wechat/README.md)** - 微信小程序使用教程和目录结构
- **[架构说明](CLAUDE.md)** - 详细的项目架构和开发指南
## 🔑 默认账号
- 管理员账号: `admin`
- 默认密码: 请查看数据库初始化脚本
## 📄 许可证
本项目采用 [Apache 2.0](LICENSE) 许可证。
---
Built with ❤️ by Water Team