启航教育课程管理系统

一、项目概述

启航教育 是一款面向教育培训机构的课程管理系统，采用现代化的技术栈，为用户提供课程报名、信息管理、智能客服等核心功能。本文将深入剖析该系统的技术架构与实现细节。

二、技术栈选择

层次	技术	版本	选型理由
后端框架	FastAPI	最新	高性能、自动文档、类型安全
ORM	SQLAlchemy	2.x	成熟稳定、灵活强大的数据库操作
数据库	MySQL	8.0+	高并发、成熟稳定、生态完善
前端	HTML/CSS/JS	-	轻量简洁、快速开发
AI 集成	Dify Workflow	-	低代码 AI 工作流平台

三、核心功能模块

3.1 用户认证模块

功能设计：

• 用户注册：账号唯一性校验
• 用户登录：账号密码验证
• 实名认证：身份证唯一性校验

数据库设计（zhmm 表）：

CREATE TABLE zhmm (
    id INT PRIMARY KEY AUTO_INCREMENT,
    account VARCHAR(50) UNIQUE NOT NULL,
    pwd VARCHAR(50) NOT NULL
);

关键实现：

@app.post("/reg")
def register(user: UserAuth, db: Session = Depends(get_db)):
    exist_user = db.query(User).filter(User.account == user.account).first()
    if exist_user:
        return {"code": 400, "msg": "账号已存在"}
    new_user = User(account=user.account, pwd=user.pwd)
    db.add(new_user)
    db.commit()
    return {"code": 200, "msg": "注册成功"}

3.2 课程管理模块

功能设计：

• 获取课程列表（GET）
• 报名课程（POST）
• 修改课程（PUT）
• 退出课程（DELETE）

数据库设计（courses 表）：

CREATE TABLE courses (
    id INT PRIMARY KEY AUTO_INCREMENT,
    name VARCHAR(50) COMMENT '课程名称',
    time VARCHAR(50) COMMENT '上课时间',
    place VARCHAR(50) COMMENT '上课地点',
    teacher VARCHAR(20) COMMENT '老师',
    price VARCHAR(20) COMMENT '费用',
    phone VARCHAR(20) COMMENT '电话'
);

RESTful API 设计：

方法	路由	功能	状态码
GET	/api/courses	获取课程列表	200
POST	/api/courses	报名课程	200
PUT	/api/courses/{id}	修改课程信息	200/404
DELETE	/api/courses/{id}	退出课程	200/404

3.3 AI 智能助手模块

架构设计：

前端请求 → /api/ai/workflow → Dify Workflow → AI 模型 → 返回响应

核心代码：

# api/ai.py
@app.post("/api/ai/workflow")
async def ai_workflow(query: dict):
    user_query = str(query.get("user_query", ""))
    response = await chapter_ai_workflow(user_query)
    return {"code": 200, "message": "success", "data": response}

3.4 实名认证模块

数据库设计（grxx 表）：

CREATE TABLE grxx (
    id INT PRIMARY KEY AUTO_INCREMENT,
    username VARCHAR(20) NOT NULL COMMENT '真实姓名',
    idcard VARCHAR(18) UNIQUE NOT NULL COMMENT '身份证号',
    gender VARCHAR(2) NOT NULL COMMENT '性别',
    age VARCHAR(3) NOT NULL COMMENT '年龄',
    phone VARCHAR(11) NOT NULL COMMENT '手机号'
);

四、技术亮点

4.1 FastAPI 优势

自动文档生成：启动服务后访问 /docs 即可获得交互式 API 文档。

依赖注入：

def get_db():
    db = SessionLocal()
    try:
        yield db
    finally:
        db.close()

类型安全：使用 Pydantic 模型进行参数校验，自动生成错误提示。

4.2 SQLAlchemy 2.x 新特性

采用 DeclarativeBase 替代旧版的 declarative_base：

class Base(DeclarativeBase):
    pass

4.3 前端简约风格设计

采用现代化的简约 UI 设计，统一的配色方案和交互体验：

• 清爽的白色背景
• 柔和的蓝色主色调
• 响应式布局
• 流畅的动画效果

五、项目流程图

六、部署与运行

6.1 环境要求

• Python 3.8+
• MySQL 8.0+
• 依赖包：fastapi, uvicorn, sqlalchemy, pymysql, requests

6.2 启动命令

# 安装依赖
pip install -r requirements.txt

# 启动服务
uvicorn main:app --host 0.0.0.0 --port 8000 --reload

七、总结与展望

7.1 项目价值

启航教育课程管理系统实现了教育机构核心业务的数字化管理，具有以下价值：

• 提升效率：自动化的课程管理流程
• 用户体验：简洁直观的操作界面
• 智能服务：AI 助手提供 24/7 在线支持
• 数据安全：完整的实名认证机制

7.2 未来规划

• 引入 JWT 身份认证
• 实现密码加密存储
• 添加课程分类筛选
• 集成邮件通知功能
• 开发移动端适配

---

项目地址：启航教育课程管理系统

如果您对该项目感兴趣，欢迎 Star 和 Fork！如有问题或建议，欢迎提交 Issue。