soul/miniprogram/README.md

# Soul创业实验 - 微信小程序

> 一场SOUL的创业实验场 - 来自Soul派对房的真实商业故事

## 📱 项目简介

本项目是《一场SOUL的创业实验场》的微信小程序版本，完整还原了Web端的所有UI界面和功能。

## 🎨 设计特点

- **主题色**: Soul青色 (#00CED1)
- **设计风格**: 深色主题 + 毛玻璃效果
- **1:1还原**: 完全复刻Web端的UI设计

## 📂 项目结构

```
miniprogram/
├── app.js                 # 应用入口
├── app.json               # 应用配置
├── app.wxss               # 全局样式
├── custom-tab-bar/        # 自定义TabBar组件
│   ├── index.js
│   ├── index.json
│   ├── index.wxml
│   └── index.wxss
├── pages/
│   ├── index/             # 首页
│   ├── chapters/          # 目录页
│   ├── match/             # 找伙伴页
│   ├── my/                # 我的页面
│   ├── read/              # 阅读页
│   ├── about/             # 关于作者
│   ├── referral/          # 推广中心
│   ├── purchases/         # 订单页
│   └── settings/          # 设置页
├── utils/
│   ├── util.js            # 工具函数
│   └── payment.js         # 支付工具
├── assets/
│   └── icons/             # 图标资源
├── project.config.json    # 项目配置
└── sitemap.json           # 站点地图
```

## 🚀 功能列表

### 核心功能
- ✅ 首页 - 书籍展示、推荐章节、阅读进度
- ✅ 目录 - 完整章节列表、篇章折叠展开
- ✅ 找伙伴 - 匹配动画、匹配类型选择
- ✅ 我的 - 个人信息、订单、推广中心
- ✅ 阅读 - 付费墙、章节导航、分享功能

### 特色功能
- ✅ 自定义TabBar（中间突出的找伙伴按钮）
- ✅ 阅读进度条
- ✅ 匹配动画效果
- ✅ 付费墙与购买流程
- ✅ 分享海报功能
- ✅ 推广佣金系统

## 🛠 开发指南

### 环境要求
- 微信开发者工具 >= 1.06.2308310
- 基础库版本 >= 3.3.4

### 快速开始

1. **下载微信开发者工具**
   - 前往 [微信开发者工具下载页面](https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html)

2. **导入项目**
   - 打开微信开发者工具
   - 选择"导入项目"
   - 项目目录选择 `miniprogram` 文件夹
   - AppID 使用: `wx432c93e275548671`

3. **编译运行**
   - 点击"编译"按钮
   - 在模拟器中预览效果

### 真机调试

1. 点击工具栏的"预览"按钮
2. 使用微信扫描二维码
3. 在真机上测试所有功能

## 📝 配置说明

### API配置
在 `app.js` 中修改 `globalData.baseUrl`:

```javascript
globalData: {
  baseUrl: 'https://soul.ckb.fit',  // 你的API地址
  // ...
}
```

### AppID配置
在 `project.config.json` 中修改:

```json
{
  "appid": "你的小程序AppID"
}
```

## 🎯 上线发布

1. **准备工作**
   - 确保所有功能测试通过
   - 检查API接口是否正常
   - 确认支付功能已配置

2. **上传代码**
   - 在开发者工具中点击"上传"
   - 填写版本号和项目备注

3. **提交审核**
   - 登录[微信公众平台](https://mp.weixin.qq.com)
   - 进入"版本管理"
   - 提交审核

4. **发布上线**
   - 审核通过后点击"发布"

## 🔗 相关链接

- **Web版本**: https://soul.ckb.fit
- **作者微信**: 28533368
- **技术支持**: 存客宝

## 📄 版权信息

© 2024 卡若. All rights reserved.