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
宇之然 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，支持支付宝/微信）
快速开始
# 后端开发（端口 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（宝塔面板管理）