Files
soul/开发文档/SKILL.md

85 lines
3.3 KiB
Markdown
Raw Permalink Normal View History

# 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等 |