# vue-nestjs

**Repository Path**: zy509-code/vue-nestjs

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-28
- **Last Updated**: 2026-01-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 库存和销售管理系统

## 项目简介

这是一个基于 Vue3 + Element Plus + NestJS + MySQL 的库存和销售管理系统。

## 技术栈

### 前端
- Vue 3.3 + Composition API
- Vite 5.x 构建工具
- Element Plus UI 组件库
- Pinia 状态管理
- Vue Router 4 路由
- Axios HTTP 客户端
- ECharts 数据可视化
- xlsx Excel 导出

### 后端
- NestJS 框架
- TypeScript
- TypeORM 数据库 ORM
- MySQL 8.0
- Passport JWT 认证
- Swagger API 文档

## 项目结构

```
opencode/
├── backend/                 # NestJS 后端项目
│   ├── src/
│   │   ├── modules/
│   │   │   ├── auth/       # 认证模块
│   │   │   └── users/      # 用户模块
│   │   ├── common/         # 公共模块
│   │   └── config/         # 配置模块
│   └── test/               # 测试文件
├── frontend/               # Vue3 前端项目
│   ├── src/
│   │   ├── views/          # 页面组件
│   │   ├── components/     # 公共组件
│   │   ├── api/            # API 接口
│   │   ├── stores/         # Pinia 状态管理
│   │   ├── router/         # 路由配置
│   │   └── utils/          # 工具函数
│   └── public/             # 静态资源
└── docs/                   # 文档目录
```

## 快速开始

### 前置要求
- Node.js >= 18
- MySQL >= 8.0
- npm 或 yarn

### 后端设置

```bash
cd backend
npm install

# 复制环境变量文件
cp .env.example .env

# 编辑 .env 文件配置数据库信息

# 启动开发服务器
npm run start:dev
```

后端服务将在 http://localhost:3000 启动
API 文档: http://localhost:3000/api/docs

### 前端设置

```bash
cd frontend
npm install

# 启动开发服务器
npm run dev
```

前端服务将在 http://localhost:5173 启动

### 默认账号
- 用户名: admin
- 密码: admin123

## 功能模块

### 已完成
- [x] 用户认证 (登录/登出)
- [x] 用户管理 (CRUD)
- [x] 角色权限控制
- [x] JWT 认证

### 待开发
- [ ] 商品管理
- [ ] 库存管理
- [ ] 订单管理
- [ ] 报表统计
- [ ] 数据可视化

## API 接口

### 认证模块
- `POST /api/auth/login` - 用户登录
- `GET /api/auth/profile` - 获取当前用户信息

### 用户模块
- `GET /api/users` - 获取用户列表
- `POST /api/users` - 创建用户
- `PUT /api/users/:id` - 更新用户
- `DELETE /api/users/:id` - 删除用户

## 开发规范

### 代码风格
- 使用 ESLint + Standard 规范
- 使用 Prettier 自动格式化
- 遵循组件命名规范

### Git 提交规范
- feat: 新功能
- fix: Bug 修复
- docs: 文档更新
- style: 代码格式调整
- refactor: 重构
- test: 测试
- chore: 其他修改

## 许可证

MIT