# washing_top **Repository Path**: jeremy_he/wash ## Basic Information - **Project Name**: washing_top - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2025-08-29 - **Last Updated**: 2025-08-29 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 被单洗涤管理系统 ## 项目介绍 被单洗涤管理系统是一个完整的企业级洗涤行业管理解决方案，包含商品管理、订单管理、配送管理、回收管理、洗涤管理、库存管理、统计报表等核心功能模块。 ## 技术架构 ### 后端技术栈 - **框架**: Spring Boot 2.7.18 - **ORM**: MyBatis-Plus 3.4.3.1 - **数据库**: MySQL 8.0+ - **安全**: Spring Security + JWT - **构建工具**: Maven 3.6+ - **JDK版本**: Java 8+ ### 前端技术栈 - **框架**: Vue.js 2.x - **UI组件**: Element UI - **构建工具**: Vue CLI - **状态管理**: Vuex - **路由**: Vue Router - **HTTP客户端**: Axios ## 项目结构 ``` tb_washing_top/ ├── washing_top_backend/ # Spring Boot后端项目 │ ├── src/main/java/ │ │ └── com/washing/ │ │ ├── common/ # 公共组件 │ │ ├── config/ # 配置文件 │ │ ├── controller/ # 控制器 │ │ ├── entity/ # 实体类 │ │ ├── mapper/ # MyBatis映射器 │ │ └── service/ # 业务服务 │ ├── src/main/resources/ │ │ ├── mapper/ # MyBatis XML映射文件 │ │ ├── application.yml # 应用配置 │ │ └── data/ # 初始化数据 │ └── pom.xml # Maven依赖配置 ├── washing_top_frontend/ # Vue.js前端项目 │ ├── src/ │ │ ├── api/ # API接口定义 │ │ ├── components/ # 公共组件 │ │ ├── views/ # 页面组件 │ │ ├── router/ # 路由配置 │ │ └── utils/ # 工具函数 │ ├── public/ # 静态资源 │ ├── package.json # NPM依赖配置 │ └── vue.config.js # Vue CLI配置 ├── washing_top_database.sql # 数据库设计文件 ├── washing_top_sample_data.sql # 示例数据 ├── start-backend.bat # 后端启动脚本 ├── start-frontend.bat # 前端启动脚本 └── README.md # 项目说明文档 ``` ## 快速开始 ### 环境要求 1. **JDK 8+**: 确保已安装Java开发环境 2. **Maven 3.6+**: 用于构建后端项目 3. **Node.js 14+**: 用于运行前端项目 4. **MySQL 8.0+**: 数据库服务 ### 数据库配置 1. 创建数据库： ```sql CREATE DATABASE washing_top CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; ``` 2. 导入数据库结构： ```bash mysql -u root -p washing_top < washing_top_database.sql ``` 3. 导入示例数据（可选）： ```bash mysql -u root -p washing_top < washing_top_sample_data.sql ``` ### 后端配置 1. 修改数据库连接配置： 编辑 `washing_top_backend/src/main/resources/application.yml` ```yaml spring: datasource: url: jdbc:mysql://localhost:3306/washing_top?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai username: your_username password: your_password ``` 2. 配置JWT密钥： ```yaml jwt: secret: your_jwt_secret_key_that_is_at_least_256_bits_long expiration: 86400000 # 24小时 ``` ### 启动应用 #### 方式一：使用启动脚本（推荐） 1. **启动后端**：双击 `start-backend.bat` 2. **启动前端**：双击 `start-frontend.bat` #### 方式二：手动启动 1. **启动后端**： ```bash cd washing_top_backend mvn clean compile mvn spring-boot:run ``` 2. **启动前端**： ```bash cd washing_top_frontend npm install npm run serve ``` ### 访问应用 - **前端地址**: http://localhost:3000 - **后端API**: http://localhost:8888/api - **数据库监控**: http://localhost:8888/api/druid（用户名：admin，密码：123456） ### 默认账号 - **用户名**: admin - **密码**: 123456 ## 核心功能模块 ### 1. 系统管理 - **用户管理**: 用户账号的增删改查、状态管理、密码重置 - **角色管理**: 角色的创建、编辑、权限配置 - **系统配置**: 系统参数的配置和管理 - **操作日志**: 系统操作记录的查看和管理 ### 2. 商品管理 - **商品类型**: 被单类型的分类管理 - **商品列表**: 被单商品的信息管理 - **商品入库**: 被单商品的入库操作 - **商品状态**: 被单状态的跟踪管理 ### 3. 订单管理 - **订单创建**: 新订单的创建和信息录入 - **订单列表**: 订单信息的查看和管理 - **出库管理**: 订单商品的出库操作 ### 4. 配送管理 - **配送任务**: 配送任务的分配和管理 - **配送监控**: 配送过程的实时监控 ### 5. 回收管理 - **回收申请**: 被单回收申请的处理 - **回收单管理**: 回收单据的管理 ### 6. 洗涤管理 - **洗涤任务**: 洗涤任务的分配和跟踪 - **洗涤监控**: 洗涤过程的监控 ### 7. 库存管理 - **库存列表**: 库存信息的查看 - **仓库管理**: 仓库信息的管理 - **库存报表**: 库存统计报表 ### 8. 统计报表 - **业务统计**: 业务数据的统计分析 - **财务统计**: 财务数据的统计报表 - **配送统计**: 配送数据的统计分析 - **订单统计**: 订单数据的统计报表 ## API接口说明 ### 认证接口 - `POST /auth/login` - 用户登录 - `POST /auth/logout` - 用户登出 - `POST /auth/refresh` - 刷新Token ### 用户管理接口 - `GET /system/user/page` - 分页查询用户 - `POST /system/user` - 创建用户 - `PUT /system/user/{id}` - 更新用户 - `DELETE /system/user/{id}` - 删除用户 - `PUT /system/user/{id}/status` - 更新用户状态 - `POST /system/user/{id}/reset-password` - 重置密码 ### 角色管理接口 - `GET /system/role/page` - 分页查询角色 - `GET /system/role/list` - 查询角色列表 - `POST /system/role` - 创建角色 - `PUT /system/role/{id}` - 更新角色 - `DELETE /system/role/{id}` - 删除角色 - `PUT /system/role/{id}/status` - 更新角色状态 ### 系统配置接口 - `GET /system/config/page` - 分页查询配置 - `POST /system/config` - 创建配置 - `PUT /system/config/{id}` - 更新配置 - `DELETE /system/config/{id}` - 删除配置 - `POST /system/config/set` - 设置配置值 - `POST /system/config/refresh-cache` - 刷新缓存 - `POST /system/config/init` - 初始化配置 ### 操作日志接口 - `GET /system/log/page` - 分页查询日志 - `DELETE /system/log/{id}` - 删除日志 - `POST /system/log/batch-delete` - 批量删除日志 - `GET /system/log/types` - 获取操作类型 - `GET /system/log/modules` - 获取操作模块 - `GET /system/log/today-stats` - 获取今日统计 ## 开发指南 ### 添加新功能模块 1. **后端开发**： - 创建实体类（Entity） - 创建映射器（Mapper） - 创建服务类（Service） - 创建控制器（Controller） 2. **前端开发**： - 在 `src/api/` 中添加API接口 - 在 `src/views/` 中创建页面组件 - 在 `src/router/` 中配置路由 ### 权限控制 系统使用基于角色的权限控制（RBAC），通过JWT Token进行身份验证。 ### 代码规范 - **后端**: 遵循阿里巴巴Java开发手册 - **前端**: 遵循Vue.js官方风格指南 ## 部署说明 ### 开发环境部署 按照"快速开始"部分的说明进行部署。 ### 生产环境部署 1. **后端部署**： ```bash cd washing_top_backend mvn clean package -Dmaven.test.skip=true java -jar target/washing-top-backend-1.0.0.jar ``` 2. **前端部署**： ```bash cd washing_top_frontend npm run build # 将 dist/ 目录下的文件部署到Web服务器 ``` ## 常见问题 ### Q: 启动后端时出现数据库连接错误？ A: 请检查以下配置： - 数据库服务是否启动 - 数据库连接信息是否正确 - 数据库是否已创建 ### Q: 前端无法访问后端API？ A: 请检查以下设置： - 后端服务是否正常启动（端口8080） - 前端代理配置是否正确（vue.config.js） - 防火墙是否阻止了端口访问 ### Q: 登录后提示Token无效？ A: 请检查JWT配置： - JWT密钥长度是否足够（至少256位） - 系统时间是否正确 - Token过期时间设置 ## 技术支持 如果在使用过程中遇到问题，请： 1. 查看控制台日志信息 2. 检查配置文件是否正确 3. 参考本文档的常见问题部分 ## 更新日志 ### v1.0.0 (2024-12-01) - 完成系统管理模块（用户管理、角色管理、系统配置、操作日志） - 实现JWT身份验证和权限控制 - 完成前后端基础架构搭建 - 实现系统主要功能框架 --- © 2024 被单洗涤管理系统. All rights reserved.