🚀 SeatWeaver

AI 班级管理决策引擎 — 智能排座 · 行为分析 · 班级文化
Intelligent Classroom Management & Seating Decision Engine

---

📋 项目概览

SeatWeaver 是一款面向班主任的 AI 智能排座与班级管理一体化工具。基于多维标签系统和多地区教育模型，提供从排座优化到班级文化建设的全链路解决方案。

核心能力

领域	能力
🪑 智能排座	4 种优化算法（遗传算法 / 匈牙利算法 / 模拟退火 / 图求解），支持多维约束（视力、身高、行为、学业）
🌍 多地区适配	内地、香港、澳门、台湾 × 3 个学段教育模型，标签权重和约束规则自动适配
🧠 行为分析引擎	45+ 业务引擎覆盖：行为趋势、心理画像、冲突衍生、家校沟通、课堂诊断
📊 班级文化	氛围雷达、健康报告、成长档案、温情教育系统、班级诊断
👨‍🏫 教师关怀	教师数据分析、教学策略推荐、身心健康看板、LLM 深度推理助手
🔬 AI 扩展	事件总线、全局触发链、自动评语、进步检测器、师生温度指数
📸 数据录入	扫码录入、OCR 文本识别、CSV 模板导入、JSON 格式解析
🔐 安全	AES-256-GCM 加密、HMAC-SHA256 PIN 存储、常数时间比较防时序攻击

---

🏗️ 架构设计

seatweaver/
├── lib/
│   ├── algorithms/        # 4 种排座优化算法
│   ├── configs/           # 4 地区 × 3 学段教育模型
│   ├── engines/           # 45+ 业务引擎（核心逻辑）
│   ├── models/            # 19 个数据模型
│   ├── services/          # 21 个服务（存储、AI、消息、通知）
│   ├── store/             # AppState 全局状态管理（ChangeNotifier）
│   ├── ui/
│   │   ├── pages/         # 28 个页面
│   │   ├── widgets/       # 14 个可复用组件
│   │   ├── theme/         # 亮/暗主题
│   │   └── icons/         # 自定义图标
│   └── utils/             # 9 个工具函数
├── test/                  # 44 个测试文件（659+ 测试用例）
└── docs/                  # 文档与审计报告

引擎分类

类别	引擎	说明
🎯 排座	scoring_engine / constraint_engine / optimization_engine / rotation_engine / rl_seating_engine	座位评估、约束验证、方案优化、轮换策略
📈 行为	behavior_trend_engine / behavior_trigger_engine / behavior_derivative_handler / quick_recorder	行为趋势追踪、触发联动、衍生分析
🧠 心理	psych_behavior_engine / student_risk_engine / predictive_risk_engine	心理画像、风险预测、早期干预
🌱 成长	growth_archive_engine / growth_trend_engine / progress_detector / semester_simulator	成长档案、学期模拟
👨‍🏫 教师	teacher_analytics_engine / teaching_strategy_engine / teacher_wellness_engine / llm_deep_reasoning_engine	教师数据分析、策略推荐、身心健康、AI 推理
🏫 班级	class_culture_engine / climate_radar / classroom_diagnosis_engine / warm_education_system	班级文化、氛围雷达、诊断报告
💬 沟通	parent_communication_engine / comment_engine / personalized_script_engine	家校沟通、评语生成、个性化话术

---

🚀 快速开始

前置条件

• Flutter SDK ≥ 3.11.5
• Dart SDK ≥ 3.11.5
• Android Studio / Xcode（移动端构建）

安装

# 克隆仓库
git clone https://github.com/zxz88601151/-.git
cd seatweaver

# 安装依赖
flutter pub get

# 运行（开发模式）
flutter run

# 构建
flutter build apk    # Android
flutter build ios    # iOS
flutter build web    # Web
flutter build windows # Windows

首次使用

运行后进入 7 步交互式引导：

1. 欢迎界面 → 2. 选择地区（内地/香港/澳门/台湾）
2. 选择学段 → 4. 填写班级信息
3. 导入学生（扫码/CSV/手动） → 6. 配置座位行列
4. 预览确认 — 快速上手

---

🧪 测试

# 运行所有测试
flutter test

# 运行特定测试
flutter test test/engines_test.dart

# 代码分析
dart analyze lib/

当前测试状态：659 passed / 5 skipped / 0 failed

---

🗺️ 路线图

• 智能排座引擎（4 种算法）
• 多地区教育模型适配
• 行为追踪与心理画像
• 教师数据看板与 AI 推理
• 班级协作（多教师协同管理）
• 云端数据同步
• 家长端小程序
• 自动排课与值日安排

---

🤝 贡献指南

感谢您对 SeatWeaver 的关注！欢迎参与开发：

1. Fork 本仓库
2. 创建特性分支：git checkout -b feature/amazing-feature
3. 提交修改：git commit -m 'feat: add amazing feature'
4. 推送分支：git push origin feature/amazing-feature
5. 发起 Pull Request

详细规范请参阅 CONTRIBUTING.md。

提交规范

类型	说明
feat:	新功能
fix:	修复 Bug
refactor:	重构
docs:	文档
test:	测试
chore:	构建/工具

---

📄 许可证

本项目基于 MIT 许可证开源 — 详见 LICENSE。

---

👥 团队

• 中哥 — 创始人 & 核心开发者

---

_{Built with ❤️ for Chinese educators
SeatWeaver — 让每位学生有一个合适的座位}