# 三维狐少儿编程教务管理系统

**Repository Path**: cnue4_admin/3vf

## Basic Information

- **Project Name**: 三维狐少儿编程教务管理系统
- **Description**: 为提升少儿编程培训机构的教务管理效率，规范学生、课程、班级、课时、费用和教师结算等业务流程，三维狐少儿编程教务管理系统 V1.0 正式发布。本系统基于 ThinkPHP 和 FunAdmin 后台框架开发，采用 MySQL 数据库存储业务数据，围绕少儿编程培训机构的实际教务场景，设计并实现了一套较为完整的后台管理系统。
- **Primary Language**: PHP
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 5
- **Created**: 2026-05-05
- **Last Updated**: 2026-05-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 三维狐少儿编程教务管理系统
# 官方网站：[3vf.cn](https://3vf.cn)
## 介绍
三维狐少儿编程教务管理系统是一套面向少儿编程培训机构的后台教务管理系统。
为提升少儿编程培训机构的教务管理效率，规范学生、课程、班级、课时、费用和教师结算等业务流程，三维狐少儿编程教务管理系统 V1.0 正式发布。本系统基于 ThinkPHP 和 FunAdmin 后台框架开发，采用 MySQL 数据库存储业务数据，围绕少儿编程培训机构的实际教务场景，设计并实现了一套较为完整的后台管理系统。
系统主要服务于培训机构管理员、教务人员和教师用户，可用于学生档案管理、试听体验课管理、续费报名管理、课程班级管理、课时记录、消课明细、调课补课停课、教师课时费统计、教师结算、费用预警、教案资料库、教具申请和校区联系簿等业务场景。
## 软件架构
本系统采用 B/S 架构设计，用户通过浏览器访问后台管理系统，服务器端负责业务逻辑处理和数据存储。
主要技术栈如下：
- 后端框架：ThinkPHP
- 后台框架：FunAdmin
- 数据库：MySQL 5.7
- Web 服务器：Nginx / Apache
- PHP 版本：PHP 8.1
- 前端技术：HTML、CSS、JavaScript、Layui
- 部署环境：Linux 服务器 / 宝塔面板
- 运行模式：浏览器 + Web 服务器 + PHP + MySQL
系统整体架构主要包括：
1. 表现层  
   负责后台页面展示、表单提交、数据列表展示和用户交互。
2. 控制层  
   负责接收用户请求，调用模型完成业务处理，并返回页面或 JSON 数据。
3. 业务层  
   负责学生管理、班级管理、课时消耗、教师结算、费用预警等核心业务逻辑。
4. 数据层  
   通过 MySQL 数据库存储学生、课程、班级、课时、费用、结算和系统权限等数据。
## 功能模块
系统 V1.0 版本主要包含以下功能模块：
### 1. 学生管理
- 学生档案维护
- 学号自动生成
- 学生姓名、联系方式、联系人维护
- 所属班级、所属课程管理
- 总课时、剩余课时管理
- 学生状态管理
- 学生信息查询与筛选
### 2. 试听体验课管理
- 意向学生试听登记
- 试听课程记录
- 试听班级记录
- 试听教师记录
- 试听结果维护
- 转化状态跟进
### 3. 续费报名管理
- 新报班记录
- 续费报名记录
- 转班升班记录
- 报名金额记录
- 赠送课时记录
- 支付状态管理
### 4. 课程管理
- 课程编号管理
- 课程名称管理
- 课程分类管理
- 总课时设置
- 课时单价设置
- 课程类型和难度等级维护
### 5. 班级管理
- 班级编号管理
- 班级名称维护
- 课程关联
- 教师关联
- 教室管理
- 最大人数和当前人数管理
- 上课星期和上课时间管理
- 总课时、已用课时、剩余课时统计
### 6. 课时管理
- 教师上课记录登记
- 班级课时记录
- 实际课时记录
- 请假学生记录
- 扣课模式设置
- 自动生成消课明细
### 7. 消课明细
- 学生每次上课扣课记录
- 到课和请假状态记录
- 学生剩余课时记录
- 消课历史查询
### 8. 学生异动
- 学生请假记录
- 调课记录
- 退费记录
- 赠课记录
- 学生状态变动追踪
### 9. 学生银行
- 学生积分账户管理
- 积分收入记录
- 积分支出记录
- 奖励和扣除记录
- 积分激励管理
### 10. 调课补课停课
- 调课申请
- 补课申请
- 停课记录
- 代课记录
- 顺延记录
- 审核和执行状态管理
### 11. 教师课时费
- 教师月度课时统计
- 课时单价设置
- 课时费金额计算
- 结算状态记录
### 12. 教师结算
- 教师结算单生成
- 应结课时统计
- 调整课时记录
- 应结金额计算
- 奖励和扣减金额记录
- 最终结算金额计算
- 教师结算明细追踪
### 13. 费用预警
- 剩余课时不足预警
- 欠费预警
- 长期未到课预警
- 预警等级设置
- 跟进状态维护
- 跟进备注记录
### 14. 教案资料库
- 教案资料上传
- 课程资料管理
- 文件路径记录
- 文件类型记录
- 下载次数统计
- 教学资源沉淀
### 15. 教具申请
- 教具申请提交
- 教具数量记录
- 用途说明
- 需求日期记录
- 审批状态管理
- 审批备注记录
### 16. 校区联系簿
- 校区联系人管理
- 联系人电话维护
- 邮箱维护
- 职务维护
- 备注信息管理
### 17. 教师个人数据隔离
- 管理员可查看全部数据
- 教师仅能查看自己负责班级的数据
- 教师仅能查看自己负责学生的数据
- 教师仅能查看自己相关课时和消课数据
- 提高系统数据安全性
## 安装教程
### 1. 环境要求
请确保服务器或本地环境满足以下要求：
- PHP >= 8.1
- MySQL >= 5.7
- Nginx / Apache
- Composer
- PHP 扩展：fileinfo、mbstring、openssl、pdo_mysql、curl、gd 等
- 推荐使用宝塔面板进行部署
### 2. 上传源码
将系统源码上传到服务器网站根目录，例如：
```text
/www/wwwroot/code.ygz.ink/
如果使用本地环境，也可以放置到本地 Web 运行目录中。

3. 配置运行目录
请将网站运行目录设置为项目的 public 目录。

例如宝塔面板中：

网站设置 -> 网站目录 -> 运行目录 -> /public
4. 导入数据库
在 MySQL 中创建数据库，例如：

CREATE DATABASE codecrms_ygz_ink DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
然后导入项目中的数据库文件：

codecrms_ygz_ink.sql
5. 修改数据库配置
根据实际数据库账号和密码，修改项目数据库配置文件。

常见配置位置可能为：

.env
或：

config/database.php
请配置以下内容：

数据库地址：127.0.0.1
数据库端口：3306
数据库名称：codecrms_ygz_ink
数据库用户：你的数据库用户名
数据库密码：你的数据库密码
6. 安装依赖
在项目根目录执行：

composer install
如果服务器无法执行 Composer，可以在本地安装依赖后再上传完整项目。

7. 设置伪静态
如果使用 Nginx，可参考 ThinkPHP 的伪静态配置：

location / {
    if (!-e $request_filename) {
        rewrite ^(.*)$ /index.php?s=$1 last;
        break;
    }
}
8. 设置目录权限
确保以下目录具有写入权限：

runtime
public/upload
Linux 环境下可执行：

chmod -R 755 runtime public/upload
9. 访问后台
部署完成后，在浏览器中访问系统后台地址：

http://你的域名/coding.php
例如：

http://code.ygz.ink/coding.php
使用说明
1. 登录系统
使用管理员账号登录系统后台，进入教务管理系统首页。
超级管理员账号：CODE
超级管理员密码：code12345678
登录后请及时修改账号和密码！！！

2. 初始化基础数据
建议按照以下顺序维护基础数据：

管理员和教师账号
课程信息
班级信息
学生信息
3. 日常教务管理流程
日常使用中，可按照以下流程进行教务管理：

在学生管理中维护学生档案；
在课程管理中维护课程基础信息；
在班级管理中创建教学班级；
在课时管理中录入教师每次授课记录；
系统根据课时记录生成消课明细；
通过费用预警跟进剩余课时不足或欠费学生；
在教师课时费和教师结算中完成教师课时统计和结算。
4. 教师账号使用
教师账号登录后，只能查看自己负责班级相关的数据，包括：

自己负责的班级
自己班级下的学生
自己相关的课时记录
自己相关的消课明细
自己相关的费用预警和课时统计
5. 数据维护建议
定期备份数据库；
修改系统前建议备份源码；
删除业务数据前请确认是否影响课时和结算统计；
教师结算前应先确认课时记录和消课明细是否准确。

默认访问地址
后台地址：http://你的域名/coding.php
如果部署在本地环境中，可访问：http://localhost/coding.php
数据库名称：codecrms_ygz_ink
主要业务表包括：
fun_student：学生信息表
fun_edu_course：课程信息表
fun_edu_class：班级信息表
fun_edu_class_hour：课时记录表
fun_edu_lesson_detail：消课明细表
fun_student_change：学生异动表
fun_student_bank：学生银行表
fun_schedule_adjust：调课补课停课表
fun_edu_teacher_hour：教师课时费表
fun_teacher_settlement：教师结算表
fun_teacher_settlement_detail：教师结算明细表
fun_fee_warning：费用预警表
fun_edu_teaching_plan：教案资料库表
fun_edu_teaching_aid：教具申请表
fun_campus_contact：校区联系簿表

## 版本说明
V1.0
当前版本为 V1.0，主要实现以下内容：

学生管理
试听体验课管理
续费报名管理
课程管理
班级管理
课时管理
消课明细
学生异动
学生银行
调课补课停课
教师课时费
教师结算
费用预警
教案资料库
教具申请
校区联系簿
教师个人数据隔离
后续计划
后续版本可继续扩展以下功能：

家长端查询
学生端查询
微信公众号通知
自动排课
在线缴费
数据统计报表
课时到期提醒
教师移动端
更多可视化统计图表
参与贡献
欢迎对本项目进行学习、交流和二次开发。

如有问题反馈、功能建议或合作交流，可通过以下方式联系：

邮箱：gouweicaosheji@163.com
QQ群：624600981
免责声明
本系统主要可用于商用、学习、研究和少儿编程培训机构教务管理场景实践。使用者在部署和二次开发过程中，应自行做好数据备份、权限控制和安全防护工作。

由于使用、修改或部署本系统造成的数据丢失、业务异常或其他问题，需由使用者自行承担相关责任。