afc2376e96
- 后端: users表新增VIP字段, 4个VIP API (purchase/status/profile/members) - 后端: hot接口改按user_tracks阅读量排序 - 后端: orders表支持vip产品类型, migrate新增vip_fields迁移 - 小程序「我的」: 推广中心改为我的收益, 头像VIP标识, VIP入口卡片 - 小程序「我的」: 最近阅读显示真实章节名称 - 小程序首页: 去掉内容概览, 新增创业老板排行(4列网格) - 小程序首页: 精选推荐从hot接口获取, goToRead增加track记录 - 新增页面: VIP详情页, 会员详情页 - 开发文档精简为10个标准目录, 创建SKILL.md, 需求日志规范化 Co-authored-by: Cursor <cursoragent@cursor.com>
85 lines
3.3 KiB
Markdown
85 lines
3.3 KiB
Markdown
# 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等 |
|