# kaojiazhao

**Repository Path**: uncle1987/kaojiazhao

## Basic Information

- **Project Name**: kaojiazhao
- **Description**: 驾考通小程序项目
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2026-05-28
- **Last Updated**: 2026-08-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🚗 驾考通 - 微信小程序

一款帮助学员学习科目一、科目四的小程序，通过趣味漫画解析，让学习更轻松！

## ✨ 功能特性

### 核心功能
- 📚 **题库练习** - 科目一、科目四完整题库
- 🎨 **漫画解析** - 有趣的漫画图示讲解答案
- 📝 **模拟考试** - 真实考试环境模拟
- ❌ **错题本** - 自动记录错题，反复练习
- 💎 **付费解锁** - 免费试用，付费解锁完整内容

### 特色功能
- 📊 **学习统计** - 答题量、正确率统计
- 🏆 **学习进度** - 可视化学习进度
- 🎯 **章节练习** - 按章节分类练习
- ⏰ **考试计时** - 模拟真实考试时长

## 🛠️ 技术架构

### 前端（微信小程序）
- 微信原生小程序框架
- 本地存储：wx.storage
- 微信支付集成（待上线）

### 后端（Node.js + Express）
- Express 框架
- MySQL 数据库
- 微信登录验证
- Mock 支付系统

## 📂 项目结构

```
kaojiazhao/
├── backend/                 # 后端服务
│   ├── src/
│   │   ├── config/          # 配置文件
│   │   ├── routes/          # 路由
│   │   │   ├── user.js      # 用户相关
│   │   │   ├── question.js  # 题库相关
│   │   │   └── payment.js   # 支付相关
│   │   ├── app.js           # 后端入口
│   │   └── data/            # 题库数据
│   ├── package.json
│   └── .env
│
├── miniprogram/            # 微信小程序
│   ├── pages/              # 页面
│   │   ├── index/          # 首页
│   │   ├── practice/       # 练习页
│   │   ├── exam/           # 考试页
│   │   ├── mistakes/       # 错题本
│   │   ├── pay/            # 支付页
│   │   └── mine/           # 个人中心
│   ├── app.js              # 小程序入口
│   ├── app.json            # 小程序配置
│   └── sitemap.json
│
└── .trae/                  # 文档目录
    └── documents/
        └── detailed-design.md
```

## 🚀 快速开始

### 后端启动

1. 进入后端目录
```bash
cd backend
```

2. 安装依赖
```bash
npm install
```

3. 配置数据库
```bash
# 编辑 .env 文件，配置数据库连接
# DB_HOST=localhost
# DB_PORT=3306
# DB_USER=root
# DB_PASSWORD=your_password
# DB_NAME=kaojiazhao
```

4. 初始化数据库
```bash
npm run init-db
```

5. 启动开发服务器
```bash
npm run dev
# 或
npm start
```

后端服务将在 http://localhost:3000 启动

### 小程序启动

1. 打开微信开发者工具
2. 导入项目，选择 miniprogram 目录
3. 在开发者工具中配置 AppID（测试可使用测试号）
4. 修改 app.js 中的 baseUrl 为你的后端地址
5. 点击编译运行

## 📱 页面说明

### 首页 (pages/index)
- 用户信息展示
- 科目切换
- 学习进度
- 功能入口
- VIP解锁提示

### 练习页 (pages/practice)
- 题目展示
- 选项选择
- 答案提交
- 漫画解析弹窗
- 下一题切换

### 考试页 (pages/exam)
- 考试设置
- 计时答题
- 题目导航
- 成绩展示
- 错题回顾

### 错题本 (pages/mistakes)
- 错题列表
- 错题重练
- 错题移除

### 支付页 (pages/pay)
- 价格展示
- 支付方式选择
- Mock 支付流程
- 解锁确认

### 个人中心 (pages/mine)
- 用户信息
- 学习统计
- 菜单列表
- 分享功能

## 💾 数据库设计

### 用户表 (users)
- id: 主键
- openid: 微信 openid
- nickname: 昵称
- avatar: 头像
- is_paid: 是否付费
- paid_at: 付费时间

### 订单表 (orders)
- id: 主键
- user_id: 用户ID
- order_no: 订单号
- amount: 金额
- pay_type: 支付类型
- status: 订单状态

### 学习记录表 (study_records)
- id: 主键
- user_id: 用户ID
- question_id: 题目ID
- answer: 用户答案
- is_correct: 是否正确

### 错题表 (mistakes)
- id: 主键
- user_id: 用户ID
- question_id: 题目ID
- wrong_answer: 错误答案
- resolved: 是否已解决

## 📊 API 接口

### 用户相关
- `POST /api/user/login` - 微信登录
- `GET /api/user/info` - 获取用户信息

### 题库相关
- `GET /api/questions` - 获取题目列表
- `GET /api/questions/:id` - 获取题目详情
- `POST /api/questions/answer` - 提交答案
- `GET /api/questions/chapters/list` - 获取章节列表
- `GET /api/questions/mistakes/list` - 获取错题列表
- `DELETE /api/questions/mistakes/:id` - 移除错题

### 支付相关
- `POST /api/payment/create-order` - 创建订单
- `POST /api/payment/mock-pay` - Mock支付
- `GET /api/payment/order/:order_no` - 查询订单

## 🎨 设计特色

### 配色方案
- 主色调：橙红色 (#ff6b35)
- 辅助色：浅橙色 (#f7931e)
- 背景色：浅灰色 (#f5f5f5)

### 漫画系统
- 角色：👮 交警、🚗 小汽车、🚦 红绿灯、🚶 行人
- 场景：路口、高速、雨天、夜间、停车场、学校
- 对话框：正确（绿色）、错误（红色）、提示（蓝色）

## 📦 Mock 数据

### 题库数据
- 科目一：15道示例题（10道免费 + 5道付费）
- 科目四：8道示例题（5道免费 + 3道付费）
- 包含完整的漫画解析数据

## ⚠️ 注意事项

1. **图片资源**：需要在 miniprogram/images/ 目录下放置图标文件
2. **后端启动**：需要先安装 Node.js 和 MySQL
3. **支付功能**：当前为 Mock 支付，正式上线需要申请微信支付商户号
4. **小程序审核**：正式上线需要申请小程序并通过审核

## 🚗 下一步规划

- [ ] 完善题库数据（2000+道题）
- [ ] 接入真实微信支付
- [ ] 添加学习成就系统
- [ ] 添加排行榜功能
- [ ] 添加分享裂变功能
- [ ] 添加知识点卡片学习
- [ ] 添加错题打印功能
- [ ] 添加考试预约提醒

## 📄 许可证

MIT License

---

祝你驾考顺利！🚗✨