# group-buy

**Repository Path**: istar77/group-buy

## Basic Information

- **Project Name**: group-buy
- **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-07-07
- **Last Updated**: 2026-07-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 社区团购平台 - 实现代码

本目录包含社区团购平台的两端实现代码：
- `server/`：后端 API（NestJS + TypeScript + MySQL）
- `admin/`：管理端 Web（Vue3 + Element Plus + Vite）

## 技术栈

| 端 | 技术 | 版本 |
| --- | --- | --- |
| 后端 | NestJS | 10.x |
| 后端 | TypeScript | 5.x |
| 后端 | TypeORM | 0.3.x |
| 后端 | MySQL | 8.0 |
| 后端 | Redis | 7.0 |
| 后端 | JWT | - |
| 后端 | Passport | - |
| 后端 | class-validator | - |
| 管理端 | Vue | 3.4 |
| 管理端 | Vite | 5.x |
| 管理端 | Element Plus | 2.7 |
| 管理端 | Pinia | 2.x |
| 管理端 | Vue Router | 4.x |
| 管理端 | ECharts | 5.x |
| 管理端 | Axios | 1.x |

## 目录结构

```
groupbuy-implementation/
├── server/                     # 后端
│   ├── src/
│   │   ├── main.ts             # 入口
│   │   ├── app.module.ts       # 根模块
│   │   ├── common/             # 公共模块
│   │   │   ├── decorators/     # 装饰器
│   │   │   ├── filters/        # 异常过滤器
│   │   │   ├── interceptors/   # 拦截器
│   │   │   ├── pipes/          # 管道
│   │   │   ├── guards/         # 守卫
│   │   │   └── utils/          # 工具
│   │   ├── config/             # 配置
│   │   ├── database/           # 数据库
│   │   │   ├── entities/       # 实体
│   │   │   └── migrations/     # 迁移
│   │   └── modules/            # 业务模块
│   │       ├── auth/           # 认证
│   │       ├── user/           # 用户
│   │       ├── product/        # 商品
│   │       ├── order/          # 订单
│   │       ├── points/         # 积分
│   │       ├── invite/         # 拉新
│   │       ├── statistics/     # 统计
│   │       ├── file/           # 文件
│   │       └── admin/          # 后台账号
│   ├── package.json
│   ├── tsconfig.json
│   ├── nest-cli.json
│   └── ecosystem.config.js     # PM2 配置
├── admin/                      # 管理端
│   ├── src/
│   │   ├── main.ts
│   │   ├── App.vue
│   │   ├── api/                # 接口
│   │   ├── assets/             # 静态资源
│   │   ├── components/         # 公共组件
│   │   ├── layout/             # 布局
│   │   ├── router/             # 路由
│   │   ├── store/              # Pinia
│   │   ├── styles/             # 样式
│   │   ├── utils/              # 工具
│   │   └── views/              # 页面
│   │       ├── login/
│   │       ├── dashboard/
│   │       ├── product/
│   │       ├── order/
│   │       ├── user/
│   │       ├── points/
│   │       ├── invite/
│   │       ├── statistics/
│   │       └── system/
│   ├── index.html
│   ├── package.json
│   ├── tsconfig.json
│   └── vite.config.ts
└── README.md
```

## 快速开始

### 后端

```bash
cd server
npm install
# 复制 .env.example 为 .env 并配置
cp .env.example .env
# 启动
npm run start:dev
```

### 管理端

```bash
cd admin
npm install
npm run dev
# 访问 http://localhost:5173
```

## 部署

### 后端（PM2）

```bash
cd server
npm run build
pm2 start ecosystem.config.js
pm2 save
pm2 startup
```

### 管理端（Nginx）

```bash
cd admin
npm run build
# 将 dist/ 目录上传到服务器 /var/www/admin
# Nginx 配置示例见 deploy/nginx/admin.conf
```

## 设计风格

管理端采用**清新风格**：
- 主色：薄荷绿 `#5BCEAE`（自然、舒适）
- 辅色：暖橙 `#FF9D5C`（强调）
- 背景：浅灰 `#F7F9FC`（不刺眼）
- 圆角：8px（柔和）
- 阴影：轻柔多层（层次感）
- 布局：左侧菜单 + 顶部面包屑 + 内容卡片

## 开发规范

- TypeScript 严格模式
- ESLint + Prettier
- 提交前 husky 校验
- 模块化、单一职责
- 代码注释遵循 JSDoc 规范

## 文档

详细需求请参见 `../community-groupbuy-docs/` 目录下的：
- 《软件需求说明书》（SRS）
- 《需求分析与项目计划书》