# StudentSelect

**Repository Path**: baowuwolf/StudentSelect

## Basic Information

- **Project Name**: StudentSelect
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-16
- **Last Updated**: 2026-01-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 点名助手 (Student Select)

一款简洁高效的课堂点名应用，使用 Flutter 开发，支持 iOS、Android 和 Web 平台。

## 功能特性

### 📚 班级管理
- 创建、编辑、删除班级
- 查看班级学生人数和总点名次数
- 支持多个班级管理

### 👨‍🎓 学生管理
- 手动添加学生信息（学号、姓名、性别）
- 拍照批量导入学生名单（OCR 识别）
- 手动输入文本批量导入
- 查看学生被点名次数和上次点名时间

### 🎯 随机点名
- 一键开始随机点名
- 精彩的名字滚动动画效果
- 双按钮操作：确认 / 下一位
- 自动记录点名历史

## 技术栈

- **Flutter 3.x** - 跨平台 UI 框架
- **Provider** - 状态管理
- **SQLite** - 本地数据存储
- **flutter_animate** - 动画效果
- **image_picker** - 图片选择
- **google_mlkit_text_recognition** - OCR 文字识别

## 快速开始

### 环境要求

- Flutter SDK >= 3.0.0
- Dart SDK >= 3.0.0
- iOS: Xcode 14+
- Android: Android Studio / VS Code

### 安装运行

```bash
# 克隆项目
git clone <repository-url>
cd StudentSelect

# 安装依赖
flutter pub get

# 运行应用
flutter run

# 构建发布版本
flutter build apk          # Android
flutter build ios          # iOS
flutter build web          # Web
```

### iOS 配置

在 `ios/Runner/Info.plist` 中添加相机和相册权限：

```xml
<key>NSCameraUsageDescription</key>
<string>需要使用相机拍照导入学生名单</string>
<key>NSPhotoLibraryUsageDescription</key>
<string>需要访问相册选择图片</string>
```

### Android 配置

在 `android/app/src/main/AndroidManifest.xml` 中确保有相机权限：

```xml
<uses-permission android:name="android.permission.CAMERA"/>
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
```

## 项目结构

```
lib/
├── main.dart                 # 应用入口
├── models/                   # 数据模型
│   ├── class_info.dart       # 班级模型
│   └── student.dart          # 学生模型
├── pages/                    # 页面
│   ├── class_list_page.dart  # 班级列表
│   ├── student_list_page.dart# 学生列表
│   ├── roll_call_page.dart   # 点名页面
│   ├── add_student_page.dart # 添加学生
│   └── photo_import_page.dart# 拍照导入
├── providers/                # 状态管理
│   └── app_state.dart        # 应用状态
├── services/                 # 服务
│   └── database_service.dart # 数据库服务
└── theme/                    # 主题
    └── app_theme.dart        # 主题配置
```

## 设计特点

- 🎨 现代化 UI 设计，浅蓝色渐变背景
- 💫 流畅的动画效果
- 📱 响应式布局，适配各种屏幕尺寸
- 🌈 精心设计的配色方案

## 许可证

MIT License