# laravel-longlongxiang

**Repository Path**: henryspace/laravel-longlongxiang

## Basic Information

- **Project Name**: laravel-longlongxiang
- **Description**: laravel-longlongxiang
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-15
- **Last Updated**: 2025-09-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 龙隆香果蔬汁 Laravel API 项目

## 项目概述

这是一个为龙隆香果蔬汁小程序提供的 Laravel 后端 API 服务。项目基于 Laravel 8 开发，提供了完整的电商功能，包括用户管理、商品管理、订单处理、购物车、优惠券系统等。

## 技术栈

- **后端框架**: Laravel 8
- **数据库**: MySQL 5.7+
- **认证**: Laravel Sanctum
- **API**: RESTful API
- **中间件**: CORS, 认证, 管理员权限

## 项目结构

```
backend/
├── app/
│   ├── Http/
│   │   ├── Controllers/          # 控制器
│   │   │   ├── AuthController.php     # 用户认证
│   │   │   ├── ProductController.php  # 商品管理
│   │   │   ├── CategoryController.php # 分类管理
│   │   │   ├── OrderController.php    # 订单管理
│   │   │   ├── CartController.php     # 购物车管理
│   │   │   ├── CouponController.php   # 优惠券管理
│   │   │   └── SmsController.php       # 短信服务
│   │   └── Middleware/
│   │       └── AdminMiddleware.php     # 管理员权限中间件
│   └── Models/                   # 数据模型
│       ├── User.php
│       ├── Product.php
│       ├── Category.php
│       ├── Order.php
│       ├── Cart.php
│       ├── Coupon.php
│       ├── UserCoupon.php
│       ├── PointsTransaction.php
│       ├── MemberLevel.php
│       └── SmsRecord.php
├── database/
│   ├── migrations/              # 数据库迁移文件
│   └── schema.sql              # 数据库结构文件
├── routes/
│   ├── api.php                 # API 路由
│   └── web.php
└── config/
    └── cors.php                # CORS 配置
```

## 数据库表结构

项目包含以下主要数据表：

### 核心表
- `users` - 用户表
- `categories` - 商品分类表
- `products` - 商品表
- `orders` - 订单表
- `order_items` - 订单项表
- `carts` - 购物车表

### 功能表
- `coupons` - 优惠券表
- `user_coupons` - 用户优惠券表
- `points_transactions` - 积分交易表
- `member_levels` - 会员等级表
- `sms_records` - 短信记录表

### 系统表
- `migrations` - 迁移记录表
- `failed_jobs` - 失败任务表
- `password_resets` - 密码重置表
- `personal_access_tokens` - 个人访问令牌表

## API 接口

### 认证相关
- `POST /api/auth/register` - 用户注册
- `POST /api/auth/login` - 用户登录
- `POST /api/auth/wechat-login` - 微信登录
- `POST /api/auth/logout` - 退出登录
- `GET /api/auth/me` - 获取用户信息
- `PUT /api/auth/profile` - 更新用户信息

### 商品相关
- `GET /api/products` - 获取商品列表
- `GET /api/products/featured` - 获取推荐商品
- `GET /api/products/search` - 搜索商品
- `GET /api/products/{id}` - 获取商品详情

### 分类相关
- `GET /api/categories` - 获取分类列表
- `GET /api/categories/{id}` - 获取分类详情
- `GET /api/categories/{id}/products` - 获取分类下的商品

### 购物车相关（需要认证）
- `GET /api/cart` - 获取购物车
- `POST /api/cart` - 添加到购物车
- `PUT /api/cart/{id}` - 更新购物车商品
- `DELETE /api/cart/{id}` - 删除购物车商品
- `DELETE /api/cart/clear` - 清空购物车

### 订单相关（需要认证）
- `GET /api/orders` - 获取订单列表
- `POST /api/orders` - 创建订单
- `GET /api/orders/{id}` - 获取订单详情
- `POST /api/orders/{id}/cancel` - 取消订单

### 优惠券相关（需要认证）
- `GET /api/coupons` - 获取优惠券列表
- `POST /api/coupons/{id}/claim` - 领取优惠券
- `GET /api/user/coupons` - 获取用户优惠券

### 短信相关（需要认证）
- `POST /api/sms/send` - 发送短信验证码
- `POST /api/sms/verify` - 验证短信验证码

### 管理员功能（需要管理员权限）
- 商品管理：增删改查
- 分类管理：增删改查
- 订单管理：更新状态

## 安装和运行

### 1. 环境要求
- PHP 7.4+
- MySQL 5.7+
- Composer

### 2. 安装步骤

```bash
# 进入项目目录
cd backend

# 安装依赖
composer install

# 配置环境文件
cp .env.example .env

# 生成应用密钥
php artisan key:generate

# 配置数据库连接
# 编辑 .env 文件中的数据库配置

# 运行数据库迁移
php artisan migrate

# 启动开发服务器
php artisan serve
```

### 3. 数据库配置

在 `.env` 文件中配置数据库连接：

```env
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=longlongxiang
DB_USERNAME=root
DB_PASSWORD=your_password
```

### 4. 创建管理员用户

```bash
# 在 Tinker 中创建管理员用户
php artisan tinker

>>> $user = new App\Models\User;
>>> $user->name = 'Admin';
>>> $user->email = 'admin@example.com';
>>> $user->password = Hash::make('password');
>>> $user->save();
>>> exit
```

## 前端对接

前端项目位于 `frontend/` 目录，使用 UniApp 开发。

### API 基础地址
- 开发环境：`http://localhost:8000/api`
- 生产环境：根据实际部署地址配置

### 认证方式
使用 Bearer Token 认证，在请求头中添加：
```
Authorization: Bearer {token}
```

## 功能特性

### 1. 用户系统
- 用户注册/登录
- 微信登录
- 个人信息管理
- 会员等级系统
- 积分系统

### 2. 商品系统
- 商品分类管理
- 商品搜索和筛选
- 商品详情展示
- 推荐商品
- 库存管理

### 3. 订单系统
- 购物车功能
- 订单创建和管理
- 订单状态跟踪
- 支付集成
- 订单取消

### 4. 营销系统
- 优惠券系统
- 积分兑换
- 会员折扣
- 推荐商品

### 5. 短信服务
- 短信验证码发送
- 短信验证码验证
- 短信记录管理

## 开发说明

### 代码规范
- 遵循 PSR-12 编码规范
- 使用 Laravel 最佳实践
- API 响应格式统一

### 错误处理
- 使用统一的错误响应格式
- 包含错误码和错误信息
- 适当的 HTTP 状态码

### 安全措施
- 用户认证和授权
- 输入验证和过滤
- SQL 注入防护
- XSS 防护

## 部署

### 1. 生产环境配置
- 设置 `APP_ENV=production`
- 设置 `APP_DEBUG=false`
- 配置正确的数据库连接
- 配置文件存储权限

### 2. 优化建议
- 使用 Redis 缓存
- 配置队列系统
- 启用 OPcache
- 使用 CDN 加速静态资源

## 常见问题

### 1. 数据库连接失败
- 检查数据库配置
- 确认数据库服务运行正常
- 验证数据库用户权限

### 2. CORS 错误
- 检查 CORS 配置
- 确认前端请求地址正确
- 验证请求头设置

### 3. 认证失败
- 检查 Token 是否正确
- 确认 Token 未过期
- 验证用户状态

## 贡献指南

1. Fork 项目
2. 创建功能分支
3. 提交代码
4. 创建 Pull Request

## 许可证

MIT License

## 联系方式

如有问题或建议，请联系开发团队。