# foursubstutor

**Repository Path**: wilsondebug/foursubstutor

## Basic Information

- **Project Name**: foursubstutor
- **Description**: 四科辅导 - 深圳初中历史/地理/生物/道法智能学习系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-26
- **Last Updated**: 2026-02-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FourSubsTutor 四科辅导

深圳初中历史、地理、生物、道法智能学习系统，包含后台管理网站和学生小程序。

## 系统架构

```
foursubstutor/
├── server/          # 后端API服务 (Node.js + Express + MongoDB)
├── admin/           # 后台管理系统 (React + Ant Design)
├── miniapp/         # 学生小程序 (UniApp + Vue3)
└── docs/            # 项目文档
```

## 核心功能

### 后台管理系统
- 📚 教材管理（PDF上传、章节解析）
- 🧠 知识点管理（树形结构、思维导图）
- 🤖 AI聊天框生成题库
- 📝 题库管理（选择/填空/简答多种题型）
- 👥 用户管理（学生、家长）

### 学生小程序
- 📖 知识点学习（思维导图展示）
- ✏️ 题库练习（智能出题）
- 🎙️ 语音答题（AI语音识别）
- 🤖 AI智能评分（简答题匹配度分析）
- 📊 学习闭环（测试→分析→补强）
- 📈 模拟考试（计时、自动评分）

## 技术栈

| 层级 | 技术 |
|------|------|
| 后端 | Node.js + Express + TypeScript |
| AI | Kimi / OpenAI API |
| 数据库 | MongoDB + Redis |
| 文件存储 | 阿里云OSS |
| 管理后台 | React 18 + Ant Design Pro |
| 小程序 | UniApp + Vue3 + uView Plus |

## 快速开始

### 1. 配置环境变量

```bash
cd server
cp .env.example .env
```

编辑 `.env` 文件，配置以下关键项：

```bash
# AI 配置 (从 Kimi 开放平台获取 API Key: https://platform.moonshot.cn/)
AI_PROVIDER=kimi
AI_API_KEY=your_kimi_api_key_here  # 不要在代码中提交真实Key

# 数据库
MONGODB_URI=mongodb://localhost:27017/shenzhen_study_four_doors

# JWT密钥
JWT_SECRET=your_random_secret_key
```

**⚠️ 安全提示**: `.env` 文件包含敏感信息，已加入 `.gitignore`，请勿提交到代码仓库！

### 2. 测试 AI 连接

```bash
cd server
npm install
npm run dev
```

测试 AI 是否配置成功：

```bash
curl http://localhost:3001/api/ai/test-connection
```

### 3. 启动后台管理

```bash
cd admin
npm install
npm run dev
```

### 4. 启动小程序

```bash
cd miniapp
npm install
npm run dev:mp-weixin
```

## 数据库模型

- **Textbook** - 教材信息
- **KnowledgePoint** - 知识点（树形结构）
- **Question** - 题目（支持多题型）
- **AnswerRecord** - 答题记录（含AI评分结果）
- **User** - 用户信息
- **ExamRecord** - 考试记录

详细设计见 [PRD文档](./docs/PRD-v2.md)

## API 接口

### AI 相关
| 接口 | 说明 |
|------|------|
| `GET /api/ai/test-connection` | 测试AI连接 |
| `POST /api/ai/generate-questions` | AI生成题目 |
| `POST /api/ai/grade-answer` | AI评分 |
| `POST /api/ai/analyze-weak-points` | 分析薄弱点 |

### 学习分析
| 接口 | 说明 |
|------|------|
| `GET /api/analysis/report` | 学习报告 |
| `GET /api/analysis/weak-points` | 薄弱知识点 |
| `POST /api/analysis/generate-practice` | 生成补充题库 |

## AI 评分规则

**简答题评分**（AI语义分析）：
- 匹配度 ≥ 95% → 满分
- 匹配度 80-94% → 得分 × 0.9
- 匹配度 60-79% → 得分 × 0.7
- 匹配度 40-59% → 得分 × 0.5
- 匹配度 < 40% → 0分

## 开发计划

| 阶段 | 时间 | 内容 |
|------|------|------|
| Milestone 1 | 第1-2周 | 基础架构搭建 |
| Milestone 2 | 第3-4周 | 后台管理开发 |
| Milestone 3 | 第5-6周 | 小程序开发 |
| Milestone 4 | 第7-8周 | AI功能集成 |
| Milestone 5 | 第9-10周 | 测试上线 |

## 获取 Kimi API Key

1. 访问 [Kimi 开放平台](https://platform.moonshot.cn/)
2. 注册账号并登录
3. 进入「API Key 管理」创建新 Key
4. 将 Key 复制到 `.env` 文件的 `AI_API_KEY` 字段

## 开源协议

MIT License