# goodClass

**Repository Path**: xxooxx8/good-class

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-29
- **Last Updated**: 2025-07-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 教培机构管理系统

## 项目概述

本系统是为兴趣班、学前教育等一对一或一对多教学机构设计的综合管理平台，采用前后端分离架构，包含后台管理系统和家长小程序两端，涵盖机构运营全流程管理。

## 技术栈

### 后端技术
- **框架**: Spring Boot + MyBatis Plus
- **架构**: 微服务架构，RESTful API
- **数据库**: MySQL（支持分库分表）
- **缓存**: Redis
- **安全**: Spring Security + JWT
- **文档**: Swagger/OpenAPI

### 前端技术
- **管理端**: Vue 3 + TypeScript + Vite
- **UI框架**: Element Plus / Ant Design Vue
- **小程序**: 微信原生小程序 / Uni-app

### 基础设施
- **容器化**: Docker + Docker Compose
- **微信生态**: 微信公众号/小程序集成
- **消息服务**: 短信/邮件服务
- **存储**: 阿里云OSS/腾讯云COS

## 核心功能模块

### 📊 客户关系管理(CRM)
- **渠道管理**: 多渠道来源追踪、ROI分析、地推管理
- **客户信息**: 家长学生信息管理、多对多关系维护
- **沟通记录**: 全方位沟通日志、微信集成、跟进提醒

### 💰 合同财务管理
- **合同管理**: 电子合同签署、状态跟踪、到期提醒
- **收费管理**: 多种收费模式、分期付款、发票管理
- **财务报表**: 收支统计、课时消耗分析、欠费提醒

### 📅 智能排课系统
- **资源管理**: 教师资质管理、教室资源分配
- **智能排课**: 一对一/小班课排课、冲突检测、调课处理
- **课表展示**: 多维度课表视图、日历集成

### ✅ 上课签到管理
- **多种签到**: 二维码、人脸识别、手动签到
- **上课记录**: 课堂笔记、教学内容、学生表现
- **课时核销**: 自动扣除、异常处理、预警提醒

### 👨‍🏫 教师工作台
- **个人管理**: 课表查看、上课提醒、学生档案
- **教学工具**: 课堂反馈、作业批改、学习进度跟踪

### 📱 家长小程序
- **信息查询**: 学生课表、学习进度、成长档案
- **家校互动**: 教师留言、请假申请、课程反馈
- **便民服务**: 在线支付、考勤查询、通知推送

### 🎯 营销工具
- **活动管理**: 试听预约、开放日活动、节日主题
- **优惠策略**: 优惠券系统、满减活动、老带新奖励
- **数据分析**: 转化率统计、营销效果评估

### 📝 报名管理
- **报名流程**: 在线咨询、试听预约、资料审核
- **多渠道支持**: 小程序、官网、线下、转介绍
- **数据统计**: 渠道分析、转化追踪

## 项目结构

```
GuaClass/
├── java/                    # 后端Java项目
│   ├── opsli-api/          # API接口层
│   ├── opsli-base-support/ # 基础支持模块
│   ├── opsli-modulars/     # 业务模块
│   ├── opsli-plugins/      # 插件模块
│   ├── opsli-starter/      # 启动器
│   └── db-file/           # 数据库脚本
├── web/                    # 前端Vue项目
│   ├── src/
│   │   ├── api/           # API接口
│   │   ├── components/    # 组件库
│   │   ├── views/         # 页面视图
│   │   └── utils/         # 工具类
│   └── public/            # 静态资源
└── docs/                  # 项目文档
```

## SaaS商业模式

本系统采用 **简化 Freemium 模式**，提供清晰的双版本选择：

### 🆓 免费版 (基础版)
- 支持100个学员、10个教师
- 提供完整的核心教学管理功能
- 基础小程序和财务管理
- 适合小型培训机构长期使用

### 🌟 旗舰版 (¥399/月)
- 无限制使用
- 品牌定制 + AI智能功能
- 完整营销工具 + 数据分析
- 多校区管理 + 企业级安全
- 开放平台 + 专属服务支持

**📋 详细功能对比**: [SaaS功能分级方案](./SaaS功能分级方案.md) | [功能对比表](./功能对比表.md)

## 开发计划

项目开发分为三个阶段进行：

### 🚀 [第一阶段](./阶段1.md) - 核心基础系统 (4-6个月)
构建系统核心框架、CRM功能和排课系统

### 📱 [第二阶段](./阶段2.md) - 家校互动与移动端 (3-4个月)  
开发家长小程序、完善家校沟通功能

### 🎯 [第三阶段](./阶段3.md) - 营销工具与数据分析 (2-3个月)
构建营销工具、数据分析和AI扩展功能

## 快速开始

### 环境要求
- JDK 8+
- Node.js 16+
- MySQL 8.0+
- Redis 6.0+

### 后端启动
```bash
cd java
mvn clean install
java -jar opsli-starter/target/opsli-starter.jar
```

### 前端启动
```bash
cd web
npm install
npm run dev
```

### Docker部署
```bash
docker-compose up -d
```

## 系统特色

- 🎯 **专业定制**: 专为教培机构设计，贴合行业需求
- 🔄 **全流程覆盖**: 从获客到教学全链路管理
- 📱 **移动优先**: 支持小程序，随时随地使用
- 🤖 **智能化**: AI辅助排课、智能推荐
- 🔐 **数据安全**: 完整的权限体系，数据隐私保护
- 🚀 **高性能**: 微服务架构，支持高并发
- 💡 **易扩展**: 插件化设计，功能模块化

## 许可证

MIT License

## 贡献指南

欢迎提交Issue和Pull Request来改进项目。

## 联系我们

如有问题或建议，请提交Issue或联系开发团队。