ai-learning-platform/docs/archive/progress-2026-05-12-before-notifications.md

项目进度追踪

每次完成任务后更新此文件。旧版归档到 docs/archive/。

---

Phase 1: 基础框架搭建 ✅ 已完成

后端

• NestJS 模块化架构搭建
• JWT 认证（login/register）
• TypeORM + PostgreSQL 数据库连接
• 全部 92 单元测试 + 13 e2e 通过
• CORS 配置（origin: true, maxAge: 0）

前端

• Next.js App Router + shadcn/ui 集成
• 暗黑模式（next-themes + Tailwind class 策略）
• 导航栏激活态高亮（usePathname()）
• 错误边界组件（not-found.tsx, error.tsx, global-error.tsx）
• Favicon 配置（png + svg）
• 全站 text-gray-* → CSS 变量替换（35+ 页面）
• 全站 bg-gray-* / border-gray-* → CSS 变量替换

页面布局统一化

• 容器标准：max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-12
• 标题标准：text-3xl font-bold text-foreground
• 副标题标准：text-muted-foreground
• 法律/文本页：max-w-3xl（长文可读性）
• my/* 子页容器统一（max-w-4xl/2xl → max-w-7xl）
• admin/enterprise 容器统一（max-w-6xl → max-w-7xl）
• users/[id] 容器统一（max-w-4xl → max-w-7xl）

测试

• search.service 测试（新增）
• tools.service 测试（新增）
• users.service 测试（新增、含 bug 修复验证）

---

Phase 2: 功能补全 ✅ 已完成

缺失页面补充

• /community/[id] 帖子详情页（含评论）
• /admin/courses/new & [id] 课程新建/编辑
• /admin/prompts/new & [id] 提示词新建/编辑
• /admin/contents/new & [id] 内容新建/编辑
• /admin/tools/new & [id] 工具新建/编辑

Sandbox 沙盒

• 流式 API 集成（ReadableStream）
• 模型选择器（URL query 预设）
• 明暗切换
• 固定头尾布局 h-[calc(100vh-4rem)]

企业版模块

• 编辑组织 UI
• 截止日期选择器
• 管理员角色校验（ForbiddenException）

静态构建修复

• 所有动态路由添加 generateStaticParams()
• 共修复 11 个动态路由目录（users, admin/courses, admin/contents, admin/prompts, admin/tools, admin/enterprise, admin/enterprise/report, circles, community, contents, courses）
• 使用的模式：server component wrapper（page.tsx） + client component（client.tsx 等）
• 全量构建通过（54 页面静态生成）
• 修复了 admin/enterprise/[id] 及 report 页面的 JSX 结构错误

---

Phase 3: 🚧 进行中

• 通知系统 UI（notification_service 表）
• Loading 状态统一升级（spinner → Skeleton）
• 社区互动功能（点赞、评论）
• 全量静态构建验证（✅ 通过）

---

关键指标

指标	当前值
后端测试数	105（92 单元 + 13 e2e）
后端测试通过率	100%
前端页面数	54（全部静态生成）
暗黑模式兼容	全站 100%
静态构建状态	✅ 通过
next build status	✅ 54/54 页面成功

---

最后更新：2026-05-12