soul-yongping/miniprogram

Soul派对·创业实验 - 微信小程序版

一场真实的商业探索，从Soul平台直播到私域运营实战

📱 项目简介

这是《Soul派对·创业实验》电子书的微信小程序版本，集成了以下核心功能：

🎯 核心功能

1. 电子书阅读

   • 完整的章节内容阅读
   • Markdown格式渲染
   • 书签和笔记功能
   • 阅读进度记录

2. 随机匹配书友（类Soul星球）

   • 实时匹配志同道合的读者
   • 星空背景动画效果
   • 共同兴趣展示
   • 匹配度计算

3. 微信支付（腾讯轻松付款）

   • 动态定价（9.9元起，每天+1元）
   • 微信支付接口集成
   • 订单管理
   • 支付状态查询

4. 分销系统

   • 90%高佣金比例
   • 推广海报生成
   • 邀请码分享
   • 收益统计和提现

5. 后台管理

   • 内容管理模块
   • 付费管理模块
   • 分销管理模块
   • 实时数据同步

🚀 快速开始

1. 环境准备

• 微信开发者工具（最新版）
• Node.js 16.x 或以上
• pnpm 或 npm

2. 配置小程序

修改 project.config.json：

{
  "appid": "你的小程序AppID",
  "projectname": "soul-party-book"
}

3. 配置API地址

修改 app.js 中的 apiBase：

globalData: {
  apiBase: 'https://your-domain.com/api', // 改为你的实际域名
}

4. 导入项目

1. 打开微信开发者工具
2. 选择"导入项目"
3. 选择 miniprogram 文件夹
4. 填入小程序AppID
5. 点击"导入"

5. 运行项目

• 点击"编译"按钮
• 在模拟器中查看效果
• 或扫码在真机上预览

📂 目录结构

miniprogram/
├── pages/              # 页面目录
│   ├── index/         # 首页（书籍展示）
│   ├── match/         # 匹配书友页
│   ├── my/            # 我的页面（含分销）
│   ├── read/          # 阅读页面
│   └── chapters/      # 章节列表
├── utils/             # 工具类
│   └── payment.js     # 微信支付工具
├── assets/            # 静态资源
│   ├── images/        # 图片
│   └── icons/         # 图标
├── app.js             # 小程序入口
├── app.json           # 小程序配置
├── app.wxss           # 全局样式
└── project.config.json # 项目配置

🔧 后端API配置

必需的API接口

小程序需要以下后端API支持：

1. 认证接口

POST /api/auth/wx-login      # 微信登录
POST /api/auth/validate      # Token验证

2. 书籍接口

GET  /api/book/structure      # 获取书籍结构
GET  /api/book/latest-chapters # 获取最新章节
GET  /api/book/chapter/:id    # 获取章节内容
GET  /api/book/chapters       # 获取所有章节

3. 支付接口

POST /api/payment/create      # 创建支付订单
POST /api/payment/notify      # 支付回调通知
GET  /api/payment/query       # 查询订单状态

4. 匹配接口

GET  /api/match/online-count  # 获取在线人数
POST /api/match/find          # 开始匹配
GET  /api/match/recent        # 获取最近匹配

5. 分销接口

GET  /api/referral/earnings   # 获取收益数据
GET  /api/referral/stats      # 获取推广统计

6. 用户接口

GET  /api/user/stats          # 获取用户统计
POST /api/user/read-progress  # 记录阅读进度

API服务器部署

后端API已在项目的 app/api/ 目录下实现，使用 Next.js API Routes。

启动后端服务：

# 在项目根目录
pnpm install
pnpm dev

服务将运行在 http://localhost:3000

💰 支付配置

1. 申请微信支付

1. 登录微信支付商户平台
2. 申请开通"小程序支付"
3. 获取商户号和API密钥

2. 配置支付参数

在后端配置文件中设置：

// 微信支付配置
const WECHAT_PAY_CONFIG = {
  appId: 'your-miniprogram-appid',
  mchId: '你的商户号',
  apiKey: '你的API密钥',
  notifyUrl: 'https://your-domain.com/api/payment/notify'
}

3. 配置服务器域名

在小程序后台 → 开发管理 → 开发设置 → 服务器域名：

request合法域名:
- https://your-domain.com

uploadFile合法域名:
- https://your-domain.com

downloadFile合法域名:
- https://your-domain.com

🎨 界面定制

修改主题色

在 app.wxss 中修改：

.brand-color {
  color: #FF4D4F;  /* 改为你的品牌色 */
}

.brand-bg {
  background-color: #FF4D4F;
}

修改Logo和图标

替换 assets/images/ 目录下的图片：

• book-cover.png - 书籍封面
• planet.png - 匹配星球图标
• share-cover.png - 分享封面
• default-avatar.png - 默认头像

📊 后台管理

访问后台管理系统：https://your-domain.com/admin

管理模块

1. 内容管理 - /api/admin/content

   • 章节列表
   • 创建/编辑/删除章节
   • 发布管理

2. 付费管理 - /api/admin/payment

   • 订单列表
   • 收益统计
   • 退款处理

3. 分销管理 - /api/admin/referral

   • 推广者列表
   • 佣金结算
   • 数据分析

默认账号

用户名: admin
密码: admin123

⚠️ 上线前务必修改默认密码！

🔄 实时同步

章节内容会自动从 book/ 目录同步到小程序。

手动触发同步：

curl -X POST https://your-domain.com/api/sync \
  -H "Content-Type: application/json" \
  -d '{"force": true}'

📝 开发说明

添加新页面

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

调试技巧

1. 使用 console.log() 输出调试信息
2. 在开发者工具中查看 Network 请求
3. 使用真机调试测试支付功能

🚢 发布上线

1. 代码审核

1. 点击"上传"按钮
2. 填写版本号和项目备注
3. 提交审核

2. 审核要点

• 确保所有功能正常
• 支付功能需完整测试
• 用户隐私协议完善
• 内容合规检查

3. 发布版本

审核通过后，在小程序后台点击"发布"。

📚 项目文档

• 项目文档：查看 /开发文档/ 目录
• 使用说明：参考本文档

📄 许可证

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

---

卡若 @ 2025年1月
一场真实的创业实验，从0到1的完整记录。