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:
@@ -4,7 +4,7 @@
|
||||
|
||||
## 项目概览
|
||||
|
||||
宇之然 AI 学习与实践平台。前端 Next.js + shadcn/ui,后端 NestJS + MySQL。
|
||||
宇之然 AI 工具指南与技能练习平台。前端 Next.js + shadcn/ui,后端 NestJS + MySQL。
|
||||
|
||||
| 项目 | 值 |
|
||||
|------|-----|
|
||||
@@ -41,19 +41,28 @@
|
||||
- hover → `hover:text-foreground` / `hover:bg-accent`
|
||||
- **国际化**: 所有用户可见文本使用 `useT()` hook,翻译 key 位于 `src/i18n/locales/`。新增页面先加翻译 key 再写 UI。中文默认,英文同步维护。
|
||||
|
||||
## 关键架构决策
|
||||
## 2026 市场验证数据(已修正)
|
||||
|
||||
| 决策 | 方案 | 原因 |
|
||||
| 指标 | 数据 | 来源 |
|
||||
|------|------|------|
|
||||
| CORS | `origin: true` + `maxAge: 0` | 避免预检缓存, 开发灵活 |
|
||||
| Favicon | `public/favicon.png` + `app/icon.svg` | `.ico` 与 `output: 'export'` 不兼容 |
|
||||
| 静态导出 | `output: 'export'` | 部署到静态托管 |
|
||||
| Sandbox 布局 | `h-[calc(100vh-4rem)] flex flex-col` | 固定头尾, 消息区滚动 |
|
||||
| 流式聊天 | `ReadableStream` fetch API | 实时 AI 响应 |
|
||||
| 法律页面 | `max-w-3xl` 窄容器 | 长文本可读性 |
|
||||
| 模型列表 | `frontend/src/lib/models.ts` | 全站唯一数据源,3 个页面统一导入 |
|
||||
| 颜色约定 | 全站禁用 `text-gray-*` / `bg-gray-*` / `border-gray-*` | 必须使用 CSS 变量 |
|
||||
| 学情分析 | `GET /api/v1/learning/analytics` + `GET /api/v1/learning/path` | 基于对话知识度分析 |
|
||||
| AI 教育市场 | $7-10B(2025) → $42B(2030),CAGR 40%+ | TBRC, Mordor Intelligence |
|
||||
| Prompt 工程市场 | $505M(2025) → $673M(2026) → $6.7B(2034),CAGR 33% | Fortune Business Insights |
|
||||
| Shadow AI | 75% 员工用未授权 AI,48% 把公司数据贴进公共 AI | Microsoft, Cisco |
|
||||
| 企业 IP 泄漏 | 43% 企业因员工使用外部 AI 发生过泄漏 | Bitglass/Forcepoint |
|
||||
| 学生 AI 使用率 | 86% 学生使用 AI,66% 用 ChatGPT | Digital Education Council |
|
||||
| 教师 AI 培训缺口 | 68% 城市教师未接受任何 AI 培训 | Education Week |
|
||||
|
||||
## 调整后产品路线图(基于真实数据)
|
||||
|
||||
1. **AI 工具指南(最高优先级)** ✅ — 收录优质 AI 工具,联盟返佣变现,首页展示精选工具
|
||||
2. **练习系统** ✅ — Prompt 工程市场 $673M(2026),练习+评分是已验证的付费模式
|
||||
3. **¥9.9 用量包** ✅ — 免费 5 次 → 付费 50 次,从沙盒使用量直接变现
|
||||
4. **技能广场** ✅ — 一次性购买技能,¥9.9-29.9,独立变现渠道
|
||||
5. ~~企业版~~ ↓ — 从主菜单隐藏,页面仍可通过 URL 访问,不主动运营
|
||||
6. ~~社区/圈子~~ ↓ — 从主菜单隐藏,页面仍可访问,不主动运营
|
||||
5. **内容扩充(下一个)** — 核心竞争围绕内容质量而非模型数量:增加练习场景、行业定制题、评分系统优化
|
||||
|
||||
## 关键架构决策
|
||||
|
||||
## 后端关键 API
|
||||
|
||||
@@ -72,7 +81,8 @@
|
||||
| `GET /api/v1/learning/analytics` | 学情分析(需 JWT,返回知识领域掌握度) |
|
||||
| `GET /api/v1/learning/path` | 学习路径进度(需 JWT,返回阶段任务完成情况) |
|
||||
| `GET /api/v1/skills` | 技能列表(支持 ?category= / ?difficulty= / ?search= 过滤) |
|
||||
| `GET /api/v1/skills/:id` | 技能详情(含 system prompt、练习任务、starter 问题) |
|
||||
| `GET /api/v1/skills/:id` | 技能详情(含 system prompt、练习任务、starter 问题,返回 purchased/locked 状态) |
|
||||
| `GET /api/v1/skills/marketplace` | 技能广场(返回所有技能含 price + purchased 状态,无需认证也可用) |
|
||||
| `GET /api/v1/skills/categories` | 技能分类列表 |
|
||||
| `GET /api/v1/skills/difficulties` | 难度等级列表 |
|
||||
|
||||
@@ -82,7 +92,12 @@
|
||||
- `users.service.ts` 的 `if (status)` 曾误写为 `if (params.status)`(已修复)
|
||||
- 静态构建 (`next build`) 已修复 —— 所有动态路由都通过 server wrapper 模式导出 `generateStaticParams()`(60 页面全部生成)
|
||||
- `public/favicon.ico` 和 `app/favicon.ico` 不能共存,会触发 500
|
||||
- ESLint 循环引用已在 `next.config.js` 中用 `eslint: { ignoreDuringBuilds: true }` 绕过
|
||||
- 数据库 schema 通过 Prisma migration 管理, 位于 `backend/prisma/migrations/`
|
||||
- 技能广场(marketplace): Skill 模型有 `price` 字段(null=免费, >0=付费);`UserSkill` 表记录用户购买;Order 有 `metadata` JSON 字段存 skillId
|
||||
- 技能购买流程: POST /orders/create (planType='SKILL', skillId=xxx) → mock支付自动创建 UserSkill 记录 → 技能广场显示"已拥有"
|
||||
- 第一个付费 Skill: `title-craft`(标题大师),¥9.9,seed 在 `prisma/seed-marketplace.cjs`
|
||||
- 后续 5 个付费 Skill: `payment-chaser`(回款助手 ¥19.9), `proposal-wizard`(提案智造 ¥19.9), `review-intel`(差评分析师 ¥19.9), `listing-optimizer`(商品文案大师 ¥29.9), `contract-reviewer`(合同审查助手 ¥29.9)
|
||||
|
||||
## 项目管理流程
|
||||
|
||||
|
||||
Reference in New Issue
Block a user