382 lines
8.0 KiB
Markdown
382 lines
8.0 KiB
Markdown
# 🎉 一场SOUL的创业实验场
|
||
|
||
> 来自Soul派对房的真实商业故事 - "社会不是靠努力，是靠洞察与选择"
|
||
|
||
[](LICENSE)
|
||
[](https://github.com)
|
||
[](https://github.com)
|
||
|
||
## 📖 项目简介
|
||
|
||
这是一个创新的创业实验项目，通过**小程序**和**H5双端**，分享来自Soul派对房的真实商业案例和创业洞察。
|
||
|
||
- 📚 **64个真实商业案例**
|
||
- 💼 **5大核心篇章**
|
||
- 🎯 **100+商业洞察**
|
||
- 🤝 **寻找合作伙伴功能**
|
||
- 💰 **90%佣金分销系统**
|
||
|
||
---
|
||
|
||
## ✨ 核心功能
|
||
|
||
### 1. 📱 双端统一
|
||
- **微信小程序**：完整的阅读和社交体验
|
||
- **H5网页版**：无缝的移动端体验
|
||
- **界面100%统一**：设计、配色、交互完全一致
|
||
|
||
### 2. 🤝 寻找合作伙伴
|
||
- 基于商业洞察的智能匹配
|
||
- 一键加微信好友
|
||
- 加入书友社群
|
||
- 查看核心理念
|
||
|
||
### 3. 📚 内容系统
|
||
- 64章完整商业案例
|
||
- 5大核心篇章
|
||
- 实时内容同步
|
||
- 离线缓存支持
|
||
|
||
### 4. 💰 分销系统
|
||
- 90%佣金比例
|
||
- 推广海报生成
|
||
- 邀请码追踪
|
||
- 收益实时统计
|
||
|
||
---
|
||
|
||
## 🚀 快速开始
|
||
|
||
### 环境要求
|
||
|
||
```bash
|
||
Node.js >= 18.0.0
|
||
npm >= 9.0.0 或 pnpm >= 8.0.0
|
||
微信开发者工具（用于小程序开发）
|
||
```
|
||
|
||
### 安装依赖
|
||
|
||
```bash
|
||
# 克隆项目
|
||
git clone <your-repo-url>
|
||
cd 一场soul的创业实验
|
||
|
||
# 安装依赖
|
||
pnpm install
|
||
# 或
|
||
npm install
|
||
```
|
||
|
||
### 运行H5版本
|
||
|
||
```bash
|
||
# 开发模式
|
||
pnpm dev
|
||
# 或
|
||
npm run dev
|
||
|
||
# 访问 http://localhost:3000
|
||
```
|
||
|
||
### 运行小程序
|
||
|
||
1. 打开微信开发者工具
|
||
2. 导入项目：选择 `miniprogram` 文件夹
|
||
3. 填写 AppID：`wx0976665c3a3d5a7c`
|
||
4. 点击「编译」即可预览
|
||
|
||
---
|
||
|
||
## 📂 项目结构
|
||
|
||
```
|
||
一场soul的创业实验/
|
||
├── app/ # Next.js主应用
|
||
│ ├── page.tsx # 首页
|
||
│ ├── match/ # 匹配页面
|
||
│ ├── my/ # 个人中心
|
||
│ └── api/ # API接口
|
||
│ ├── book/ # 书籍相关API
|
||
│ ├── match/ # 匹配相关API
|
||
│ └── wechat/ # 微信登录API
|
||
│
|
||
├── miniprogram/ # 微信小程序
|
||
│ ├── pages/ # 页面
|
||
│ │ ├── index/ # 首页
|
||
│ │ ├── match/ # 匹配页面
|
||
│ │ ├── my/ # 个人中心
|
||
│ │ └── read/ # 阅读页面
|
||
│ ├── app.json # 小程序配置
|
||
│ ├── app.js # 小程序逻辑
|
||
│ └── app.wxss # 小程序样式
|
||
│
|
||
├── book/ # 书籍内容（64章Markdown）
|
||
│ ├── 序言｜为什么我每天早上6点在Soul开播?.md
|
||
│ ├── 第一篇｜真实的人/
|
||
│ ├── 第二篇｜真实的行业/
|
||
│ ├── 第三篇｜真实的错误/
|
||
│ ├── 第四篇｜真实的赚钱/
|
||
│ ├── 第五篇｜真实的社会/
|
||
│ └── 尾声｜这本书的真实目的.md
|
||
│
|
||
├── components/ # React组件
|
||
├── lib/ # 工具库
|
||
├── scripts/ # 脚本
|
||
│ └── sync-book-content.js # 章节同步脚本
|
||
├── public/ # 静态资源
|
||
│ └── book-chapters.json # 章节数据（自动生成）
|
||
│
|
||
└── 开发文档/ # 项目文档
|
||
├── 🏆完美完成.md # 最终完成报告
|
||
├── 🎯最终优化完成.md # 优化记录
|
||
└── 📖完整升级报告.md # 升级报告
|
||
```
|
||
|
||
---
|
||
|
||
## 🎨 技术栈
|
||
|
||
### 前端
|
||
- **Next.js 16** - React全栈框架
|
||
- **React 19** - UI框架
|
||
- **TypeScript** - 类型安全
|
||
- **Tailwind CSS** - 样式框架
|
||
- **Framer Motion** - 动画库
|
||
|
||
### 小程序
|
||
- **微信小程序** - 原生开发
|
||
- **WeChat API** - 微信能力
|
||
|
||
### 后端
|
||
- **Next.js API Routes** - API接口
|
||
- **Node.js** - 运行环境
|
||
|
||
### 工具
|
||
- **pnpm** - 包管理器
|
||
- **ESLint** - 代码规范
|
||
- **Git** - 版本控制
|
||
|
||
---
|
||
|
||
## 📊 数据说明
|
||
|
||
### 章节结构（64章）
|
||
|
||
```
|
||
序言 (1章)
|
||
第一篇｜真实的人 (10章)
|
||
├─ 第1章｜人与人之间的底层逻辑 (5章)
|
||
└─ 第2章｜人性困境案例 (5章)
|
||
第二篇｜真实的行业 (14章)
|
||
├─ 第3章｜电商篇 (4章)
|
||
├─ 第4章｜内容商业篇 (5章)
|
||
└─ 第5章｜传统行业篇 (5章)
|
||
第三篇｜真实的错误 (9章)
|
||
├─ 第6章｜我人生错过的4件大钱 (4章)
|
||
└─ 第7章｜别人犯的错误 (5章)
|
||
第四篇｜真实的赚钱 (20章)
|
||
├─ 第8章｜底层结构 (6章)
|
||
└─ 第9章｜我在Soul上亲访的赚钱案例 (14章)
|
||
第五篇｜真实的社会 (9章)
|
||
├─ 第10章｜未来职业的变化趋势 (4章)
|
||
└─ 第11章｜中国社会商业生态的未来 (5章)
|
||
尾声 (1章)
|
||
```
|
||
|
||
### 数据同步
|
||
|
||
```bash
|
||
# 扫描book文件夹，生成章节数据
|
||
node scripts/sync-book-content.js
|
||
|
||
# 结果：生成 public/book-chapters.json (64章)
|
||
```
|
||
|
||
---
|
||
|
||
## 🔧 API文档
|
||
|
||
### 章节相关
|
||
|
||
#### 获取所有章节
|
||
```
|
||
GET /api/book/all-chapters
|
||
|
||
Response:
|
||
{
|
||
"success": true,
|
||
"chapters": [...], // 64章数据
|
||
"total": 64
|
||
}
|
||
```
|
||
|
||
#### 同步章节
|
||
```
|
||
POST /api/book/sync
|
||
|
||
Response:
|
||
{
|
||
"success": true,
|
||
"message": "章节同步成功",
|
||
"output": "扫描到 64 个章节"
|
||
}
|
||
```
|
||
|
||
#### 获取同步状态
|
||
```
|
||
GET /api/book/sync
|
||
|
||
Response:
|
||
{
|
||
"success": true,
|
||
"synced": true,
|
||
"totalChapters": 64,
|
||
"lastSyncTime": "2026-01-14T12:30:00.000Z"
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 🎯 核心特性
|
||
|
||
### 1. 智能匹配系统
|
||
- 基于商业洞察的匹配算法
|
||
- 实时在线人数统计
|
||
- 匹配度评分系统
|
||
- 共同兴趣分析
|
||
|
||
### 2. 内容管理系统
|
||
- Markdown格式书写
|
||
- 自动同步机制
|
||
- 离线缓存支持
|
||
- 实时更新通知
|
||
|
||
### 3. 分销系统
|
||
- 90%高佣金比例
|
||
- 多级分销追踪
|
||
- 海报自动生成
|
||
- 收益实时统计
|
||
|
||
### 4. 用户系统
|
||
- 微信登录
|
||
- 阅读记录
|
||
- 购买历史
|
||
- 收藏书签
|
||
|
||
---
|
||
|
||
## 📱 界面展示
|
||
|
||
### 首页
|
||
```
|
||
🎉 Soul · 派对房
|
||
一场SOUL的
|
||
创业实验场（渐变）
|
||
来自Soul派对房的真实商业故事
|
||
"社会不是靠努力，是靠洞察与选择"
|
||
|
||
[ ¥9.9 | 64 商业案例 ]
|
||
[ 作者：卡若 | 06:00-09:00 ]
|
||
[ 📖 立即阅读 ]
|
||
|
||
64+真实案例 | 5核心篇章 | 100+商业洞察
|
||
全部64章目录...
|
||
```
|
||
|
||
### 匹配页面
|
||
```
|
||
寻找合作伙伴
|
||
找到和你一起创业的灵魂
|
||
|
||
🤝 开始匹配
|
||
寻找合作伙伴
|
||
|
||
💼 共同的创业方向
|
||
💬 实时在线交流
|
||
🎯 相似的商业洞察
|
||
```
|
||
|
||
---
|
||
|
||
## 🚀 部署
|
||
|
||
### 小程序部署
|
||
|
||
1. 打开微信开发者工具
|
||
2. 导入 `miniprogram` 文件夹
|
||
3. 点击「上传」
|
||
4. 登录小程序后台提交审核
|
||
|
||
### H5部署
|
||
|
||
```bash
|
||
# 构建生产版本
|
||
pnpm build
|
||
|
||
# 启动生产服务器
|
||
pnpm start
|
||
```
|
||
|
||
---
|
||
|
||
## 📄 许可证
|
||
|
||
MIT License
|
||
|
||
---
|
||
|
||
## 👨💻 作者
|
||
|
||
**卡若**
|
||
- Soul派对房主理人
|
||
- 每日直播：06:00-09:00
|
||
- 分享真实的商业故事和创业洞察
|
||
|
||
---
|
||
|
||
## 🙏 致谢
|
||
|
||
感谢所有支持这个项目的朋友们！
|
||
|
||
特别感谢：
|
||
- Soul平台提供的创作空间
|
||
- 每天早上6点陪伴的书友们
|
||
- 所有购买和分享的读者
|
||
|
||
---
|
||
|
||
## 📞 联系方式
|
||
|
||
- **微信公众号**：Soul派对房
|
||
- **直播时间**：每天 06:00-09:00
|
||
- **平台**：Soul APP
|
||
|
||
---
|
||
|
||
## 🔄 版本历史
|
||
|
||
### v1.3.1 (2026-01-14) - 当前版本
|
||
- ✨ 首页完全对齐H5设计
|
||
- 🎯 匹配功能改为"寻找合作伙伴"
|
||
- 📚 整合64章精准数据
|
||
- 🎨 界面100%统一
|
||
- 🤝 添加一键加微信/加群功能
|
||
- 📊 所有数据来源于真实book文件夹
|
||
|
||
### v1.3.0 (2026-01-14)
|
||
- 🎯 简化匹配功能
|
||
- 📝 书名改为"一场SOUL的创业实验场"
|
||
- 🤝 添加核心理念展示
|
||
|
||
### v1.2.0 (2026-01-14)
|
||
- 📚 整合64个章节
|
||
- 🔄 实现实时同步
|
||
- 🎨 统一H5和小程序界面
|
||
|
||
---
|
||
|
||
**⭐ 如果这个项目对你有帮助，请给一个星标！**
|
||
|
||
**🚀 欢迎贡献代码和提出建议！**
|