# e-shop

**Repository Path**: stu223/e-shop

## Basic Information

- **Project Name**: e-shop
- **Description**: e-shop e-shop
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-18
- **Last Updated**: 2026-03-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# E-Shop 电商平台

一个功能完整的 B2C 电商平台，支持多商家入驻、商品管理、订单处理、支付系统等核心功能。

## 🚀 项目特色

- **多商家支持** - 商家入驻审核、等级管理
- **完整商品体系** - 分类管理、库存预警、批量操作
- **智能营销** - 优惠券、促销活动、积分会员系统
- **安全支付** - 支持多种支付方式、退款流程
- **数据分析** - 销售统计、用户行为分析、商品热度分析
- **移动端适配** - 响应式设计，完美支持移动端

## 📋 技术栈

### 前端
- **框架**: Next.js 14 + React 18
- **样式**: Tailwind CSS + Bootstrap
- **状态管理**: React Hooks + Context API
- **类型安全**: TypeScript

### 后端
- **运行时**: Node.js
- **框架**: Express.js
- **数据库**: MongoDB Atlas
- **认证**: JWT Token
- **文件上传**: Multer

### 开发工具
- **包管理**: npm
- **代码规范**: ESLint
- **热重载**: nodemon
- **环境管理**: dotenv

## 🛠️ 快速开始

### 环境要求
- Node.js >= 18.0.0
- npm >= 8.0.0
- MongoDB Atlas 账号

### 安装步骤

1. **克隆项目**
```bash
git clone https://gitee.com/stu223/e-shop.git
cd e-shop
```

2. **安装依赖**
```bash
npm install
cd server && npm install
```

3. **环境配置**
```bash
# 复制环境配置文件
cp server/.env.example server/.env

# 编辑 .env 文件，配置 MongoDB Atlas 连接
MONGODB_URI=mongodb://your-username:your-password@your-cluster.mongodb.net/eshop
```

4. **启动服务**
```bash
# 启动后端服务
npm run server

# 启动前端服务（新终端）
npm run dev
```

5. **访问应用**
- 前端: http://localhost:3000
- 后端API: http://localhost:3001

## 📁 项目结构

```
e-shop/
├── app/                    # Next.js App Router
│   ├── admin/             # 后台管理页面
│   ├── user/              # 用户中心页面
│   └── products/          # 商品页面
├── components/            # React 组件
├── lib/                   # 工具库
├── server/                # 后端服务
│   ├── config/           # 配置文件
│   ├── models/           # 数据模型
│   └── routes/           # API 路由
├── docs/                 # 项目文档
└── public/               # 静态资源
```

## 🔐 默认账号

### 管理员账号
- **邮箱**: admin@ztjicai.com
- **密码**: Admin123456

### 测试用户
- **邮箱**: zhangsan@test.com
- **密码**: password123

## 📖 文档

- [API 接口文档](./docs/api/) - 完整的 API 接口说明
- [开发指南](./docs/development/) - 开发环境搭建和规范
- [部署文档](./docs/deployment/) - 生产环境部署指南
- [用户手册](./docs/guides/) - 功能使用说明

## 🎯 核心功能

### 🏢 后台管理
- **商家管理**: 入驻审核、等级评定、资质管理
- **商品管理**: 分类管理、库存预警、批量操作
- **订单管理**: 状态跟踪、退款处理、物流管理
- **用户管理**: 用户列表、状态管理、权限控制
- **数据统计**: 销售报表、用户分析、商品热度

### 👤 用户端
- **用户中心**: 个人信息、地址管理、实名认证
- **购物体验**: 商品浏览、购物车、收藏夹
- **评价系统**: 商品评价、用户评分、图片评价
- **营销活动**: 优惠券、促销活动、积分兑换

### 💳 支付系统
- **多种支付**: 支付宝、微信支付、余额支付
- **安全保障**: 签名验证、幂等控制、金额校验
- **退款流程**: 自动退款、人工审核、状态跟踪

## 🔄 数据备份

### 手动备份
```bash
cd server
npm run backup
```

### 自动备份
备份文件保存在 `backups/` 目录，文件名格式：`manual-backup-YYYY-MM-DDTHH-mm-ssZ`

## 🛡️ 安全特性

- JWT Token 认证
- 密码加密存储
- 请求频率限制
- SQL 注入防护
- XSS 攻击防护
- CSRF 保护

## 📊 性能优化

- MongoDB 索引优化
- 图片压缩和 CDN
- API 响应缓存
- 数据库连接池
- 静态资源压缩

## 🚀 部署

### 开发环境
```bash
npm run dev
```

### 生产环境
```bash
npm run build
npm start
```

详细部署说明请参考 [部署文档](./docs/deployment/)

## 🤝 贡献指南

1. Fork 项目
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 打开 Pull Request

## 📝 更新日志

### v1.2.0 (2025-12-21)
- ✅ 集成 MongoDB Atlas 云数据库
- ✅ 完善数据备份功能
- ✅ 优化文档结构
- ✅ 修复连接问题

### v1.1.0 (2025-12-18)
- ✅ 完成商家入驻审核系统
- ✅ 实现商品批量管理功能
- ✅ 添加数据统计模块
- ✅ 优化移动端体验

### v1.0.0 (2025-12-01)
- ✅ 基础电商功能完成
- ✅ 用户系统实现
- ✅ 支付系统集成
- ✅ 订单管理功能

## 📄 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情

## 📞 联系方式

- **项目维护者**: stu223
- **邮箱**: stu223@example.com
- **项目地址**: https://gitee.com/stu223/e-shop

## ⭐ 致谢

感谢所有为这个项目做出贡献的开发者和用户！

---

如果这个项目对你有帮助，请给它一个 ⭐ Star！