# COMS

**Repository Path**: stay_forever/coms

## Basic Information

- **Project Name**: COMS
- **Description**: Customer Order & Inventory Management System
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-22
- **Last Updated**: 2026-01-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# COMS

#### 介绍

**COMS**（Customer Order & Inventory Management System）是一个基于 Spring Boot 的客户订单与库存管理系统。系统采用 MVC 分层架构设计，支持多角色权限管理，提供完整的商品管理、订单处理、库存跟踪和数据统计功能。

系统特色：

- 🛒 完整的在线订购流程

- 📦 实时库存管理与预警

- 👥 多角色权限控制（管理员、员工、客户）

- 📊 数据统计与可视化报表

- 📱 响应式前端界面

#### 软件架构

```
CustomerOrder/
├── src/main/java/com/example/coms/
│   ├── controller/          # 控制器层 - HTTP请求处理
│   │   ├── AdminView/       # 管理员相关接口
│   │   ├── EmployeeView/    # 员工相关接口
│   │   ├── HomeView/        # 用户主页接口
│   │   └── LoginView/       # 登录注册接口
│   ├── dto/                 # 数据传输对象
│   │   ├── AdminView/       # 管理端DTO
│   │   ├── Dashboard/       # 仪表盘数据DTO
│   │   ├── HomeView/        # 用户端DTO
│   │   └── LoginView/       # 登录相关DTO
│   ├── entity/              # 实体类（对应数据库表）
│   ├── Repository/          # 数据访问层（JPA接口）
│   └── service/             # 业务逻辑层
│       ├── Impl/            # 服务实现类
│       └── 按模块分类的服务接口
├── src/main/resources/
│   ├── static/              # 前端静态资源
│   │   ├── AdminView/       # 管理后台页面
│   │   ├── EmployeeView/    # 员工工作台
│   │   ├── HomeView/        # 用户界面
│   │   └── index.html       # 首页
│   ├── application.properties # 配置文件
│   └── TestData.sql         # 测试数据脚本
└── 根目录配置文件...
```

**核心模块划分：**

1. **认证模块** - 用户登录、注册、权限验证

2. **商品模块** - 商品信息管理、库存监控

3. **订单模块** - 客户订购、订单处理、状态跟踪

4. **库存模块** - 入库管理、库存盘点、预警系统

5. **报表模块** - 销售统计、数据分析、可视化展示

6. **系统模块** - 日志记录、用户管理、系统配置

#### 安装教程

##### 环境要求

- **Java**: JDK 1.8 或更高版本

- **数据库**: MySQL 5.7 或更高版本

- **构建工具**: Maven 3.6+

- **操作系统**: Windows/Linux/macOS

##### 步骤 1：数据库准备

```
-- 创建数据库
CREATE DATABASE coms_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
```

##### 步骤 2：配置文件修改

1. 打开 `src/main/resources/application.properties`

2. 修改数据库连接配置：

```
# MySQL?????
spring.datasource.url=jdbc:mysql://localhost:3306/COMSDB?useSSL=false&serverTimezone=Asia/Shanghai&characterEncoding=utf8&allowPublicKeyRetrieval=true
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
spring.datasource.username=root
spring.datasource.password=123456   //修改为你的数据库
```

##### 步骤 3：项目构建

在IDEA终端输入如下命令：

```
mvn clean install -U -DskipTests
```

或者右键pom.xml选择Maven-重新加载项目

#### 使用说明

##### 1. 用户角色与权限

- **管理员**：系统最高权限，可管理所有功能
  
  - 访问路径：`/AdminView/Admin.html`
  
  - 功能：用户管理、商品管理、订单管理、数据统计

- **员工**：业务操作人员
  
  - 访问路径：`/EmployeeView/employee.html`
  
  - 功能：处理订单、管理库存、查看客户信息

- **客户**：普通用户
  
  - 访问路径：`/HomeView/Home.html`
  
  - 功能：浏览商品、下订单、查看个人订单

##### 2. 主要功能操作指南

**库存管理：**

1. 登录管理员账户

2. 进入"库存管理"页面

3. 点击"增加商品"按钮

4. 填写商品信息

5. 保存并上架商品

6. 点击“编辑”

7. 填写商品信息可修改

8. 点击“删除”则可以删除商品

**客户订购流程：**

1. 客户注册/登录账户

2. 浏览商品列表

3. 选择商品加入购物车

4. 进入购物车页面确认订单

5. 提交订单并等待处理

**订单处理流程：**

1. 员工登录系统

2. 进入"订单详情发货"页面

3. 查看待处理订单

4. 审核订单并更新状态

5. 确认发货或完成订单

**订单管理：**

1. 管理员登录

2. 进入"订单管理"页面

3. 查看当前订单状况

4. 执行查看/发货/删除订单操作

##### 3. 系统配置

- **修改应用端口**：编辑`application.properties`中的`server.port`

- **数据库连接池**：配置连接池大小和超时时间

- **日志级别**：调整`logging.level`配置

- **文件上传**：配置上传文件大小限制

# 

#### 特技

1. 使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
2. Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
3. 你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
4. [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
5. Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
6. Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)