# ToastMasterWechat

**Repository Path**: htswei/toast-master-wechat

## Basic Information

- **Project Name**: ToastMasterWechat
- **Description**: taost master wechat
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-26
- **Last Updated**: 2026-05-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# Toast Master 微信小程序

基于微信云开发的活动与产品管理小程序系统。

## 项目简介

Toast Master 是一个功能完善的微信小程序系统，适用于活动管理和产品展示场景。系统采用微信云开发（Cloud Base）作为后端服务，支持用户角色管理、活动发布、产品展示等功能，并提供了完善的后台管理系统。

## 技术栈

- **前端框架**：微信小程序原生开发
- **后端服务**：微信云开发（Cloud Base）
- **数据库**：云开发数据库
- **样式**：WXSS（微信样式表）

## 功能模块

### 用户系统
- 用户登录/注册
- 角色分级管理（普通用户、VIP、超级管理员）
- 用户状态管理（启用/禁用）

### 活动管理
- 活动列表展示
- 活动详情查看
- 活动发布/下架
- 活动编辑（管理员）

### 产品管理
- 产品列表展示
- 产品详情查看
- 产品发布/下架
- 产品编辑（管理员）

### 后台管理
- 用户管理
- 活动管理
- 产品管理
- 系统日志

## 系统架构

```
├── cloudfunctions/          # 云函数
│   ├── deleteActivity/    # 删除活动
│   ├── deleteProduct/     # 删除产品
│   ├── initDatabase/      # 初始化数据库
│   ├── login/            # 登录
│   ├── toggleUserStatus/ # 切换用户状态
│   ├── updateActivityStatus/
│   ├── updateProductStatus/
│   ├── updateUserRole/   # 更新用户角色
│
├── components/           # 自定义组件
│   └── navigation-bar/   # 导航栏
│
├── pages/                # 页面
│   ├── activities/       # 活动列表
│   ├── activity-detail/ # 活动详情
│   ├── admin/           # 管理后台
│   ├── index/           # 首页
│   ├── login/           # 登录
│   ├── logs/            # 日志
│   ├── product-detail/ # 产品详情
│   ├── products/        # 产品列表
│   ├── register/        # 注册
│   ├── user/            # 用户中心
│
├── services/             # 业务服务层
│   ├── activity.js      # 活动服务
│   ├── auth.js          # 认证服务
│   └── product.js       # 产品服务
│
└── utils/                # 工具函数
    ├── roles.js         # 角色权限
    └── util.js          # 通用工具
```

## 快速开始

### 环境要求

- 微信开发者工具
- 微信小程序 AppID

### 配置步骤

1. 在微信公众平台注册小程序并获取 AppID
2. 导入项目到微信开发者工具
3. 开通云开发环境
4. 部署云函数

### 初始化数据库

首次部署需要调用 `initDatabase` 云函数初始化数据库集合：

```javascript
// 在云函数控制台调用
await cloud.callFunction({
  name: 'initDatabase'
})
```

## 角色说明

| 角色 | 说明 | 权限 |
|------|------|------|
| 普通用户 | 注册用户 | 浏览、查看 |
| VIP | 高级用户 | 内容创建 |
| 管理员 | 内容管理 | 内容管理、用户管理 |
| 超级管理员 | 最高权限 | 全部权限 |

## 接口服务

### 活动服务 (services/activity.js)

```javascript
// 获取活动列表
getActivityList(status)

// 获取活动详情
getActivityDetail(activityId)

// 创建活动
createActivity(activityData, openid)

// 更新活动
updateActivity(activityId, activityData, openid)

// 删除活动
deleteActivity(activityId)

// 发布活动
publishActivity(activityId)

// 下架活动
unpublishActivity(activityId)
```

### 产品服务 (services/product.js)

```javascript
// 获取产品列表
getProductList(status)

// 获取产品详情
getProductDetail(productId)

// 创建产品
createProduct(productData, openid)

// 更新产品
updateProduct(productId, productData, openid)

// 删除产品
deleteProduct(productId)

// 发布产品
publishProduct(productId)

// 下架产品
unpublishProduct(productId)
```

### 用户服务 (services/auth.js)

```javascript
// 获取用户信息
getUserInfo(openid)

// 创建/更新用户
createOrUpdateUser(userInfo)

// 更新用户角色
updateUserRole(openid, role, adminOpenid)

// 获取用户列表
getUserList()

// 禁用用户
disableUser(openid, adminOpenid)

// 启用用户
enableUser(openid, adminOpenid)
```

## 开发指南

### 添加新页面

1. 在 `pages/` 目录下创建页面文件夹
2. 创建 `.js`、`.json`、`.wxml`、`.wxss` 文件
3. 在 `app.json` 中注册页面

### 添加云函数

1. 在 `cloudfunctions/` 目录下创建云函数文件夹
2. 编写云函数逻辑和配置文件
3. 右键上传并部署云函数

### 使用服务层

```javascript
const activityService = require('../../services/activity.js')

// 调用服务方法
Page({
  async onLoad() {
    const list = await activityService.getActivityList(1)
  }
})
```

## 注意事项

1. 所有云函数需要单独部署
2. 注意配置好云开发环境 ID
3. 生产环境请配置安全规则
4. 请妥善保管 AppID 和密钥

## 开源协议

本项目仅供学习交流使用。