P8 平台轻量化改造 + SSG修复 + 编程导师 + 文档完善

- Prisma: Tool 模型加 affiliateLink;免费用户沙盒 10→5 次/日
- 后端: Tools API + /admin/tools CRUD 5 端点;Practices 完整模块
- 导航: 主菜单隐藏企业版/社区(URL 可访问)
- 首页: 重定位为 AI 工具指南;新增精选工具区块;Feature 重写
- 工具页: affiliateLink 绿色推荐 Badge
- SSG 修复: config.ts 构建时直连 localhost:4000,页面 108→127
- 沙盒: 新增编程导师场景(苏格拉底教学法)
- 练习系统: Practices 多场景练习(含结构化评分)
- 技能广场: 6 个付费 Skill(标题大师/回款助手等)
- 管理后台: Models/Posts/Practices CRUD 页面
- 文档: README + progress.md 全面更新;AGENTS.md 同步定位
- 清理: .env.example 移除;tsbuildinfo gitignore
This commit is contained in:
yuzhiran-dev
2026-06-18 18:14:07 +08:00
parent fb8152401b
commit 0f215d2aad
103 changed files with 5240 additions and 778 deletions
+83 -74
View File
@@ -1,6 +1,6 @@
# 宇之然 AI (YuZhiRan AI)
# 宇之然 AI 工具指南与技能练习平台
AI 学习与实践平台 — 让每个人都能用好 AI
AI 工具指南 · 实战练习 · 技能提升 — 让每个人都能用好 AI
| 信息 | 内容 |
|------|------|
@@ -14,85 +14,94 @@ AI 学习与实践平台 — 让每个人都能用好 AI
```
ai-learning-platform/
├── README.md # 项目说明
├── AGENTS.md # AI 项目知识库(开发助手专用)
├── docs/ # 项目文档
│ ├── progress.md # 进度追踪
│ ├── archive/ # 历史进度存档
│ ├── 产品规划书.md # 完整产品规划(含商业模式、可行性分析)
│ ├── 技术架构设计.md # 技术选型与系统架构
│ └── 合规与运营方案.md # ICP合规、数据合规、运营策略
├── frontend/ # 官网前端(Next.js + Tailwind
├── mobile/ # 移动端 App/小程序
├── frontend/ # 前端(Next.js 14 App Router + shadcn/ui
├── backend/ # 后端 APINestJS + Prisma + MySQL
│ ├── src/modules/payment/ # 微信支付模块(已完善)
│ ├── src/modules/ai/ # AI模型接入(支持OpenAI兼容接口
└── prisma/ # 数据模型定义
│ ├── src/modules/ # 功能模块
│ ├── payment/ # 支付模块(统一支付网关对接
│ ├── ai/ # AI 模型接入(OpenAI/Doubao/DeepSeek
│ │ ├── sandbox/ # AI 实操沙箱(多场景练习)
│ │ ├── skills/ # 技能系统(付费 Skill 商店)
│ │ ├── tools/ # AI 工具指南
│ │ ├── practices/ # 练习系统
│ │ └── marketplace/ # 技能广场 API
│ ├── prisma/ # 数据模型定义(含 seed 脚本)
│ └── cert/ # 支付证书
└── scripts/ # 工具脚本
└── setup.sh # 项目初始化脚本
└── deploy.sh # 部署脚本
```
## 技术栈
### 后端
- **框架**: NestJS (Node.js)
- **ORM**: Prisma
- **数据库**: MySQL
- **支付**: 微信支付 V3 SDK
- **AI接口**: OpenAI兼容接口、DeepSeek、通义千问
### 前端
- **框架**: Next.js 14
- **样式**: Tailwind CSS
- **状态管理**: React Hooks
## 快速开始
### 1. 初始化项目
```bash
cd ai-learning-platform
./scripts/setup.sh
```
### 2. 手动配置
#### 后端配置
编辑 `backend/.env` 文件,配置:
- 微信支付参数(已从 `/www/wwwroot/sharefile/note.txt` 获取)
- AI模型API密钥
- 数据库密码
#### 前端配置
编辑 `frontend/.env.local` 文件,配置API地址。
### 3. 启动开发环境
```bash
# 启动后端(默认端口3000
cd backend && npm run dev
# 启动前端(默认端口3001
cd frontend && npm run dev
```
### 4. 访问
- 前端: http://localhost:3001
- 后端API文档: http://localhost:3000/api
## 核心功能
- ✅ 用户系统(注册、登录、会员管理)
- ✅ 微信支付集成(JSAPI/NATIVE/MWEB
- ✅ 会员订阅管理(月卡/年卡自动续期)
- ✅ AI模型接入(支持美团longcat等OpenAI兼容接口)
- ✅ 课程系统
- ✅ 提示词库
- ✅ AI实操沙箱
- ✅ 社区功能
## 产品定位
面向大众化分领域用户的 AI 学习与实践平台,涵盖
- AI 基础知识与通识教育
- 提示词工程教学与模板库
- 智能体(Agent)使用教程
- 大模型介绍与选型指南
- AI 实操沙箱体验
面向大众**AI 工具指南与技能练习平台**,帮助用户
- 发现优质 **AI 工具**(含返佣推荐)
- 系统学习 **Prompt 工程**(体系化课程)
- **AI 实操沙箱** 中练习提示词技能
- 购买一次性付费 **AI 技能**(垂直场景解决方案)
- 通过 **编程导师** 苏格拉底式学习编程
## 技术栈
### 前端
- **框架**: Next.js 14 (App Router, `output: 'export'` 静态导出)
- **UI**: shadcn/ui + Tailwind CSS(暗黑模式,CSS 变量主题)
- **国际化**: next-intl(中/英文,中文默认)
- **状态管理**: React Server Components 优先,客户端 `useState`/`useEffect`
### 后端
- **框架**: NestJS (Node.js)
- **ORM**: Prisma + MySQL
- **认证**: JWT + Passport
- **AI 接口**: OpenAI 兼容接口(DeepSeek、字节豆包、通义千问)
- **支付**: 统一支付网关(yzrcloud.cn,支持支付宝/微信)
## 快速开始
```bash
# 后端开发(端口 4000
cd backend
cp .env.example .env # 配置数据库密码、AI 密钥等
npm install
npx prisma generate
npx prisma db push # 初始化数据库
npm run start:dev
# 前端开发(端口 3000
cd frontend
cp .env.local.example .env.local # 或直接设置 NEXT_PUBLIC_API_URL=/api/v1
npm install
npm run dev
```
**注意**: 前端为 SSG`output: 'export'`),构建时需要后端运行在 `localhost:4000` 以确保 `generateStaticParams` 能获取动态路由参数。
## 核心功能
| 功能 | 说明 | 状态 |
|------|------|------|
| 🛠️ **AI 工具指南** | 收录优质 AI 工具,含返佣链接推荐 | ✅ 已上线 |
| 📚 **课程系统** | AI 系统课程(免费/付费),含章节和课时 | ✅ 已上线 |
| 🧪 **AI 实操沙箱** | 多场景提示词练习(写作/编程/客服/翻译/编程导师) | ✅ 已上线 |
| 💰 **技能广场** | 一次性付费购买垂直场景 AI 技能(¥9.9-¥29.9) | ✅ 已上线 |
| 👤 **用户系统** | 注册/登录/会员管理 | ✅ 已上线 |
| 🧑‍🏫 **编程导师** | 苏格拉底式教学,不直接给答案 | ✅ 已上线 |
| 📊 **学情分析** | 知识领域掌握度跟踪 | ✅ 已上线 |
| 🏢 **企业版** | 企业 AI 培训管理(隐藏菜单,URL 可访问) | ⏸️ 暂停运营 |
## 部署架构
```
用户 → Nginx (443/80) → /api/* → backend (127.0.0.1:4000, PM2)
→ /* → static files (/www/wwwroot/www.yuzhiran.com/)
```
- 前端: Next.js SSG 导出到 `/www/wwwroot/www.yuzhiran.com/`Nginx 直接提供
- 后端: NestJS + PM2 常驻 4000 端口
- 数据库: MySQL 8.0 (systemd)
- Web 服务器: Nginx(宝塔面板管理)