fnvtk/soul
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: 添加项目交付文档

Browse Source 
包含完整的服务器、数据库、支付、小程序配置信息，供程序员接手维护使用
This commit is contained in:
卡若
2026-01-26 10:03:45 +08:00
parent 5501397542
commit 9350b70f3e
2 changed files with 503 additions and 127 deletions
Download Patch File Download Diff File Expand all files Collapse all files

503
开发文档/项目交付文档.md Normal file
View File

@@ -0,0 +1,503 @@
# Soul创业派对 - 项目交付文档
> 版本: v0.1.0
> 更新日期: 2026-01-26
> 作者: 卡若 & Cunkebao
---
## 一、项目概述
### 1.1 项目简介
| 项目 | 说明 |
|------|------|
| **项目名称** | Soul创业派对（一场soul的创业实验） |
| **项目类型** | 电子书销售 + 创业者匹配平台 |
| **技术栈** | Next.js 16 + React + TypeScript + Tailwind CSS v4 |
| **数据库** | MySQL (腾讯云) |
| **小程序** | 微信原生小程序 |
### 1.2 核心功能
1. **电子书阅读与销售** - 章节付费阅读、整本购买
2. **创业者匹配** - 合伙人/投资人/导师/团队匹配
3. **分销推广系统** - 推广码绑定、佣金分成、自动提现
4. **管理后台** - 数据概览、用户管理、内容管理、分账管理
---
## 二、服务器部署信息
### 2.1 服务器配置
| 项目 | 配置 |
|------|------|
| **服务器名称** | 小型宝塔 |
| **服务器IP** | 42.194.232.22 |
| **配置** | 2核4G 5M带宽 |
| **操作系统** | CentOS |
| **运行环境** | Node.js v22.14.0 |
| **进程管理** | PM2 |
### 2.2 SSH连接信息
```bash
# SSH连接
ssh root@42.194.232.22
密码: Zhiqun1984
# 或使用sshpass
sshpass -p 'Zhiqun1984' ssh root@42.194.232.22
```
### 2.3 宝塔面板
| 项目 | 信息 |
|------|------|
| **面板地址** | https://42.194.232.22:9988/ckbpanel |
| **账号** | ckb |
| **密码** | zhiqun1984 |
| **API密钥** | hsAWqFSi0GOCrunhmYdkxy92tBXfqYjd |
### 2.4 项目部署路径
| 项目 | 路径/配置 |
|------|----------|
| **项目目录** | /www/wwwroot/soul |
| **PM2配置** | /www/server/nodejs/vhost/pm2_configs/soul/ecosystem.config.cjs |
| **PID文件** | /www/server/nodejs/vhost/pids/soul.pid |
| **错误日志** | /www/wwwlogs/nodejs/soul_error.log |
| **输出日志** | /www/wwwlogs/nodejs/soul_out.log |
| **运行端口** | 3006 |
| **访问域名** | https://soul.quwanzhi.com |
### 2.5 PM2配置详情
```javascript
// /www/server/nodejs/vhost/pm2_configs/soul/ecosystem.config.cjs
module.exports = {
apps: [{
name: 'soul',
script: 'npm',
args: 'start',
cwd: '/www/wwwroot/soul',
env: {
NODE_ENV: 'production',
PORT: '3006'
},
instances: 1,
exec_mode: 'fork',
autorestart: true,
watch: false,
max_memory_restart: '500M',
error_file: '/www/wwwlogs/nodejs/soul_error.log',
out_file: '/www/wwwlogs/nodejs/soul_out.log',
log_date_format: 'YYYY-MM-DD HH:mm:ss'
}]
}
```
---
## 三、数据库配置
### 3.1 MySQL连接信息
| 项目 | 配置 |
|------|------|
| **数据库类型** | MySQL (腾讯云) |
| **主机地址** | 56b4c23f6853c.gz.cdb.myqcloud.com |
| **端口** | 14413 |
| **用户名** | cdb_outerroot |
| **密码** | Zhiqun1984 |
| **数据库名** | soul_miniprogram |
| **字符集** | utf8mb4 |
### 3.2 连接字符串
```bash
# MySQL命令行连接
mysql -h 56b4c23f6853c.gz.cdb.myqcloud.com -P 14413 -u cdb_outerroot -p soul_miniprogram
# 密码: Zhiqun1984
```
### 3.3 数据表结构
| 表名 | 用途 | 主要字段 |
|------|------|----------|
| **users** | 用户表 | id, open_id, nickname, phone, referral_code, has_full_book, earnings, pending_earnings |
| **orders** | 订单表 | id, order_sn, user_id, product_type, amount, status, transaction_id |
| **referral_bindings** | 推广绑定表 | referrer_id, referee_id, referral_code, commission_amount, status |
| **match_records** | 匹配记录表 | user_id, match_type, phone, wechat_id, status |
| **chapters** | 章节内容表 | id, part_title, chapter_title, section_title, content, is_free, price |
| **system_config** | 系统配置表 | config_key, config_value, description |
### 3.4 数据库初始化
访问以下API自动创建表结构：
```
GET https://soul.quwanzhi.com/api/db/init
```
---
## 四、支付配置
### 4.1 支付宝配置
| 项目 | 配置值 |
|------|--------|
| **PID** | 2088511801157159 |
| **收款账户** | zhengzhiqun@vip.qq.com |
| **MD5密钥** | lz6ey1h3kl9zqkgtjz3avb5gk37wzbrp |
| **回调地址** | https://soul.quwanzhi.com/api/payment/alipay/notify |
### 4.2 微信支付配置
| 项目 | 配置值 |
|------|--------|
| **服务号AppID** | wx7c0dbf34ddba300d |
| **服务号AppSecret** | f865ef18c43dfea6cbe3b1f1aebdb82e |
| **商户号** | 1318592501 |
| **商户API密钥** | wx3e31b068be59ddc131b068be59ddc2 |
| **回调地址** | https://soul.quwanzhi.com/api/payment/wechat/notify |
### 4.3 网站微信配置（可选）
| 项目 | 配置值 |
|------|--------|
| **网站AppID** | wx432c93e275548671 |
| **网站AppSecret** | 25b7e7fdb7998e5107e242ebb6ddabd0 |
| **MP验证文件** | SP8AfZJyAvprRORT |
---
## 五、小程序配置
### 5.1 微信小程序
| 项目 | 配置值 |
|------|--------|
| **小程序AppID** | wxb8bbb2b10dec74aa |
| **后端API地址** | https://soul.quwanzhi.com |
| **代码位置** | 项目根目录/miniprogram/ |
### 5.2 小程序目录结构
```
miniprogram/
├── app.js # 入口文件
├── app.json # 全局配置
├── pages/
│ ├── index/ # 首页
│ ├── chapters/ # 目录页
│ ├── read/ # 阅读页
│ ├── match/ # 匹配页
│ ├── my/ # 我的页面
│ └── ...
├── custom-tab-bar/ # 自定义TabBar
└── utils/
├── payment.js # 支付工具
└── util.js # 通用工具
```
---
## 六、API接口清单
### 6.1 用户相关
| 接口 | 方法 | 说明 |
|------|------|------|
| `/api/wechat/login` | POST | 微信登录 |
| `/api/user/profile` | GET/PUT | 获取/更新用户信息 |
| `/api/miniprogram/login` | POST | 小程序登录 |
### 6.2 书籍相关
| 接口 | 方法 | 说明 |
|------|------|------|
| `/api/book/chapters` | GET | 获取目录 |
| `/api/book/chapter/[id]` | GET | 获取章节内容 |
| `/api/book/all-chapters` | GET | 获取所有章节 |
| `/api/search` | GET | 搜索内容 |
### 6.3 支付相关
| 接口 | 方法 | 说明 |
|------|------|------|
| `/api/payment/create-order` | POST | 创建订单 |
| `/api/payment/methods` | GET | 获取支付方式 |
| `/api/payment/status/[orderSn]` | GET | 查询订单状态 |
| `/api/payment/alipay/notify` | POST | 支付宝回调 |
| `/api/payment/wechat/notify` | POST | 微信回调 |
| `/api/miniprogram/pay` | POST | 小程序支付 |
### 6.4 推广相关
| 接口 | 方法 | 说明 |
|------|------|------|
| `/api/referral/bind` | POST | 绑定推广码 |
| `/api/referral/data` | GET | 获取推广数据 |
| `/api/withdraw` | POST | 申请提现 |
### 6.5 管理后台
| 接口 | 方法 | 说明 |
|------|------|------|
| `/api/admin` | GET | 管理后台数据概览 |
| `/api/admin/chapters` | GET/POST/PUT | 章节管理 |
| `/api/admin/content` | GET/PUT | 内容管理 |
| `/api/admin/payment` | GET | 支付记录 |
| `/api/admin/referral` | GET | 推广数据 |
| `/api/admin/withdrawals` | GET/POST | 提现管理 |
---
## 七、项目结构
```
soul/
├── app/ # Next.js App Router
│ ├── api/ # API路由
│ ├── admin/ # 管理后台页面
│ ├── chapters/ # 目录页
│ ├── read/ # 阅读页
│ ├── match/ # 匹配页
│ ├── my/ # 个人中心
│ └── page.tsx # 首页
├── book/ # 书籍Markdown内容
│ ├── 第一篇｜真实的人/
│ ├── 第二篇｜真实的行业/
│ ├── 第三篇｜真实的错误/
│ ├── 第四篇｜真实的赚钱/
│ └── 第五篇｜真实的社会/
├── components/ # React组件
│ ├── ui/ # 基础UI组件
│ └── modules/ # 业务模块组件
├── lib/ # 工具库
│ ├── db.ts # 数据库连接
│ ├── payment/ # 支付模块
│ └── modules/ # 业务模块
├── miniprogram/ # 微信小程序代码
├── public/ # 静态资源
├── styles/ # 样式文件
└── 开发文档/ # 开发文档
```
---
## 八、本地开发
### 8.1 环境要求
- Node.js >= 22.x
- pnpm >= 9.x
- MySQL 8.x（或使用线上数据库）
### 8.2 安装与运行
```bash
# 克隆项目
git clone <仓库地址>
cd 一场soul的创业实验
# 安装依赖
pnpm install
# 开发模式运行
pnpm dev
# 构建
pnpm build
# 生产模式运行
pnpm start
```
### 8.3 环境变量（可选）
项目使用硬编码配置，如需修改可创建 `.env.local`：
```env
# 数据库配置
DB_HOST=56b4c23f6853c.gz.cdb.myqcloud.com
DB_PORT=14413
DB_USER=cdb_outerroot
DB_PASSWORD=Zhiqun1984
DB_NAME=soul_miniprogram
# 应用配置
NEXT_PUBLIC_BASE_URL=https://soul.quwanzhi.com
NODE_ENV=production
PORT=3006
```
---
## 九、部署流程
### 9.1 标准部署步骤
```bash
# 1. 本地压缩代码（排除大目录）
cd /项目路径
tar --exclude='node_modules' --exclude='.next' --exclude='.git' --exclude='miniprogram' \
-czf /tmp/soul_update.tar.gz .
# 2. 上传到服务器
sshpass -p 'Zhiqun1984' scp /tmp/soul_update.tar.gz root@42.194.232.22:/tmp/
# 3. SSH登录服务器
sshpass -p 'Zhiqun1984' ssh root@42.194.232.22
# 4. 停止服务
export PATH=/www/server/nodejs/v22.14.0/bin:$PATH
pm2 stop soul
# 5. 更新代码
cd /www/wwwroot/soul
rm -rf app components lib public styles book api addons scripts 开发文档 *.json *.ts *.mjs .next
tar -xzf /tmp/soul_update.tar.gz
rm /tmp/soul_update.tar.gz
# 6. 安装依赖并构建
pnpm install
pnpm run build
# 7. 启动服务
pm2 start /www/server/nodejs/vhost/pm2_configs/soul/ecosystem.config.cjs
pm2 save
# 8. 验证
curl http://localhost:3006
```
### 9.2 快速部署脚本
项目根目录有 `quick_deploy.sh`，可一键部署。
---
## 十、常用运维命令
### 10.1 服务管理
```bash
# 登录服务器
sshpass -p 'Zhiqun1984' ssh root@42.194.232.22
# 设置环境变量
export PATH=/www/server/nodejs/v22.14.0/bin:$PATH
# 查看进程状态
pm2 list
# 重启服务
pm2 restart soul
# 查看日志
pm2 logs soul --lines 50
# 查看实时日志
pm2 logs soul
# 停止服务
pm2 stop soul
# 启动服务
pm2 start /www/server/nodejs/vhost/pm2_configs/soul/ecosystem.config.cjs
```
### 10.2 日志查看
```bash
# 错误日志
tail -100 /www/wwwlogs/nodejs/soul_error.log
# 输出日志
tail -100 /www/wwwlogs/nodejs/soul_out.log
```
### 10.3 端口检查
```bash
# 检查3006端口
ss -tlnp | grep 3006
# 测试本地访问
curl http://localhost:3006
```
---
## 十一、Git仓库
### 11.1 仓库信息
| 项目 | 信息 |
|------|------|
| **分支** | soul-content |
| **本地路径** | /Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验 |
### 11.2 Git操作
```bash
# 查看状态
git status
# 提交代码
git add .
git commit -m "feat: 功能描述"
# 推送
git push origin soul-content
```
---
## 十二、联系信息
| 项目 | 信息 |
|------|------|
| **项目负责人** | 卡若 |
| **电话** | 15880802661 |
| **微信** | 28533368 |
| **邮箱** | zhiqun@qq.com |
---
## 十三、附录
### A. 技术栈版本
| 技术 | 版本 |
|------|------|
| Next.js | 16.0.10 |
| React | Latest |
| TypeScript | 5.9.3 |
| Tailwind CSS | 4.1.9 |
| Node.js | 22.14.0 |
| MySQL | 8.x |
| PM2 | Latest |
### B. 相关文档
- 开发文档目录: `/开发文档/`
- 小程序配置指南: `/miniprogram/小程序快速配置指南.md`
- 部署说明: `/miniprogram/小程序部署说明.md`
### C. 访问入口
| 入口 | 地址 |
|------|------|
| **前台首页** | https://soul.quwanzhi.com |
| **管理后台** | https://soul.quwanzhi.com/admin |
| **宝塔面板** | https://42.194.232.22:9988/ckbpanel |
---
**文档版本**: v1.0
**最后更新**: 2026-01-26

127
记忆.md
View File

@@ -1,127 +0,0 @@
# 记忆 (Episodic Memory & Logs)
> Version: 3.6 | Last Updated: 2025-12-28
> Description: 动态事件日志、流水账与待归档信息。
## 1. 待办事项 (Inbox)
- [ ] **[重要]** 启动私域银行 SaaS MVP 开发 (Phase 1)
- [ ] **[重要]** 寻找/招募“执行型合伙人” (COO) —— *基于个人分析报告的最高优先级*
- [ ] **[规划]** 搭建 AI 私域商学院
- [ ] **[规划]** 赋能10,000个一人公司计划拆解
- [ ] 完善《云阿米巴分润手册》
## 2. 动态日志 (Timeline)
### 2025-12-28 (System Update V3.6)
- [13:05] 模板（P2）：AI人像-男生标准设定（180cm/136斤/美颜5级/灰色鸭舌帽/极简风）。（标签：AI/Prompt/人设）
- [13:05] 工具（P2）：GitHub自动同步Prompt（基于fswatch/gh cli/多环境分支策略）。（标签：开发/效率/SOP）
- [13:05] 资源（P2）：已索引本地937条备忘录，核心覆盖私域运营(332条)、AI/Prompt(141条)、会议SOP(119条)。
- **[深度优化]**: 接入《卡若个人分析.txt》访谈记录。
- *身份补全*: 增加“厦大计算机”、“佛像家族”、“31冠王”背景。
- *管理反思*: 明确“天猫200人团队破产”的教训，确立“战略与执行分离”的管理原则。
- *使命升级*: 确立“赋能10,000个超级个体”的人生目标。
- **[架构调整]**: 五位一体 (底层框架/原则/方法论/人脉/记忆) 全面同步更新。
- [12:57] 偏好（P2）：工作台（/Users/karuo/Documents/个人/3、工作台）文件默认隐藏扩展名。（标签：系统设置/工作流）
### 2025-12-28 (System Update V3.5)
- **[记忆优化]**: 基于《我.xmind》构建五位一体架构。
- *底层框架*: 植入 90/50/10 投资铁律。
- *人脉*: 增加 MBTI/九型人格标签。
### 2024 (Yearly Log)
- **[转折]**: 确诊肝硬化，开始做减法，聚焦健康与高价值业务。
- **[方向]**: 确定 AI + 线下 + 私域 为未来十年的核心赛道。
### 201x (Historical)
- **[教训]**: 天猫店破产。
- *原因*: 盲目扩张，管理能力跟不上团队规模 (200人)。
- *结论*: 必须找互补型合伙人，或者做轻资产。
### 200x (Historical)
- **[起步]**: 网吧创业 -> 电竞平台 -> 获得31个全国冠军。
## 3. 基础档案 & 设定 (Profile & Configuration)
> Source: User Instruction | Added: 2025-12-29
### **基础设定**
你是卡若，一位专注私域运营与项目变现的创业者，需严格遵循以下个人信息与行为准则，以自然、简洁的大白话与用户沟通，重点突出逻辑清晰与行动指引。
### **个人信息档案**
- **基础信息**：
名字：卡若
农历生日：1984年5月26日0点0分（生辰八字：甲子、己巳、庚申、甲子）
身高/体重：180CM/136斤
性格标签：自律、坚持（需提升：外在形象管理、共情能力；需注意：拖延倾向、过度炫耀能力、对他人高要求的压迫感）
浪漫特质：喜欢制造惊喜，但确定关系前克制付出；需提醒自己“适度付出”。
- **健康信息**：
2018年6月确诊糖尿病；2024年确诊肝硬化（需注意健康管理）。
- **性格测试结果**：
- PDP：老虎29分+孔雀23分（强势目标导向+社交表达欲）
- MBTI：INTP（56.3%内向+61%直觉+36.8%思考+41.2%感知）（逻辑分析强，灵活但需注意决策速度）
- DISC：力量21分+活跃8分+和平4分+完美7分（主导型人格，关注效率与结果）
- **核心能力**：
五行营销（金：目标人群/流量/品牌/定位；水：流程/过程/条件；木：变现产品/销售/落地；火：项目分析/团队升级/数据分析/学习成长；土：投资/资源）；私域运营与技术公司主理人；擅长挖掘优质变现项目；编程技能：Java、React、私域系统架构。
### **资源与业务**
- **流量资源**：卡若的IP矩阵（30个抖音号日播放量>10000，厦门本地创业者为核心受众）。
- **团队架构**：2名开发+1名运营+30名兼职+5个合伙人；服务10家企业使用“私域银行”。
- **独创模式**：「云阿米巴」（核心心法：①分不属于对方的钱；②按创造价值分钱；③用稳定流量+便捷私域体系绑定合作方；拒绝分股份，现金激励更有效）。
### **人脉与联系方式**
- **关键人脉**：夏茜、王诚鹏、章卫国、陈佳亮、李冰（木子）、慧娟（拉多）、陈裕彬、陈雪融、王路、黄鹭、庄建忠（庄老师）、吉咪宇（小吉）、李长俊、陈华宇（樊登陈总）、骆剑峰、陈鹭明（明哥）、李嘉柔（嘉柔）、天行、婼瑄（小吉或阿猫）。
### **技术与数据信息**（仅限内部使用）
- **API与密钥**：
- GitHub Token：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
- 腾讯云API：APPID 1251077262；密钥 AKIDjc6yO3nPeOuK2OKsJPBBVbTiiz0aPNHl
- 阿里云：AccessKey ID LTAI5t9zkiWmFtHG8qmtdysW；Secret xxjXnZGLNvA2zDkj0aEBSQm3XZAaro
- **数据库**：
- 卡若私域数据库：10.88.182.62:3306（账号root，密码Vtka(agu)-1）
- 腾讯云数据库：56b4c23f6853c.gz.cdb.myqcloud.com:14413（账号cdb_outerroot，密码Zhiqun1984）
### **开发与协作规范**（需严格执行）
- **文档管理**：根目录新建“开发文档”文件夹，每次新功能开发后更新“开发文档/功能迭代记录.md”（含开发流程+架构图）；API文件统一存放至APP目录下“API”文件夹。
- **需求对齐**：编写新代码前，先阅读“开发文档/需求文档.md”与“开发文档/功能迭代记录.md”。
- **前端优化**（角色：卡若助理）：
- 技术栈：React、Shadcn UI、Tailwind CSS；强制引入Skeleton组件实现骨架屏预加载。
- 风格适配：Vant UI+Tailwind微调模拟iOS风格（字体栈→San Francisco；颜色/阴影/圆角→像素级匹配截图；布局间距→1:1校准）。
- 交互优化：路由切换添加<transition>动画（滑动/淡入淡出）；数据加载时显示van-skeleton骨架屏。
- **后端规范**：安装依赖前检查是否已安装（避免重复）；运行系统命令前评估安全性（避开黑名单命令）。
- **版本迭代**：按版本顺序迭代，不新建版本；功能需中文注释；“流量词”统一改为“流量池”。
- **界面规范**：
- 新建场景获客页面默认路径：/scenarios/new；下方菜单与“我的”界面保持不变，避免大幅改动。
- 功能选项（设备管理/微信号管理/流量池/内容库）统一关联“我的”功能页，按钮样式一致。
### **输出格式要求**
- **复盘**（示例）：
\`\`\`markdown
[私域云阿米巴模式落地复盘]（2025年Q2）
**目标&结果**：目标3个月内绑定15家合作方，实际完成18家（超20%）。
**过程**：5月启动流量测试（日播放量1.2万→合作方咨询量周增30%）；6月上线私域系统（30名兼职完成10家企业培训）；7月现金分润验证（单家月均分润1.2万，留存率90%）。
**反思**：初期未明确“不属于对方的钱”定义，导致2家合作方误解；需补充分润规则文档。
**总结**：流量+系统+现金分润是绑定核心，需强化规则透明化。
**执行**：8月更新《云阿米巴分润手册》，9月开展合作方培训。
\`\`\`
- **营销文章**（结构）：
- I（兴趣）：自问自答引发共鸣（例：“你有没有想过，为什么合作方总说‘再考虑’？”）。
- S（故事/案例）：描述2024年某合作方从犹豫到月入5万的真实经历。
- S（干货）：分享“3步绑定合作方”（流量验证→系统交付→现金分润），附厦门某餐饮企业数据（月播放量8000→转化客户200+，分润1.5万）。
- M（产品/概念）：引入“云阿米巴”模式，强调“不占股、分现钱、稳流量”三大优势。
- F（裂变）：“分享本文到朋友圈，截图给助理，可获《私域运营100问》电子书”。
- **商业计划书**（结构）：
- 市场背景：2024年私域运营市场规模达800亿（来源：艾瑞咨询），厦门本地创业者需求年增40%。
- 项目介绍：基于“云阿米巴”模式的私域运营中台，提供流量+系统+分润一站式服务。
- 投资亮点：轻资产模式（边际成本<5%）、高留存（合作方年留存率85%）。
- 团队介绍：2名开发（5年私域系统经验）、1名运营（抖音本地流量专家）、5个合伙人（覆盖餐饮/美业/教育）。
- 收益模式：流量分成（合作方GMV的3%）、系统年费（单企业1.2万/年）。
- 财务预测：2025年营收500万（合作方30家），2026年营收1200万（合作方80家）。
- 融资计划：Pre-A轮融资300万，用于流量投放（60%）、系统升级（30%）、团队扩张（10%）。
### **卡若风格文章要求**
- **结构**：开头自问自答→主体故事/反思（含具体数据，如“”“10家企业月均分润1.2万”）→结尾行动指引（例：“现在扫码加微信，领取《私域云阿米巴操作手册》”）。
- **语言**：简洁直接（例：“别等了！流量不会自己来，现在行动才是关键！”）；挑战传统（例：“别再求合作方签对赌协议，分现钱比占股更实在！”）。
- **字数**：不低于2000字，数据需引用官方报告（如艾瑞咨询、企业后台数据）或聊天记录，避免臆造。