创赢未来评分系统 - 初始化提交(移除大文件)
All checks were successful
Deploy to Server / deploy (push) Successful in 18s

This commit is contained in:
爽哒哒
2026-03-18 22:28:45 +08:00
commit f26d35da66
315 changed files with 36043 additions and 0 deletions

91
miniprogram/README.md Normal file
View File

@@ -0,0 +1,91 @@
# Market Miniprogram
Taro + React + TypeScript 微信小程序项目,对接 Django 后端,支持 AI 服务、AR 体验、硬件商品购买及分销功能。
## 目录结构
- `src/pages`: 主包页面 (首页、商品、订单、AI服务、AR体验)
- `src/subpackages`: 分包页面 (分销中心)
- `src/api`: API 定义
- `src/utils`: 工具函数
- `src/assets`: 静态资源
## 技术栈
- **框架**: Taro 3.6 (React)
- **语言**: TypeScript
- **样式**: SCSS
- **UI**: Taro UI / Ant Design (Design Reference)
- **后端**: Django REST Framework
## 快速开始
小程序id
wxdf2ca73e6c0929f0
### 1. 环境准备
确保已安装 Node.js (>=16) 和 npm。
### 2. 安装依赖
```bash
npm install --legacy-peer-deps
```
### 3. 配置环境
复制 `.env` 模板并配置后端地址:
```bash
# .env
TARO_APP_API_URL=http://localhost:8000/api
```
### 4. 启动开发
```bash
# 微信小程序开发
npm run dev:weapp
```
启动后打开 **微信开发者工具**,导入 `dist` 目录即可预览。
## 功能列表
1. **商品交易**: 浏览 ESP32 硬件配置,下单购买,微信支付。
2. **AI 服务**: 浏览 AI 解决方案,提交定制需求。
3. **AR 体验**: 展示 AR 案例,模拟启动体验。
4. **分销中心**: 申请成为分销员,生成推广码,查看收益,申请提现。
## 测试指南
### 支付测试
- 确保后端 `WeChatPayConfig` 已配置有效的沙箱或正式参数。
- 在小程序中下单后,点击支付将调用 `wx.requestPayment`
- 本地开发需确保手机与电脑在同一局域网,并将后端地址改为局域网 IP。
### 分销测试
1. 进入 "我的" -> "分销中心"。
2. 点击 "立即申请" (后端自动通过或需审核)。
3. 进入分销中心,点击 "推广二维码" 获取小程序码。
4. 模拟下单:在其他账号下单时填写 `ref_code` (或通过带参二维码进入)。
5. 查看收益:订单支付后,分销中心自动更新余额。
## 常见问题
**Q: 依赖安装失败?**
A: 使用 `npm install --legacy-peer-deps` 忽略版本冲突。
**Q: 接口请求 404/Network Error**
A: 检查 `.env` 中的 `TARO_APP_API_URL` 是否正确,真机调试时请勿使用 `localhost`,应使用本机局域网 IP (如 `192.168.1.x`),并确保手机能访问该 IP。
## 贡献指南
1. Fork 本仓库
2. 新建特性分支 `git checkout -b feature/AmazingFeature`
3. 提交修改 `git commit -m 'Add some AmazingFeature'`
4. 推送到分支 `git push origin feature/AmazingFeature`
5. 提交 Pull Request