# specialty_e-commerce

**Repository Path**: cc132678/specialty_e-commerce

## Basic Information

- **Project Name**: specialty_e-commerce
- **Description**: 基于微信小程序与云开发技术的传统特产电商平台的设计与实现
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-26
- **Last Updated**: 2026-03-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 特产电商小程序项目部署指南

本文档说明如何在新电脑上部署和启动本项目。

## 项目概述

本项目是一个基于微信小程序云开发的特产电商系统，包含三个主要部分：

- **小程序端**（miniprogram）：用户购物界面
- **管理后台**（admin-web）：商品和订单管理
- **云函数**（cloudfunctions）：后端业务逻辑

## 技术栈

- 小程序端：微信小程序原生开发 + Vant Weapp
- 管理后台：Vue 3 + Vite + Element Plus + Pinia
- 云函数：Node.js + 腾讯云开发
- 数据库：微信云开发数据库

## 环境要求

### 必需软件

1. **Node.js**
   - 版本：建议 16.x 或更高
   - 下载地址：https://nodejs.org/

2. **微信开发者工具**
   - 用于开发和调试小程序
   - 下载地址：https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html

3. **Git**（可选）
   - 用于版本控制
   - 下载地址：https://git-scm.com/

### 账号准备

1. **微信小程序账号**
   - 需要已注册的小程序账号
   - AppID：xxxxxx（当前项目）

2. **腾讯云开发环境**
   - 需要开通云开发服务
   - 已有云环境可直接使用

## 部署步骤

### 1. 获取项目代码

```bash
# 如果使用 Git
git clone <项目仓库地址>
cd specialty-E-commerce

# 或者直接复制项目文件夹到新电脑
```

### 2. 安装依赖

项目有三个部分需要分别安装依赖：

#### 2.1 小程序端依赖

```bash
cd miniprogram
npm install
```

安装完成后，需要在微信开发者工具中构建 npm：
- 打开微信开发者工具
- 菜单：工具 → 构建 npm
- 等待构建完成

#### 2.2 管理后台依赖

```bash
cd admin-web
npm install
```

#### 2.3 云函数依赖

每个云函数都需要单独安装依赖：

```bash
# adminApi 云函数
cd cloudfunctions/adminApi
npm install

# login 云函数
cd ../login
npm install

# quickstartFunctions 云函数
cd ../quickstartFunctions
npm install

# 其他云函数同理...
```

### 3. 配置云开发环境

#### 3.1 配置小程序云环境

1. 打开 `miniprogram/envList.js`
2. 配置你的云环境 ID：

```javascript
const envList = [
  { envId: 'your-env-id', alias: '正式环境' }
]
```

#### 3.2 配置管理后台

1. 打开 `admin-web/vite.config.js`
2. 修改云函数地址（如果需要）：

```javascript
server: {
  proxy: {
    '/api': {
      target: 'https://your-cloud-function-url.com',
      // ...
    }
  }
}
```

### 4. 上传云函数

使用微信开发者工具上传云函数：

1. 打开微信开发者工具
2. 导入项目（选择项目根目录）
3. 在云开发控制台中：
   - 点击「云函数」
   - 右键每个云函数文件夹
   - 选择「上传并部署：云端安装依赖」

需要上传的云函数：
- adminApi（管理后台 API）
- login（登录功能）
- quickstartFunctions（快速开始）
- fileRefManager（文件引用管理）
- recordFileIndex（文件索引记录）

### 5. 配置数据库

在微信开发者工具的云开发控制台中：

1. 创建以下集合（数据表）：
   - `products`（商品）
   - `orders`（订单）
   - `users`（用户）
   - `categories`（分类）
   - `files`（文件）
   - `admin_users`（管理员）

2. 设置权限：
   - 根据需要配置每个集合的读写权限
   - 建议：用户端只读，云函数可读写

3. 初始化管理员账号：
   - 在 `admin_users` 集合中添加初始管理员
   - 默认账号：admin / admin123

### 6. 启动项目

#### 6.1 启动小程序端

1. 打开微信开发者工具
2. 导入项目
3. 选择项目根目录
4. 填入 AppID
5. 点击「编译」按钮

#### 6.2 启动管理后台

```bash
cd admin-web
npm run dev
```

访问地址：http://localhost:3000

默认登录账号：
- 用户名：admin
- 密码：admin123

## 常见问题

### 1. npm install 失败

**问题**：依赖安装失败或速度慢

**解决方案**：
```bash
# 使用国内镜像
npm config set registry https://registry.npmmirror.com

# 或使用 cnpm
npm install -g cnpm
cnpm install
```

### 2. 云函数上传失败

**问题**：云函数上传时报错

**解决方案**：
- 检查网络连接
- 确认已开通云开发服务
- 检查云函数代码是否有语法错误
- 尝试删除 node_modules 后重新安装

### 3. 管理后台无法登录

**问题**：登录时提示错误

**解决方案**：
1. 检查云函数是否已上传
2. 检查 vite.config.js 中的代理配置
3. 查看浏览器控制台的网络请求
4. 确认数据库中有管理员账号

### 4. 小程序无法连接云开发

**问题**：小程序提示云开发初始化失败

**解决方案**：
- 检查 envList.js 中的环境 ID 是否正确
- 确认已在云开发控制台开通服务
- 检查小程序 AppID 是否正确

### 5. 构建 npm 失败

**问题**：微信开发者工具构建 npm 时报错

**解决方案**：
- 确保 miniprogram 目录下有 package.json
- 删除 miniprogram_npm 文件夹后重新构建
- 检查 project.config.json 中的 setting.nodeModules 是否为 true

## 开发调试

### 小程序端调试

- 使用微信开发者工具的调试器
- 查看控制台日志
- 使用云开发控制台查看云函数日志

### 管理后台调试

```bash
cd admin-web
npm run dev
```

- 浏览器访问 http://localhost:3000
- 使用浏览器开发者工具（F12）
- 查看 Network 标签检查 API 请求

### 云函数调试

- 在云开发控制台查看云函数日志
- 使用云函数测试功能
- 在代码中添加 console.log 输出日志

## 项目构建

### 管理后台打包

```bash
cd admin-web
npm run build
```

构建产物在 `admin-web/dist` 目录

### 小程序发布

1. 在微信开发者工具中点击「上传」
2. 填写版本号和项目备注
3. 登录小程序管理后台
4. 提交审核
5. 审核通过后发布

## 项目结构

```
specialty-E-commerce/
├── miniprogram/          # 小程序端
│   ├── pages/           # 页面
│   ├── components/      # 组件
│   ├── utils/           # 工具函数
│   └── app.js           # 小程序入口
├── admin-web/           # 管理后台
│   ├── src/
│   │   ├── views/       # 页面
│   │   ├── components/  # 组件
│   │   ├── utils/       # 工具函数
│   │   └── main.js      # 入口文件
│   └── vite.config.js   # Vite 配置
├── cloudfunctions/      # 云函数
│   ├── adminApi/        # 管理后台 API
│   ├── login/           # 登录
│   └── ...              # 其他云函数
└── docs/                # 文档
```

## 注意事项

1. **环境变量**：不要将敏感信息（如密钥）提交到代码仓库
2. **云函数更新**：修改云函数后需要重新上传
3. **数据库权限**：生产环境注意设置合理的权限规则
4. **小程序审核**：发布前确保符合微信小程序规范
5. **备份数据**：定期备份云数据库数据

## 技术支持

如遇到问题，可以：
- 查看微信小程序官方文档：https://developers.weixin.qq.com/miniprogram/dev/
- 查看云开发文档：https://developers.weixin.qq.com/miniprogram/dev/wxcloud/basis/getting-started.html
- 检查项目中的其他文档文件

## 更新日志

- 2026-02-28：创建项目部署指南