Intellect Mindscape：AI驱动的互动式知识学习与测评平台

一个结合游戏化测验、AI个性化推荐和实时统计分析的互动学习平台，使用FastAPI、ReactJS和Keycloak构建，支持本地LLM部署。

在数字化学习的浪潮中，如何让学习变得既有趣又高效一直是教育技术领域的核心命题。传统的在线学习平台往往流于视频播放和文档阅读，缺乏互动性和个性化。Intellect Mindscape项目正是针对这一痛点，打造了一个游戏化的互动学习平台，将知识测验、AI推荐和实时反馈有机结合。

平台的核心体验是各种主题的知识测验。用户可以选择数学、音乐、三角函数等不同领域的题目进行挑战。与传统考试不同，这里的测验被设计成游戏形式——有时间限制、有得分排名、有连续答对的奖励机制，让学习过程充满乐趣和成就感。

测验完成后，系统不会简单地显示"答对/答错"，而是提供详细的统计分析，包括：

• 各知识点的掌握程度分布
• 答题速度和准确率的关联分析
• 与同类用户的对比数据
• 错误题目的详细解析

这是平台最具特色的功能。基于用户在测验中的表现数据，系统使用大语言模型（通过Ollama本地部署）生成个性化的学习建议。

例如，如果系统检测到用户在三角函数的正弦定理部分表现较弱，但在余弦定理部分掌握良好，AI可能会推荐："建议复习正弦定理的应用场景，特别是已知两边及其中一边对角的情况。可以尝试以下练习题..."

这种个性化推荐不仅指出薄弱环节，还提供具体的学习路径和资源建议，真正实现"因材施教"。

平台使用Gorilla WebSocket库实现了实时通信功能。这意味着：

• 用户可以实时看到其他在线用户的答题动态
• 支持多人在线对战模式
• 排行榜数据实时更新
• 教师可以实时监控班级学生的答题进度

这种实时性大大增强了平台的互动性和竞技感，让学习不再是孤独的活动。

项目采用微服务架构，将不同功能模块拆分为独立服务：

认证服务（auth-backend）：基于Keycloak实现统一的身份认证和授权管理。Keycloak作为开源的身份和访问管理解决方案，提供了OAuth2、OpenID Connect等标准协议的支持，确保系统的安全性。

测验API服务（quiz-backend-api）：使用FastAPI构建高性能的RESTful API，处理测验相关的业务逻辑，包括题目获取、答案提交、分数计算等。

AI推荐服务（quiz-backend-ai）：负责与Ollama LLM服务交互，处理用户表现数据的分析，生成个性化学习建议。

前端使用ReactJS构建，采用TypeScript提供类型安全。界面设计注重用户体验：

• 响应式布局，支持桌面和移动设备
• 流畅的动画过渡效果
• 直观的进度展示和成就系统
• 深色模式支持

项目提供了完整的Docker Compose配置，支持一键部署：

docker-compose up --build --remove-orphans -d

NGINX作为反向代理和负载均衡器，将请求路由到不同的后端服务。这种架构既保证了高可用性，也便于后续的水平扩展。