# aigc-demo

**Repository Path**: lggyx/aigc-demo

## Basic Information

- **Project Name**: aigc-demo
- **Description**: AIGC课程作业
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-16
- **Last Updated**: 2025-09-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 外卖小程序

一个基于微信小程序开发的外卖点餐应用，提供完整的点餐、购物车、订单管理等功能。

## 项目概述

本项目是一个功能完整的外卖小程序，包含用户端的所有核心功能：
- 用户登录认证
- 菜品分类浏览
- 购物车管理
- 地址管理
- 订单下单和支付
- 订单历史查询

## 技术栈

- **前端框架**: 微信小程序原生开发
- **开发工具**: 微信开发者工具
- **版本管理**: Git
- **API接口**: RESTful API
- **数据存储**: 微信小程序本地存储 + 后端数据库

## 项目结构

```
takeaway-miniprogram/
├── app.js                 # 小程序入口文件
├── app.json              # 小程序全局配置
├── app.wxss              # 小程序全局样式
├── sitemap.json          # 站点地图配置
├── project.config.json   # 项目配置文件
├── package.json          # 项目依赖配置
├── README.md             # 项目说明文档
├── docs/                 # 文档目录
│   ├── API接口文档.md
│   ├── 需求说明文档.md
│   └── 小程序目录结构.md
├── pages/                # 页面目录
│   ├── index/            # 首页
│   ├── category/         # 分类页面
│   ├── dish/             # 菜品详情页面
│   ├── setmeal/          # 套餐详情页面
│   ├── cart/             # 购物车页面
│   ├── address/          # 地址管理页面
│   ├── address-edit/     # 地址编辑页面
│   ├── order/            # 订单页面
│   ├── order-detail/     # 订单详情页面
│   ├── order-list/       # 订单列表页面
│   ├── profile/          # 个人中心页面
│   └── login/            # 登录页面
├── components/           # 自定义组件目录
├── utils/                # 工具类目录
│   ├── api.js            # API接口封装
│   ├── auth.js           # 认证相关工具
│   ├── storage.js        # 本地存储工具
│   ├── request.js        # 网络请求封装
│   ├── format.js         # 格式化工具
│   └── constants.js      # 常量定义
├── images/               # 图片资源目录
└── styles/               # 样式文件目录
```

## 功能特性

### 1. 用户系统
- 微信授权登录
- 用户信息管理
- 登录状态维护

### 2. 商品浏览
- 分类展示
- 菜品详情
- 套餐信息
- 图片展示

### 3. 购物车
- 添加商品
- 数量调整
- 价格计算
- 清空购物车

### 4. 地址管理
- 地址列表
- 新增地址
- 编辑地址
- 删除地址
- 默认地址设置

### 5. 订单系统
- 订单确认
- 支付功能
- 订单状态跟踪
- 历史订单查询
- 订单详情查看

### 6. 其他功能
- 店铺营业状态
- 搜索功能
- 分享功能
- 错误处理

## 安装和运行

### 环境要求
- 微信开发者工具
- Node.js (可选，用于代码检查)

### 安装步骤

1. **克隆项目**
   ```bash
   git clone <repository-url>
   cd takeaway-miniprogram
   ```

2. **安装依赖** (可选)
   ```bash
   npm install
   ```

3. **配置项目**
   - 在微信开发者工具中打开项目
   - 修改 `project.config.json` 中的 `appid`
   - 配置后端API地址

4. **运行项目**
   - 在微信开发者工具中点击"编译"
   - 在模拟器中预览或真机调试

## 配置说明

### 1. 后端API配置
在 `utils/constants.js` 中修改API基础地址：
```javascript
export const API_BASE_URL = 'http://your-api-domain.com'
```

### 2. 小程序配置
在 `project.config.json` 中配置小程序AppID：
```json
{
  "appid": "your-miniprogram-appid"
}
```

### 3. 页面配置
在 `app.json` 中配置页面路径和tabBar等。

## API接口

项目使用RESTful API设计，主要接口包括：

- **用户接口**: 登录、退出
- **分类接口**: 获取分类列表
- **菜品接口**: 获取菜品列表
- **套餐接口**: 获取套餐列表
- **购物车接口**: 增删改查购物车
- **地址接口**: 地址管理
- **订单接口**: 订单相关操作
- **店铺接口**: 店铺状态

详细的API文档请参考 `docs/API接口文档.md`。

## 开发规范

### 1. 代码规范
- 使用ES6+语法
- 统一的命名规范
- 适当的注释说明
- 错误处理机制

### 2. 文件命名
- 页面文件：小写字母，用连字符分隔
- 组件文件：小写字母，用连字符分隔
- 工具文件：小写字母，用连字符分隔

### 3. 样式规范
- 使用rpx单位
- 统一的颜色变量
- 响应式设计
- 组件化样式

## 部署说明

### 1. 开发环境
- 使用微信开发者工具进行开发和调试
- 配置测试环境API地址

### 2. 生产环境
- 提交代码审核
- 发布到微信小程序平台
- 配置生产环境API地址

## 版本历史

### v1.0.0 (2024-01-01)
- 初始版本发布
- 实现基础功能
- 用户登录和商品浏览
- 购物车和订单功能

## 贡献指南

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

## 许可证

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

## 联系方式

- 项目维护者: [Your Name]
- 邮箱: [your.email@example.com]
- 项目链接: [https://github.com/username/takeaway-miniprogram](https://github.com/username/takeaway-miniprogram)

## 常见问题

### Q: 如何修改API地址？
A: 在 `utils/constants.js` 文件中修改 `API_BASE_URL` 常量。

### Q: 如何添加新的页面？
A: 在 `pages` 目录下创建新的页面文件夹，并在 `app.json` 的 `pages` 数组中添加页面路径。

### Q: 如何处理网络错误？
A: 项目已集成统一的错误处理机制，在 `utils/request.js` 中处理网络请求错误。

### Q: 如何自定义主题颜色？
A: 在 `app.wxss` 中修改CSS变量，或在各个页面的样式文件中覆盖默认颜色。

## 更新日志

### 2024-01-01
- 项目初始化
- 完成基础架构搭建
- 实现用户登录功能
- 完成首页开发

---

**注意**: 这是一个演示项目，实际使用时请根据具体需求进行调整和完善。