yuzhiran-dev
0f215d2aad
- 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
108 lines
4.5 KiB
Markdown
Executable File
108 lines
4.5 KiB
Markdown
Executable File
# 宇之然 AI 工具指南与技能练习平台
|
||
|
||
AI 工具指南 · 实战练习 · 技能提升 — 让每个人都能用好 AI
|
||
|
||
| 信息 | 内容 |
|
||
|------|------|
|
||
| 品牌 | 宇之然（北京宇之然科技中心） |
|
||
| 官网 | https://yuzhiran.com |
|
||
| 备域名 | https://yuzhiran.com.cn |
|
||
| ICP 备案 | ✅ 已完成 |
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
ai-learning-platform/
|
||
├── README.md # 项目说明
|
||
├── AGENTS.md # AI 项目知识库（开发助手专用）
|
||
├── docs/ # 项目文档
|
||
│ ├── progress.md # 进度追踪
|
||
│ ├── archive/ # 历史进度存档
|
||
│ ├── 产品规划书.md # 完整产品规划（含商业模式、可行性分析）
|
||
│ ├── 技术架构设计.md # 技术选型与系统架构
|
||
│ └── 合规与运营方案.md # ICP合规、数据合规、运营策略
|
||
├── frontend/ # 前端（Next.js 14 App Router + shadcn/ui）
|
||
├── backend/ # 后端 API（NestJS + Prisma + MySQL）
|
||
│ ├── src/modules/ # 功能模块
|
||
│ │ ├── payment/ # 支付模块（统一支付网关对接）
|
||
│ │ ├── ai/ # AI 模型接入（OpenAI/Doubao/DeepSeek）
|
||
│ │ ├── sandbox/ # AI 实操沙箱（多场景练习）
|
||
│ │ ├── skills/ # 技能系统（付费 Skill 商店）
|
||
│ │ ├── tools/ # AI 工具指南
|
||
│ │ ├── practices/ # 练习系统
|
||
│ │ └── marketplace/ # 技能广场 API
|
||
│ ├── prisma/ # 数据模型定义（含 seed 脚本）
|
||
│ └── cert/ # 支付证书
|
||
└── scripts/ # 工具脚本
|
||
└── deploy.sh # 部署脚本
|
||
```
|
||
|
||
## 产品定位
|
||
|
||
面向大众的 **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（宝塔面板管理）
|