# hzj

**Repository Path**: hzj2004/hzj

## Basic Information

- **Project Name**: hzj
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-09
- **Last Updated**: 2026-06-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 超市管理平台 (Supermarket Management System)

> 一个面向三种角色（管理员、员工、供应商）的超市管理平台，实现商品管理、库存管理、销售管理、采购管理、报表统计等核心功能。

## 📋 项目简介

本系统旨在为中小型连锁超市打造一套覆盖"采购—入库—销售—结算—分析"全业务流程的数字化管理平台，解决传统手工记账效率低、库存盘点难、多方协作信息滞后等痛点。

## 🛠️ 技术栈

| 层级 | 技术 | 版本 |
|------|------|------|
| 后端 | Spring Boot | 3.5.x |
| 后端 | Java | 17 |
| 后端 | MyBatis-Plus | 3.5.x |
| 后端 | MySQL | 8.0+ |
| 后端 | Redis | 6.0+ |
| 后端 | RabbitMQ | 3.8+ |
| 后端 | Spring Security | 6.x |
| 前端 (Admin) | Vue 3 | 3.4+ |
| 前端 (Admin) | Naive UI | 2.38+ |
| 前端 (Admin) | ECharts | 5.5+ |
| 前端 (Employee) | Vue 3 | 3.4+ |
| 前端 (Provider) | Vue 3 | 3.4+ |

## 👥 角色定义

| 角色 | 职责 |
|------|------|
| **Admin (管理员)** | 系统管理、用户管理、数据统计、报表查看、采购审核 |
| **Employee (员工)** | 商品管理、库存管理、销售收银、退货处理、采购申请 |
| **Provider (供应商)** | 商品供货、订单确认、库存查询、结算查看 |

## 📁 项目结构

```
hzj/
├── code/
│   ├── server/                    # 后端服务
│   │   ├── src/main/java/com/hzj/smm/
│   │   │   ├── controller/        # 控制器层
│   │   │   ├── service/           # 业务层
│   │   │   ├── mapper/            # 数据访问层
│   │   │   ├── entity/            # 实体类
│   │   │   ├── dto/               # 数据传输对象
│   │   │   ├── vo/                # 视图对象
│   │   │   ├── config/            # 配置类
│   │   │   ├── security/          # 安全相关
│   │   │   └── utils/             # 工具类
│   │   └── src/main/resources/
│   │       ├── db/                # 数据库脚本
│   │       └── mapper/            # MyBatis 映射文件
│   └── ui/
│       ├── admin/                 # 管理员端前端
│       ├── employee/              # 员工端前端
│       └── provider/              # 供应商端前端
├── docs/                          # 项目文档
│   ├── architecture.md            # 技术架构文档
│   ├── requirements.md            # 项目需求文档
│   ├── deployment.md              # 项目部署文档
│   ├── development/               # 开发文档
│   │   └── roadmap.md             # 开发路线图
│   └── 报表模块需求说明书.md       # 报表模块需求
└── README.md                      # 项目说明文档
```

## 🚀 快速开始

### 环境要求

- Java 17+
- MySQL 8.0+
- Redis 6.0+
- RabbitMQ 3.8+
- Node.js 20.0+
- pnpm 8.0+

### 后端启动

```bash
# 1. 进入后端目录
cd code/server

# 2. 配置环境变量
cp .env.example .env
# 编辑 .env 文件，配置数据库、Redis、RabbitMQ 等

# 3. 创建数据库
mysql -u root -p < src/main/resources/db/schema.sql
mysql -u root -p smm < src/main/resources/db/seed.sql

# 4. 启动服务
mvn spring-boot:run
```

服务启动后访问：http://localhost:8080

### 前端启动

```bash
# Admin端
cd code/ui/admin
pnpm install
pnpm dev --host

# Employee端
cd code/ui/employee
pnpm install
pnpm dev --host --port 5174

# Provider端
cd code/ui/provider
pnpm install
pnpm dev --host --port 5175
```

### 登录信息

| 角色 | 用户名 | 密码 |
|------|--------|------|
| 管理员 | admin | Admin@123456 |

> 注：管理员账号通过环境变量在应用启动时自动创建，可在 `.env` 文件中配置。

## 📊 功能模块

### 系统管理
- 用户管理（CRUD、角色分配）
- 角色管理（CRUD、权限配置）
- 操作日志

### 商品管理
- 商品分类管理
- 商品信息管理（条码生成、图片上传）
- 商品上下架

### 库存管理
- 库存查询与预警
- 库存盘点
- 库存变动记录
- 入库/出库管理

### 销售管理
- POS收银台（扫码、结算、打印）
- 销售订单管理
- 退货处理

### 采购管理
- 采购订单管理（创建、审核、入库）
- 供应商管理
- 采购申请

### 数据报表
- 仪表盘数据概览
- 销售统计报表
- 采购统计报表
- 库存统计报表
- 利润分析报表

### 供应商门户
- 供应商Dashboard
- 供应商品管理
- 采购订单确认
- 结算管理
- 消息通知

## 📝 文档目录

| 文档 | 路径 | 说明 |
|------|------|------|
| 技术架构文档 | `docs/architecture.md` | 系统架构、数据库设计、API设计 |
| 项目需求文档 | `docs/requirements.md` | 功能需求、非功能需求 |
| 项目部署文档 | `docs/deployment.md` | 环境配置、部署步骤、常见问题 |
| 开发路线图 | `docs/development/roadmap.md` | 开发进度、功能规划 |
| 报表需求 | `docs/报表模块需求说明书.md` | 报表模块详细需求 |

## 🔧 配置说明

### 后端配置

后端配置通过 `.env` 文件管理，主要配置项：

```bash
# 管理员账号
SMM_ADMIN_USERNAME=admin
SMM_ADMIN_PASSWORD=Admin@123456

# 数据库配置
DB_HOST=localhost
DB_PORT=3306
DB_NAME=smm
DB_USERNAME=root
DB_PASSWORD=your_password

# Redis配置
REDIS_HOST=localhost
REDIS_PORT=6379

# RabbitMQ配置
RABBITMQ_HOST=localhost
RABBITMQ_PORT=5672
```

### 前端配置

前端配置通过 `.env` 文件管理：

```bash
# API基础地址
VITE_API_BASE_URL=http://localhost:8080/api
```

## 🤝 贡献指南

1. Fork 本仓库
2. 创建功能分支 (`git checkout -b feature/xxx`)
3. 提交代码 (`git commit -m 'feat: xxx'`)
4. 推送分支 (`git push origin feature/xxx`)
5. 创建 Pull Request

## 📄 许可证

MIT License

## 📞 联系方式

如有问题或建议，请通过以下方式联系：

- 邮箱：hzj@smm.com
- 项目地址：https://github.com/hzj/smm

---

*项目版本：v0.0.1*  
*最后更新：2026-06-25*