# Soul创业派对 - 项目开发SKILL

## 项目概述

| 项目 | 值 |
|------|-----|
| 项目名 | Soul创业派对（一场Soul的创业实验） |
| 小程序AppID | wxb8bbb2b10dec74aa |
| 后端地址 | https://soul.quwanzhi.com |
| 技术栈(前端) | 微信小程序原生 + 自定义TabBar |
| 技术栈(后端) | Next.js App Router + MySQL |
| 数据库 | 腾讯云MySQL |
| 仓库 | github.com/fnvtk/Mycontent (yongpxu-soul分支) |

## 开发文档目录索引

```
开发文档/
├── 1、需求/        ← 需求文档、需求日志、TDD方案
├── 2、架构/        ← 系统架构、技术选型、链路说明
├── 3、原型/        ← 原型设计
├── 4、前端/        ← 前端架构、UI截图
├── 5、接口/        ← API接口文档、接口定义规范
├── 6、后端/        ← 后端架构、修复说明
├── 7、数据库/      ← 数据库设计、管理规范
├── 8、部署/        ← 部署流程、宝塔配置、小程序上传
├── 9、手册/        ← 使用手册、写作手册
├── 10、项目管理/   ← 项目总览、运营报表、会议记录
├── 小程序管理/     ← 小程序生命周期SKILL（独立）
└── 服务器管理/     ← 服务器运维SKILL（独立）
```

## 需求日志管理规范

- 每次对话的需求自动追加到 `1、需求/需求日志.md`
- 格式：`| 日期 | 需求描述 | 状态 | 备注 |`
- 状态：待开发 / 开发中 / 已完成 / 已取消
- 每个版本上传后，将该批需求标记为「已完成」

## 常用命令

### 上传小程序
```bash
/Applications/wechatwebdevtools.app/Contents/MacOS/cli upload \
  --project "/Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验/miniprogram" \
  --version "版本号" --desc "版本说明"
```

### 从GitHub同步miniprogram
```bash
cd /tmp && rm -rf Mycontent_soul_tmp
git clone --depth 1 --branch yongpxu-soul https://github.com/fnvtk/Mycontent.git Mycontent_soul_tmp
rsync -av --delete Mycontent_soul_tmp/miniprogram/ "/Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验/miniprogram/"
rm -rf Mycontent_soul_tmp
```

### 数据库迁移
```bash
curl -X POST https://soul.quwanzhi.com/api/db/migrate -H 'Content-Type: application/json' -d '{}'
```

## 核心页面结构

| 页面 | 路径 | 说明 |
|------|------|------|
| 首页 | pages/index/index | 精选推荐(阅读量)、创业老板排行 |
| 目录 | pages/chapters/chapters | 章节列表 |
| 找伙伴 | pages/match/match | 匹配动画 |
| 我的 | pages/my/my | 用户信息、收益、VIP、账号设置 |
| 阅读 | pages/read/read | 章节内容、付费墙 |
| VIP | pages/vip/vip | VIP权益、购买、资料填写 |
| 会员详情 | pages/member-detail/member-detail | 创业老板排行点击详情 |

## 后端API模块

| 模块 | 路径前缀 | 说明 |
|------|---------|------|
| VIP会员 | /api/vip/ | purchase、status、profile、members |
| 书籍 | /api/book/ | chapters、hot、latest-chapters、search |
| 用户 | /api/user/ | profile、update、track |
| 支付 | /api/miniprogram/pay | 微信小程序支付 |
| 推广 | /api/referral/ | bind、data、visit |
| 提现 | /api/withdraw | 提现到微信零钱 |
| 管理后台 | /api/admin/ | content、chapters、payment等 |