# 医科高校 AI 学习中心 — Web 前端(新版) 参考 `GovAi/apps/web` 的现代化技术栈重建的前端,与原 `frontend/` 并存(原前端保留不动)。 ## 技术栈 - **Next.js 15** App Router + **React 19** - **Tailwind CSS v4**(oklch 主题变量,医学青蓝配色,支持暗色模式) - **shadcn 风格 UI 组件**(自实现,零额外 Radix 依赖) - **Zustand** 管理认证状态(替代旧版 React Context) - **TanStack Query** 处理数据请求与缓存 - **sonner** 全局 Toast,**lucide-react** 图标 ## 与后端的契约 完全沿用原前端的后端契约,无需改动 NestJS: - 所有请求走 `/api/*`,由 `next.config.mjs` 的 `rewrites` 代理到 `BACKEND_URL`(默认 `http://localhost:3000`)。 - 令牌存于 `localStorage`(键 `cac.token`),自动附加 `Authorization: Bearer `。 - 错误解析后端统一错误体(`AppError.toJSON()`)。 ## 功能模块 - **登录 / 注册**:支持三角色注册与内置测试账户一键登录。 - **学生端**:学习空间、能力画像、职业规划、课程对练、临床对话对练、研究资料查询、AI 协同训练。 - **导师端**:题目审核、成果点评、带教学生画像。 - **管理端**:技能治理、权限与合规。 ## 开发 ```bash cp .env.example .env.local # 按需修改 BACKEND_URL npm install npm run dev # 默认 http://localhost:4100 ``` > 注:原前端 `frontend/` 默认运行于 `:4000`,本前端使用 `:4100`,可同时运行对比。