# Data Visualization

**Repository Path**: teacher_lei/data-visualization

## Basic Information

- **Project Name**: Data Visualization
- **Description**: No description available
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-14
- **Last Updated**: 2026-07-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 云南高校专业数据可视化 —— 全栈开发实训项目

一个面向**有 Python 基础的学生**的全栈实训项目：以"云南高校专业数据"为场景，
完整演示「数据库 → 数据模型 → 服务层 → 接口 → 前端可视化」的全流程开发。

## 技术栈

| 层级 | 技术 |
|------|------|
| 数据库 | SQLite、pandas |
| 数据模型 | Pydantic |
| 业务逻辑 | pandas |
| 接口层 | FastAPI（APIRouter） |
| 主应用 | FastAPI、Jinja2、StaticFiles |
| 前端 | HTML / CSS / JS / ECharts |

## 快速开始

```bash
# 方式 A：默认 Python 环境
pip install fastapi uvicorn pandas

# 方式 B：Anaconda（推荐）
conda create -n yn-viz python=3.10 -y
conda activate yn-viz
pip install fastapi uvicorn pandas

# 生成数据库（只需一次）
python create_db.py

# 启动服务
uvicorn main:app --reload --host 127.0.0.1 --port 8000
# 首页：http://127.0.0.1:8000/   接口文档：http://127.0.0.1:8000/docs
```

> 注：本项目不强制使用 venv，推荐直接用默认 Python 或 Anaconda 环境。

## 配套实训教程

本仓库包含一套 8 章实训教程（讲义 + 练习 + 参考答案 + 可逐格运行的演示笔记本）：

👉 **[实训教程 / README.md](实训教程/README.md)**

| 章节 | 主题 |
|------|------|
| 第 1 章 | 项目概览与环境准备 |
| 第 2 章 | 数据库设计与数据准备 |
| 第 3 章 | 数据模型层（Pydantic） |
| 第 4 章 | 服务层与 pandas 数据分析 |
| 第 5 章 | 接口路由层（FastAPI） |
| 第 6 章 | 主应用与模板渲染 |
| 第 7 章 | 前端展示与 ECharts 可视化 |
| 第 8 章 | 项目运行与整合联调 |

## 目录结构

```
yunnan-uni-data-viz/
├── create_db.py / database.py / model.py   # 数据层
├── services/        # 业务逻辑
├── routers/         # 接口路由
├── main.py          # FastAPI 入口
├── templates/ static/   # 前端
├── yunnan_universities.db  # SQLite 数据库
└── 实训教程/        # 8 章讲义/练习/参考答案/演示笔记本
```