# student-crud-fullstack

**Repository Path**: glddy/student-crud-fullstack

## Basic Information

- **Project Name**: student-crud-fullstack
- **Description**: 一个使用 UniApp + Flask + SQLite 开发的学生信息管理系统，涵盖前后端开发, 支持学生信息的增删改查、搜索过滤。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 4
- **Created**: 2025-06-22
- **Last Updated**: 2025-09-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: uni-app, Flask, Sqlite

## README

# 🎓 学生信息管理系统 · Student CRUD System

基于 **UniApp + Flask + SQLite + Dify AI** 打造的前后端分离式学生信息管理平台，支持学生信息的 **增删改查、关键词搜索、编辑回填、智能分析** 等功能，页面美观，交互简洁，适用于教学管理、小型数据系统原型开发。

---

## 💡 技术栈

| 层级   | 技术              | 说明                                     |
|--------|-------------------|------------------------------------------|
| 前端   | UniApp + Vue3     | 多端兼容框架，使用 HBuilderX 开发        |
| 后端   | Flask              | Python 轻量级 Web 框架                   |
| ORM    | Peewee             | 简洁易用的 Python ORM                    |
| 数据库 | SQLite             | 嵌入式数据库，免部署，适合快速开发       |
| AI分析 | Dify + Qwen3 模型 | 联动 Dify 工作流，对学生信息智能处理     |
| 跨域   | Flask-CORS         | 实现前后端接口联通                       |

---

## 🌟 核心功能

- 🧾 学生信息管理：支持**添加、删除、修改、搜索、编辑回填**
- 🧠 智能分析引擎：调用 Dify + 大模型，分析学生数据表现
- 💡 前后端解耦：接口设计遵循 RESTful，逻辑清晰，可拓展性强
- 📦 纯本地部署：SQLite 数据存储，无需额外数据库配置
- 📱 页面简洁清新：学院风 UI，移动端适配良好

---

## 🧠 AI 智能分析功能

本系统集成了 [Dify](https://dify.ai/) 智能工作流，通过对学生信息进行一键分析，自动生成简洁清晰的总结性报告。  
基于大语言模型（如 Qwen3），帮助教师或管理员快速了解学生整体情况或个体表现，适合教育数据的轻量智能处理。


### 📌 使用流程：

- 点击「智能分析」按钮，系统自动将当前学生列表发送至 Dify 后台
- AI 自动分析并返回结果（如数据总结、建议、异常检测等）
- 页面通过弹窗展示分析报告，无需跳转页面


### 📤 请求结构：

```json
POST http://localhost:8080/v1/workflows/run
{
  "header": {
            "Content-Type": "application/json",
            "Authorization": "Bearer api密钥" 
          },
  "inputs": {
    "input": "[学生 JSON 数据字符串]"
  },
  "user": "test-user"
}
```

### 功能截图
| 工作流结构 | 结果展示 |
|---------|-----------|
| ![主界面](./frontend/static/workflow.png) | ![移动端](./frontend/static/result.png) |

---

## 📁 项目结构

```bash
student-crud-fullstack/
├── frontend-uniapp/         # 前端源码（HBuilderX 工程）
│   ├── pages/               # 页面视图
│   ├── components/          # 表单、列表等复用组件
│   ├── utils/               # 封装的 request 请求模块
│   ├── static/              # 静态资源（图标、截图等）
│   ├── App.vue              # 应用根组件
│   ├── main.js              # 启动入口
│   ├── pages.json           # 页面配置
│   └── manifest.json        # 应用平台配置
│
├── backend-flask/           # 后端服务
│   ├── app.py               # 主程序（包含接口定义）
│   ├── models.py            # 学生表模型定义（Peewee）
│   └── students.db          # 本地数据库（自动生成）
│
└── README.md                # 项目说明文档

```

---

## 🚀 快速开始

### 🧩 启动后端（Flask）

1. 安装依赖：
   ```bash
   pip install flask flask-cors peewee

2. 启动后端服务：
    ```bash
    python backend-flask/app.py

3. 服务地址
    ```bash
    http://localhost:5000/students

### 💻 启动前端（UniApp）
1. 使用 HBuilderX 打开 frontend-uniapp/ 文件夹

2. 点击运行 → 选择平台 → H5 模拟器 / 微信小程序等

3. 修改接口地址以匹配本地服务器（如：5000 端口）

---

## 📚 示例数据（预置）

系统默认预置以下两条学生信息：

| 学号          | 姓名 | 年龄 | 性别 | 专业       |
|---------------|------|------|------|------------|
| 202305571104  | 张三 | 18   | 男   | 通信工程   |
| 202305571166  | 李四 | 20   | 女   | 人工智能   |

---

## 📡 接口设计（RESTful）

| 方法   | 路径               | 功能         | 请求体示例                                   |
|--------|--------------------|--------------|----------------------------------------------|
| GET    | `/students`        | 获取所有学生 | 无                                           |
| POST   | `/students`        | 添加新学生   | `{ "sno": "202305571199", "name": "王五", "age": 19, "gender": "男", "major": "自动化" }` |
| PUT    | `/students/<id>`   | 修改学生信息 | 与 POST 相同，替换字段                       |
| DELETE | `/students/<id>`   | 删除学生信息 | 无                                           |

---

📷 页面展示（Screenshots）
| 功能界面 | 移动端适配 |
|---------|-----------|
| ![主界面](./frontend/static/main.png) | ![移动端](./frontend/static/mobile.png) |

---

📃 许可协议
本项目基于 MIT License 开源，欢迎学习与参考，但请注明来源。

---
💬 鸣谢与联系方式
如果你喜欢这个项目，欢迎点个 ⭐Star！
如有任何建议与问题，欢迎提 Issue 或联系作者。