# mall_system

**Repository Path**: li-luan/mall_system

## Basic Information

- **Project Name**: mall_system
- **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-04-03
- **Last Updated**: 2025-04-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 商场销售系统

基于 Next.js 和 Spring Boot 开发的商场销售管理系统，包含用户管理、商品管理、销售管理、库存管理等功能。

## 环境要求

- Node.js 18.19+
- MySQL 8.0+

## 安装步骤

### 1. 克隆项目

```bash
git clone <repository-url>
cd mall-sales-system
```

### 2. 安装依赖

```bash
# 安装 Node.js 依赖
npm install

# 安装 Python 依赖（用于生成报表）
python -m venv venv
source venv/bin/activate  # Windows 使用: venv\Scripts\activate
pip install matplotlib pandas seaborn graphviz
```

### 3. 配置数据库

1. 创建 MySQL 数据库：

```sql
CREATE DATABASE mall_sales_system CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
```

2. 配置环境变量，创建 `.env` 文件：

```env
# 数据库配置
DATABASE_URL="mysql://username:password@localhost:3306/mall_sales_system"

# NextAuth 配置
NEXTAUTH_SECRET="your-secret-key"
NEXTAUTH_URL="http://localhost:3000"
```

3. 初始化数据库：

```bash
# 运行数据库迁移
npx prisma migrate dev

# 添加初始数据
npx prisma db seed
```

### 4. 启动项目

```bash
# 开发模式
npm run dev

# 生产模式
npm run build
npm start
```

访问 http://localhost:3000 即可看到登录页面。

## 默认管理员账户

```
用户名：admin
密码：admin123
```

## 系统功能

- 用户管理
  - 用户注册
  - 用户登录
  - 角色管理
  
- 商品管理
  - 商品添加
  - 商品编辑
  - 商品删除
  
- 销售管理
  - 销售记录
  - 销售统计
  
- 库存管理
  - 库存查询
  - 库存预警
  
- 统计报表
  - 销售报表
  - 库存报表
  - 员工业绩报表

## 项目结构

```
mall-sales-system/
├── src/
│   ├── app/              # 页面组件
│   ├── components/       # 通用组件
│   ├── lib/             # 工具函数
│   └── styles/          # 样式文件
├── prisma/              # 数据库模型
├── public/             # 静态资源
└── package.json        # 项目配置
```

## 开发指南

### 数据库操作

```bash
# 创建新的数据库迁移
npx prisma migrate dev --name <migration-name>

# 更新数据库模型
npx prisma generate

# 查看数据库内容
npx prisma studio
```

### 生成报表

```bash
# 激活 Python 虚拟环境
source venv/bin/activate  # Windows 使用: venv\Scripts\activate

# 生成报表
python generate_reports.py
```

## 常见问题

1. 数据库连接错误
   - 检查 MySQL 服务是否启动
   - 验证数据库连接字符串是否正确
   - 确认数据库用户权限

2. 依赖安装失败
   - 清除 node_modules 并重新安装
   - 检查 Node.js 版本是否符合要求

3. 报表生成失败
   - 确认 Python 环境是否正确配置
   - 检查所需库是否完整安装