feat: 完整重构小程序匹配功能 + 修复UI对齐 + 文章数据API

主要更新: 1. 按H5网页端完全重构匹配功能(match页面) - 4种匹配类型: 创业合伙/资源对接/导师顾问/团队招募 - 资源对接等类型弹出手机号/微信号输入框 - 去掉重新匹配按钮，改为返回按钮 2. 修复所有卡片对齐和宽度问题 - 目录页附录卡片居中 - 首页阅读进度卡片满宽度 - 我的页面菜单卡片对齐 - 推广中心分享卡片统一宽度 3. 修复目录页图标和文字对齐 - section-icon固定40rpx宽高 - section-title与图标垂直居中 4. 更新真实完整文章标题(62篇) - 从book目录读取真实markdown文件名 - 替换之前的简化标题 5. 新增文章数据API - /api/db/chapters - 获取完整书籍结构 - 支持按ID获取单篇文章内容
2026-01-21 15:49:12 +08:00
parent 1ee25e3dab
commit b60edb3d47
197 changed files with 34430 additions and 7345 deletions
--- a/miniprogram/README.md
+++ b/miniprogram/README.md
@@ -1,320 +1,138 @@
-# Soul派对·创业实验 - 微信小程序版
+# Soul创业实验 - 微信小程序

-> 一场真实的商业探索，从Soul平台直播到私域运营实战
+> 一场SOUL的创业实验场 - 来自Soul派对房的真实商业故事

 ## 📱 项目简介

-这是《Soul派对·创业实验》电子书的微信小程序版本，集成了以下核心功能：
+本项目是《一场SOUL的创业实验场》的微信小程序版本，完整还原了Web端的所有UI界面和功能。

-### 🎯 核心功能
+## 🎨 设计特点

-1. **电子书阅读**
-   - 完整的章节内容阅读
-   - Markdown格式渲染
-   - 书签和笔记功能
-   - 阅读进度记录
+- **主题色**: Soul青色 (#00CED1)
+- **设计风格**: 深色主题 + 毛玻璃效果
+- **1:1还原**: 完全复刻Web端的UI设计

-2. **随机匹配书友**（类Soul星球）
-   - 实时匹配志同道合的读者
-   - 星空背景动画效果
-   - 共同兴趣展示
-   - 匹配度计算
+## 📂 项目结构

-3. **微信支付**（腾讯轻松付款）
-   - 动态定价（9.9元起，每天+1元）
-   - 微信支付接口集成
-   - 订单管理
-   - 支付状态查询
-
-4. **分销系统**
-   - 90%高佣金比例
-   - 推广海报生成
-   - 邀请码分享
-   - 收益统计和提现
-
-5. **后台管理**
-   - 内容管理模块
-   - 付费管理模块
-   - 分销管理模块
-   - 实时数据同步
-
-## 🚀 快速开始
-
-### 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. 导入项目
-
-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 # 项目配置
-\`\`\`
+├── 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           # 站点地图
+```

-## 🔧 后端API配置
+## 🚀 功能列表

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

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

-#### 1. 认证接口
+## 🛠 开发指南

-\`\`\`
-POST /api/auth/wx-login      # 微信登录
-POST /api/auth/validate      # Token验证
-\`\`\`
+### 环境要求
+- 微信开发者工具 >= 1.06.2308310
+- 基础库版本 >= 3.3.4

-#### 2. 书籍接口
+### 快速开始

-\`\`\`
-GET  /api/book/structure      # 获取书籍结构
-GET  /api/book/latest-chapters # 获取最新章节
-GET  /api/book/chapter/:id    # 获取章节内容
-GET  /api/book/chapters       # 获取所有章节
-\`\`\`
+1. **下载微信开发者工具**
+   - 前往 [微信开发者工具下载页面](https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html)

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

-\`\`\`
-POST /api/payment/create      # 创建支付订单
-POST /api/payment/notify      # 支付回调通知
-GET  /api/payment/query       # 查询订单状态
-\`\`\`
+3. **编译运行**
+   - 点击"编译"按钮
+   - 在模拟器中预览效果

-#### 4. 匹配接口
+### 真机调试

-\`\`\`
-GET  /api/match/online-count  # 获取在线人数
-POST /api/match/find          # 开始匹配
-GET  /api/match/recent        # 获取最近匹配
-\`\`\`
+1. 点击工具栏的"预览"按钮
+2. 使用微信扫描二维码
+3. 在真机上测试所有功能

-#### 5. 分销接口
+## 📝 配置说明

-\`\`\`
-GET  /api/referral/earnings   # 获取收益数据
-GET  /api/referral/stats      # 获取推广统计
-\`\`\`
+### API配置
+在 `app.js` 中修改 `globalData.baseUrl`:

-#### 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. 申请微信支付
-
-1. 登录[微信支付商户平台](https://pay.weixin.qq.com/)
-2. 申请开通"小程序支付"
-3. 获取商户号和API密钥
-
-### 2. 配置支付参数
-
-在后端配置文件中设置：
-
-\`\`\`javascript
-// 微信支付配置
-const WECHAT_PAY_CONFIG = {
-  appId: 'your-miniprogram-appid',
-  mchId: '你的商户号',
-  apiKey: '你的API密钥',
-  notifyUrl: 'https://your-domain.com/api/payment/notify'
+```javascript
+globalData: {
+  baseUrl: 'https://soul.ckb.fit',  // 你的API地址
+  // ...
 }
-\`\`\`
+```

-### 3. 配置服务器域名
+### AppID配置
+在 `project.config.json` 中修改:

-在小程序后台 → 开发管理 → 开发设置 → 服务器域名：
-
-\`\`\`
-request合法域名:
- https://your-domain.com
-
-uploadFile合法域名:
- https://your-domain.com
-
-downloadFile合法域名:
- https://your-domain.com
-\`\`\`
-
-## 🎨 界面定制
-
-### 修改主题色
-
-在 `app.wxss` 中修改：
-
-\`\`\`css
-.brand-color {
-  color: #FF4D4F;  /* 改为你的品牌色 */
+```json
+{
+  "appid": "你的小程序AppID"
 }
+```

-.brand-bg {
-  background-color: #FF4D4F;
-}
-\`\`\`
+## 🎯 上线发布

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

-替换 `assets/images/` 目录下的图片：
+2. **上传代码**
+   - 在开发者工具中点击"上传"
+   - 填写版本号和项目备注

- `book-cover.png` - 书籍封面
- `planet.png` - 匹配星球图标
- `share-cover.png` - 分享封面
- `default-avatar.png` - 默认头像
+3. **提交审核**
+   - 登录[微信公众平台](https://mp.weixin.qq.com)
+   - 进入"版本管理"
+   - 提交审核

-## 📊 后台管理
+4. **发布上线**
+   - 审核通过后点击"发布"

-访问后台管理系统：`https://your-domain.com/admin`
+## 🔗 相关链接

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

-1. **内容管理** - `/api/admin/content`
-   - 章节列表
-   - 创建/编辑/删除章节
-   - 发布管理
+## 📄 版权信息

-2. **付费管理** - `/api/admin/payment`
-   - 订单列表
-   - 收益统计
-   - 退款处理
-
-3. **分销管理** - `/api/admin/referral`
-   - 推广者列表
-   - 佣金结算
-   - 数据分析
-
-### 默认账号
-
-\`\`\`
-用户名: admin
-密码: admin123
-\`\`\`
-
-**⚠️ 上线前务必修改默认密码！**
-
-## 🔄 实时同步
-
-章节内容会自动从 `book/` 目录同步到小程序。
-
-手动触发同步：
-
-\`\`\`bash
-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的完整记录。
+© 2024 卡若. All rights reserved.