# fool

**Repository Path**: liu-xinzi/fool

## Basic Information

- **Project Name**: fool
- **Description**: fool is a fool
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 教务管理系统微信小程序

基于 UniApp + Vue 3 的教务管理系统微信小程序，包含完整前后端功能和创新特性。

## 技术栈

### 前端
- **框架**: UniApp + Vue 3.4.21
- **状态管理**: Pinia 2.1.7
- **UI组件**: uView-Plus 3.3.0
- **样式**: SCSS/Sass 1.77.0
- **构建**: Vite 5.2.8

### 后端
- **框架**: Express.js
- **数据库**: MySQL 8.0+
- **认证**: JWT
- **ORM**: Sequelize

## 功能模块

### 核心功能
- 首页（个性化问候、快捷导航、统计卡片）
- 登录页（学号/工号登录、身份选择）
- 个人中心（用户信息、功能入口）
- 课表查询（周课表、课程详情）
- 成绩查询（学期筛选、成绩统计）
- 考试安排（状态筛选、倒计时）
- 通知公告（置顶标识、富文本）
- 课程列表（搜索、详情）

### 创新功能
1. **扫码签到**: 实时位置验证、时间窗口控制
2. **智能成绩分析**: GPA趋势预测、薄弱科目识别
3. **GPA计算器**: 目标GPA规划、学分建议
4. **智能提醒**: 上课提醒、考试提醒、空教室查询

## 项目结构

```
educational-admin/
├── client/                 # 前端项目
│   ├── src/
│   │   ├── api/           # API接口
│   │   ├── components/    # 公共组件
│   │   ├── pages/         # 页面
│   │   ├── stores/        # Pinia状态
│   │   ├── styles/        # 样式
│   │   └── utils/         # 工具函数
│   └── package.json
│
└── server/                # 后端项目
    ├── config/            # 配置文件
    ├── database/          # 数据库脚本
    ├── middlewares/       # 中间件
    ├── routes/            # 路由
    └── package.json
```

## 快速开始

### 前端

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

### 后端

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

### 数据库

```bash
# 执行初始化脚本
mysql -u root -p < database/init.sql
mysql -u root -p < database/seed.sql
```

## 测试账号

| 角色 | 学号/工号 | 密码 |
|------|----------|------|
| 学生 | 2024010001 | 123456 |
| 教师 | T2024001 | 123456 |

## API接口

### 用户模块
- `POST /api/user/login` - 用户登录
- `GET /api/user/info` - 获取用户信息
- `PUT /api/user/password` - 修改密码

### 课表模块
- `GET /api/schedule/today` - 今日课表
- `GET /api/schedule/week` - 周课表

### 成绩模块
- `GET /api/score/list` - 成绩列表
- `GET /api/score/statistics` - 成绩统计
- `GET /api/score/analysis` - 智能分析

### 签到模块【创新】
- `POST /api/attendance/create` - 创建签到
- `POST /api/attendance/sign` - 扫码签到

## License

MIT