# Soul创业实验 - 项目生成AI提示词

> **用途**: 将此提示词提供给AI，可直接生成完整项目代码
> **支持**: Claude, GPT-4, Cursor等

**我是卡若。**

---

## 🤖 完整提示词

```
你是一位资深全栈工程师，请根据以下需求生成一个完整的 Next.js 项目。

# 项目信息
项目名称: Soul创业实验
技术栈: Next.js 16 + React 19 + TypeScript 5.9 + Tailwind CSS 4.1 + Zustand 5.0

# 核心功能模块
1. 内容展示系统: 64章商业案例，5大篇章
2. 支付系统: 微信支付/支付宝/USDT，动态价格¥9.9
3. 分销系统: 90%高佣金，推广海报生成，邀请码机制
4. 匹配系统: 基于MBTI和兴趣的创业合作伙伴匹配
5. 用户系统: 登录注册，购买记录，收益管理
6. 后台管理: 内容管理/订单管理/用户管理/分销管理
7. 微信小程序: 完整小程序版本(WXML/WXSS/JS)

# 数据存储方案
- 当前: 文件系统(book/目录) + LocalStorage
- 未来: MongoDB (预留升级空间)

# 详细技术规范

## 1. 项目结构
请严格按照以下目录结构生成:

```
/
├── app/                       # Next.js App Router
│   ├── layout.tsx            # 根布局
│   ├── page.tsx              # 首页
│   ├── globals.css           # 全局样式
│   ├── match/                # 匹配页面
│   │   └── page.tsx
│   ├── my/                   # 我的页面
│   │   ├── page.tsx
│   │   ├── referral/         # 分销中心
│   │   └── earnings/         # 收益管理
│   ├── read/                 # 阅读页面
│   │   └── [id]/
│   │       └── page.tsx
│   ├── chapters/             # 章节列表
│   │   └── page.tsx
│   ├── admin/                # 后台管理
│   │   ├── page.tsx
│   │   ├── content/          # 内容管理
│   │   ├── payment/          # 订单管理
│   │   ├── users/            # 用户管理
│   │   └── settings/         # 系统设置
│   └── api/                  # API Routes
│       ├── book/
│       │   ├── all-chapters/route.ts
│       │   ├── chapter/[id]/route.ts
│       │   └── sync/route.ts
│       ├── payment/
│       │   ├── create-order/route.ts
│       │   ├── alipay/notify/route.ts
│       │   └── wechat/notify/route.ts
│       ├── referral/
│       │   ├── code/route.ts
│       │   ├── bind/route.ts
│       │   ├── earnings/route.ts
│       │   └── withdraw/route.ts
│       ├── match/
│       │   ├── find/route.ts
│       │   └── history/route.ts
│       ├── admin/
│       │   ├── route.ts
│       │   ├── content/route.ts
│       │   ├── payment/route.ts
│       │   └── referral/route.ts
│       └── config/route.ts
├── components/               # React组件
│   ├── ui/                  # 基础UI组件
│   │   ├── button.tsx
│   │   ├── modal.tsx
│   │   ├── input.tsx
│   │   └── ...
│   ├── book-list.tsx        # 章节列表
│   ├── payment-modal.tsx    # 支付弹窗
│   ├── referral-card.tsx    # 分销卡片
│   ├── match-card.tsx       # 匹配卡片
│   ├── admin-sidebar.tsx    # 后台侧边栏
│   └── ...
├── lib/                     # 工具库
│   ├── types.ts            # TypeScript类型定义
│   ├── store.ts            # Zustand状态管理
│   ├── book-data.ts        # 书籍数据(64章)
│   ├── utils.ts            # 工具函数
│   └── modules/            # 业务模块
│       ├── payment/
│       ├── referral/
│       └── marketing/
├── public/                  # 静态资源
│   ├── images/
│   └── book-chapters.json
├── miniprogram/            # 微信小程序
│   ├── pages/
│   │   ├── index/
│   │   ├── match/
│   │   ├── my/
│   │   └── read/
│   ├── utils/
│   │   └── payment.js
│   ├── app.js
│   ├── app.json
│   └── app.wxss
├── package.json
├── tsconfig.json
├── next.config.mjs
├── tailwind.config.js
└── .env.local
```

## 2. TypeScript类型定义 (lib/types.ts)

```typescript
// 用户类型
export interface User {
  id: string                    // 用户ID
  phone: string                 // 手机号(仅后4位)
  nickname: string              // 昵称
  isAdmin: boolean              // 是否管理员
  purchasedSections: string[]   // 已购章节ID
  hasFullBook: boolean          // 是否购买全书
  referralCode: string          // 推荐码
  referredBy?: string           // 推荐人
  earnings: number              // 总收益
  pendingEarnings: number       // 待提现
  withdrawnEarnings: number     // 已提现
  referralCount: number         // 推荐人数
  createdAt: string             // 创建时间
}

// 书籍章节
export interface Section {
  id: string
  title: string
  price: number
  isFree: boolean
  filePath: string
  content?: string
  unlockAfterDays?: number
}

export interface Chapter {
  id: string
  title: string
  sections: Section[]
}

export interface Part {
  id: string
  number: string
  title: string
  subtitle: string
  chapters: Chapter[]
}

// 订单
export interface Purchase {
  id: string
  userId: string
  type: 'section' | 'fullbook'
  sectionId?: string
  amount: number
  paymentMethod?: 'wechat' | 'alipay' | 'usdt'
  referralCode?: string
  referrerEarnings?: number
  status: 'pending' | 'completed' | 'refunded'
  createdAt: string
}

// 提现
export interface Withdrawal {
  id: string
  userId: string
  amount: number
  method: 'wechat' | 'alipay'
  account: string
  name: string
  status: 'pending' | 'completed' | 'rejected'
  createdAt: string
  completedAt?: string
}

// 配置
export interface Settings {
  distributorShare: number      // 90
  authorShare: number            // 10
  sectionPrice: number           // 1
  baseBookPrice: number          // 9.9
  paymentMethods: {
    wechat: {
      enabled: boolean
      qrCode: string
      merchantId: string
      apiKey: string
      groupQrCode: string
    }
    alipay: {
      enabled: boolean
      qrCode: string
      partnerId: string
      securityKey: string
    }
    usdt: {
      enabled: boolean
      network: 'TRC20' | 'ERC20'
      address: string
      exchangeRate: number
    }
  }
  authorInfo: {
    name: string
    description: string
    liveTime: string
    platform: string
  }
}
```

## 3. 核心数据 (lib/book-data.ts)

生成包含64章的完整书籍数据结构:
- 第一篇: 真实的人 (10章)
- 第二篇: 真实的行业 (14章)
- 第三篇: 真实的错误 (9章)
- 第四篇: 真实的赚钱 (20章)
- 第五篇: 真实的社会 (9章)
- 序言和尾声

每章包含:
- id: 章节ID (如 "1.1", "1.2")
- title: 章节标题
- price: 价格(统一¥1)
- isFree: 是否免费(仅1.1免费)
- filePath: 文件路径
- unlockAfterDays: 解锁天数(部分章节)

## 4. 状态管理 (lib/store.ts)

使用 Zustand + persist 实现:
- 用户登录/注册/登出
- 购买章节/全书
- 分销邀请码生成
- 收益计算(90%佣金)
- 提现申请
- 管理员操作
- LocalStorage持久化

## 5. 核心页面实现

### 首页 (app/page.tsx)
- Soul标签
- 书籍3D封面
- 核心数据(¥9.9/64案例/100+洞察)
- 作者信息(卡若/06:00-09:00/Soul派对房)
- 立即购买按钮
- 64章完整目录

### 匹配页面 (app/match/page.tsx)
- 星空背景动画(Canvas)
- 中央渐变星球
- "寻找创业合作伙伴"标题
- 开始匹配按钮
- 匹配算法(MBTI + 兴趣)
- 一键加微信/加群

### 我的页面 (app/my/page.tsx)
- 用户信息卡片
- 阅读统计
- 分销中心(重点突出)
  - 累计收益
  - 推荐人数
  - 邀请码
  - 生成推广海报
- 功能菜单

### 阅读页面 (app/read/[id]/page.tsx)
- Markdown内容渲染
- 章节导航
- 付费章节解锁提示
- 分享功能

## 6. API接口实现

### 书籍API
- GET /api/book/all-chapters - 获取所有章节
- GET /api/book/chapter/:id - 获取单章内容
- POST /api/book/sync - 同步book目录

### 支付API
- POST /api/payment/create-order - 创建订单
- POST /api/payment/alipay/notify - 支付宝回调
- POST /api/payment/wechat/notify - 微信回调
- GET /api/payment/verify - 验证支付状态

### 分销API
- GET /api/referral/code - 获取邀请码
- POST /api/referral/bind - 绑定推荐关系
- GET /api/referral/earnings - 查询收益
- POST /api/referral/withdraw - 申请提现

### 管理后台API
- GET /api/admin - 概览数据
- GET/POST/PUT/DELETE /api/admin/content - 内容管理
- GET /api/admin/payment - 订单管理
- GET /api/admin/referral - 分销管理

## 7. UI组件规范

### 设计风格
- iOS毛玻璃风格
- 深色主题为主
- 品牌色: #8B5CF6 (紫色)
- 流畅动画: Framer Motion
- 响应式设计: 移动优先

### 组件库
- 使用 Radix UI 基础组件
- 自定义样式用 Tailwind CSS
- 图标使用 Lucide React

### CSS规范
全局变量:
```css
:root {
  --app-brand: #8B5CF6;
  --app-brand-light: rgba(139, 92, 246, 0.1);
  --app-bg-primary: #0F0F0F;
  --app-bg-secondary: #1A1A1A;
  --app-text-primary: #FFFFFF;
  --app-text-secondary: rgba(255, 255, 255, 0.7);
  --glass-bg: rgba(255, 255, 255, 0.1);
  --glass-border: rgba(255, 255, 255, 0.2);
}
```

通用类:
- .glass-card - 毛玻璃卡片
- .btn-ios - iOS风格按钮
- .safe-bottom - 安全区域适配
- .touch-feedback - 触摸反馈

## 8. 微信小程序

完整生成小程序代码:
- pages/index - 首页
- pages/match - 匹配
- pages/my - 我的
- pages/read - 阅读
- utils/payment.js - 支付工具

配置文件:
- app.json - 全局配置(页面路由/TabBar/窗口样式)
- project.config.json - 项目配置

## 9. 配置文件

### package.json
依赖版本:
- next: 16.0.10
- react: 19.0.0
- typescript: 5.9.3
- tailwindcss: 4.1.9
- zustand: 5.0.9
- framer-motion: 12.26.2

### .env.local
环境变量:
- NEXT_PUBLIC_BASE_URL
- WECHAT_APP_ID/APP_SECRET/MCH_ID/API_KEY
- ALIPAY_PARTNER_ID/SECURITY_KEY
- GITHUB_TOKEN/REPO/BRANCH
- ADMIN_USERNAME/ADMIN_PASSWORD

## 10. 关键业务逻辑

### 支付流程
1. 用户点击购买 → 创建订单
2. 展示支付二维码
3. 用户完成支付
4. 支付回调验证
5. 解锁内容
6. 自动跳转读者群

### 分销佣金计算
```typescript
// 购买时自动计算
if (user.referredBy) {
  const referrer = findReferrer(user.referredBy)
  const earnings = amount * 0.9  // 90%
  referrer.earnings += earnings
  referrer.pendingEarnings += earnings
}
```

### 匹配算法
```typescript
function calculateMatchRate(user1, user2) {
  let score = 0
  // MBTI匹配: 20分
  if (user1.mbti === user2.mbti) score += 20
  // 兴趣匹配: 最高80分
  const commonInterests = getCommonInterests(user1, user2)
  score += commonInterests.length * 20
  return Math.min(score, 100)
}
```

# 代码生成要求

1. **完整性**: 生成所有文件,包括配置文件
2. **可运行**: 代码必须可以直接运行
3. **类型安全**: 严格使用TypeScript
4. **注释清晰**: 关键逻辑添加注释
5. **命名规范**: 遵循约定的命名规则
6. **错误处理**: 添加适当的错误处理
7. **性能优化**: 使用React.memo/useMemo/useCallback
8. **响应式**: 移动端优先,支持桌面端
9. **安全性**: 敏感数据加密,XSS防护
10. **可扩展**: 预留MongoDB升级接口

# 额外要求

- 所有UI组件使用函数组件 + Hooks
- 状态管理集中在 Zustand store
- API Routes 使用 Next.js 13+ App Router
- 样式使用 Tailwind CSS + CSS变量
- 动画使用 Framer Motion
- 图标使用 Lucide React
- 表单验证使用原生HTML5
- 日期处理使用原生Date API

# 文档参考

项目完整文档位于: `/开发文档/`
- 00-项目代码生成完全指南.md
- 项目完整总结.md
- 1、需求/业务需求.md
- 2、架构/技术选型.md
- 4、前端/前端开发规范.md
- 5、接口/API接口完整文档.md

请严格按照上述规范生成完整项目代码。
```

---

## 🎯 使用方法

### 方式一: 直接复制提示词

1. 复制上面的完整提示词
2. 粘贴到 Claude/GPT-4/Cursor 对话框
3. AI 将生成完整项目代码

### 方式二: 结合文档生成

1. 将本文档和 `00-项目代码生成完全指南.md` 一起提供给AI
2. 提示词: "请根据这两份文档生成完整项目代码"
3. AI 将参考详细规范生成代码

### 方式三: 分步生成

可以分步骤请求AI生成:

```
第1步: 请生成项目基础结构(package.json, tsconfig.json等)
第2步: 请生成类型定义文件(lib/types.ts)
第3步: 请生成核心数据文件(lib/book-data.ts)
第4步: 请生成状态管理(lib/store.ts)
第5步: 请生成UI组件(components/)
第6步: 请生成页面(app/)
第7步: 请生成API(app/api/)
第8步: 请生成小程序(miniprogram/)
第9步: 请生成样式文件
第10步: 请生成配置文件
```

---

## ✅ 生成后检查

生成完成后,请检查:

### 必须文件
```bash
- [ ] package.json
- [ ] tsconfig.json
- [ ] next.config.mjs
- [ ] tailwind.config.js
- [ ] .env.local
- [ ] lib/types.ts
- [ ] lib/book-data.ts
- [ ] lib/store.ts
- [ ] app/layout.tsx
- [ ] app/page.tsx
- [ ] app/globals.css
- [ ] components/ui/button.tsx
- [ ] components/payment-modal.tsx
- [ ] app/api/book/all-chapters/route.ts
- [ ] miniprogram/app.json
```

### 运行测试
```bash
# 安装依赖
pnpm install

# 启动开发服务器
pnpm dev

# 访问 http://localhost:3000
# 检查首页是否正常显示
# 检查API接口是否正常响应
```

---

## 🔧 常见问题

### Q1: 生成的代码缺少某些文件?
A: 明确告诉AI: "请生成完整的XX文件,包括所有必需的导入和类型定义"

### Q2: 类型错误?
A: 确保先生成 `lib/types.ts`,再生成其他文件

### Q3: 样式不生效?
A: 检查 `app/globals.css` 是否正确导入到 `app/layout.tsx`

### Q4: API接口404?
A: 检查 `app/api/` 目录结构和 `route.ts` 文件命名

### Q5: 小程序无法运行?
A: 检查 `miniprogram/app.json` 配置和页面路径

---

## 📚 相关文档

- [00-项目代码生成完全指南](./00-项目代码生成完全指南.md) - 详细代码模板
- [项目完整总结](./项目完整总结.md) - 项目概览
- [技术选型](./2、架构/技术选型.md) - 技术栈说明
- [API文档](./5、接口/API接口完整文档.md) - 接口规范
- [前端规范](./4、前端/前端开发规范.md) - 代码规范

---

**总结**: 使用本提示词可让AI直接生成完整可运行的项目代码。如需更详细的代码模板,请参考 `00-项目代码生成完全指南.md`。

**支持的AI**: Claude Sonnet 4.5, GPT-4, Cursor, Copilot  
**预计生成时间**: 5-15分钟  
**代码完整度**: 100%
