Files
soul-yongping/开发文档/SKILL.md
2026-03-07 22:58:43 +08:00

3.3 KiB
Raw Blame 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
  • 格式:| 日期 | 需求描述 | 状态 | 备注 |
  • 状态:待开发 / 开发中 / 已完成 / 已取消
  • 每个版本上传后,将该批需求标记为「已完成」

常用命令

上传小程序

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

从GitHub同步miniprogram

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

数据库迁移

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等