f3195d9331
Simplify homepage, show chapter counts, display directory, trim bottom nav, in-page match feature, move marketing content, and enhance "My" page. #VERCEL_SKIP Co-authored-by: undefined <undefined+undefined@users.noreply.github.com>
Soul派对·创业实验 - 微信小程序版
一场真实的商业探索，从Soul平台直播到私域运营实战
📱 项目简介
这是《Soul派对·创业实验》电子书的微信小程序版本，集成了以下核心功能：
🎯 核心功能
-
电子书阅读
- 完整的章节内容阅读
- Markdown格式渲染
- 书签和笔记功能
- 阅读进度记录
-
随机匹配书友（类Soul星球）
- 实时匹配志同道合的读者
- 星空背景动画效果
- 共同兴趣展示
- 匹配度计算
-
微信支付（腾讯轻松付款）
- 动态定价（9.9元起，每天+1元）
- 微信支付接口集成
- 订单管理
- 支付状态查询
-
分销系统
- 90%高佣金比例
- 推广海报生成
- 邀请码分享
- 收益统计和提现
-
后台管理
- 内容管理模块
- 付费管理模块
- 分销管理模块
- 实时数据同步
🚀 快速开始
1. 环境准备
- 微信开发者工具（最新版）
- Node.js 16.x 或以上
- pnpm 或 npm
2. 配置小程序
修改 project.config.json：
```json { "appid": "你的小程序AppID", "projectname": "soul-party-book" } ```
3. 配置API地址
修改 app.js 中的 apiBase：
```javascript globalData: { apiBase: 'https://your-domain.com/api', // 改为你的实际域名 } ```
4. 导入项目
- 打开微信开发者工具
- 选择"导入项目"
- 选择
miniprogram文件夹 - 填入小程序AppID
- 点击"导入"
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。
启动后端服务：
```bash
在项目根目录
pnpm install pnpm dev ```
服务将运行在 http://localhost:3000
💰 支付配置
1. 申请微信支付
- 登录微信支付商户平台
- 申请开通"小程序支付"
- 获取商户号和API密钥
2. 配置支付参数
在后端配置文件中设置：
```javascript // 微信支付配置 const WECHAT_PAY_CONFIG = { appId: 'your-miniprogram-appid', mchId: '你的商户号', apiKey: '你的API密钥', notifyUrl: 'https://your-domain.com/api/payment/notify' } ```
3. 配置服务器域名
在小程序后台 → 开发管理 → 开发设置 → 服务器域名：
``` request合法域名:
uploadFile合法域名:
downloadFile合法域名:
🎨 界面定制
修改主题色
在 app.wxss 中修改：
```css .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
管理模块
-
内容管理 -
/api/admin/content- 章节列表
- 创建/编辑/删除章节
- 发布管理
-
付费管理 -
/api/admin/payment- 订单列表
- 收益统计
- 退款处理
-
分销管理 -
/api/admin/referral- 推广者列表
- 佣金结算
- 数据分析
默认账号
``` 用户名: admin 密码: admin123 ```
⚠️ 上线前务必修改默认密码！
🔄 实时同步
章节内容会自动从 book/ 目录同步到小程序。
手动触发同步：
```bash
curl -X POST https://your-domain.com/api/sync
-H "Content-Type: application/json"
-d '{"force": true}'
```
📝 开发说明
添加新页面
- 在
pages/目录下创建页面文件夹 - 创建
.wxml、.wxss、.js文件 - 在
app.json的pages数组中注册
调试技巧
- 使用
console.log()输出调试信息 - 在开发者工具中查看 Network 请求
- 使用真机调试测试支付功能
🚢 发布上线
1. 代码审核
- 点击"上传"按钮
- 填写版本号和项目备注
- 提交审核
2. 审核要点
- 确保所有功能正常
- 支付功能需完整测试
- 用户隐私协议完善
- 内容合规检查
3. 发布版本
审核通过后，在小程序后台点击"发布"。
📚 项目文档
- 项目文档：查看
/开发文档/目录 - 使用说明：参考本文档
📄 许可证
本项目仅供学习交流使用。
卡若 @ 2025年1月
一场真实的创业实验，从0到1的完整记录。