# school_db

**Repository Path**: caolonghao/school_db

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-12
- **Last Updated**: 2026-06-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 高校AI试验区数据库管理平台

## 项目概述

这是一个完整的AI智能数据库管理平台，用于展示"高校AI试验区完整数据库"的建设成果。

## 技术架构

### 前端
- **框架**: React + TypeScript
- **样式**: Tailwind CSS
- **状态管理**: Zustand
- **数据缓存**: React Query
- **图表**: Recharts + ECharts
- **UI组件**: Lucide React

### 后端
- **框架**: FastAPI (Python)
- **数据库**: PostgreSQL
- **缓存**: Redis
- **全文检索**: ElasticSearch
- **实时通信**: WebSocket
- **AI集成**: OpenAI / Claude / Deepseek

## 项目结构

```
school_db/
├── dashboard/              # 前端应用
│   ├── src/
│   │   ├── api/           # API服务和hooks
│   │   ├── components/    # 可复用组件
│   │   ├── data/         # 演示数据
│   │   ├── pages/        # 页面组件
│   │   ├── providers/    # React Query Provider
│   │   ├── store/        # Zustand状态管理
│   │   └── types/        # TypeScript类型定义
│   ├── package.json
│   └── vite.config.ts
│
├── backend/               # 后端应用
│   ├── app/
│   │   ├── ai/          # AI Agent
│   │   ├── connections/ # 数据库连接
│   │   ├── models/      # SQLAlchemy模型
│   │   ├── routers/     # API路由
│   │   ├── schemas/     # Pydantic模式
│   │   ├── websocket/   # WebSocket管理
│   │   ├── main.py      # FastAPI主应用
│   │   └── init_data.py # 数据初始化
│   ├── docker-compose.yml
│   ├── Dockerfile
│   ├── requirements.txt
│   └── .env
│
├── database_backup.json   # 数据备份
└── README.md             # 项目说明
```

## 快速开始

### 前端启动

```bash
cd dashboard
npm install
npm run dev
```

前端将运行在 http://localhost:3000

### 后端启动（使用Docker）

```bash
cd backend

# 启动所有服务（PostgreSQL, Redis, ElasticSearch, FastAPI）
docker compose up -d

# 初始化数据
docker exec -it school_db_backend python -m app.init_data
```

后端API将运行在 http://localhost:8000

### 手动启动后端（不使用Docker）

```bash
cd backend
pip install -r requirements.txt

# 配置环境变量
cp .env.example .env
# 编辑.env文件填入数据库配置

# 运行服务
uvicorn app.main:app --reload
```

## 数据说明

### 数据来源

1. **高校基础信息**: 来源于教育部公布的"双一流"建设高校名单
2. **AI试验区信息**: 来源于科技部官网公布的国家新一代人工智能创新发展试验区批复文件
3. **年度科研数据**: 【待补充】需从专利数据库（IncoPat、智慧芽）和学术数据库（CNKI、Web of Science）获取
4. **趋势分析数据**: 【待补充】需从教育统计年鉴获取

### 数据文件

- `database_backup.json`: 完整的数据库备份（JSON格式）
- `universities_backup.csv`: 高校数据导出（CSV格式）

### 数据规范

- ✅ 真实数据：明确标注数据来源
- ⚠️ 待补充数据：标注【数据待补充】
- 🔄 模拟数据：标注【模拟数据】，仅供演示

## 功能模块

1. **数据总览**: 统计卡片、AI分析、趋势图表
2. **高校管理**: 高校列表、搜索筛选、详情查看
3. **智能分析**: 指标选择、趋势分析、对比分析
4. **数据检索**: 全文搜索、高级筛选、结果导出
5. **系统设置**: 通用设置、外观设置、通知设置

## API接口

### 高校管理
- `GET /universities` - 获取所有高校
- `GET /universities/{id}` - 获取单个高校
- `POST /universities` - 创建高校
- `PUT /universities/{id}` - 更新高校
- `DELETE /universities/{id}` - 删除高校

### 年度数据
- `GET /year-data` - 获取所有年度数据
- `GET /year-data/university/{id}` - 获取高校年度数据
- `GET /year-data/year/{year}` - 获取指定年份数据

### 统计分析
- `GET /stats/summary` - 统计摘要
- `GET /stats/trend` - 趋势数据
- `GET /stats/policy-effect` - 政策效应

### AI分析
- `GET /ai-analysis` - 获取分析结果
- `POST /ai-analysis/analyze` - 执行AI分析
- `POST /ai-analysis/query` - AI问答查询

### 数据检索
- `POST /search` - 全文搜索
- `POST /search/advanced` - 高级搜索

## WebSocket

WebSocket端点: `ws://localhost:8000/ws/{client_id}`

用于实时消息推送和数据更新。

## 环境变量配置

### 后端 (.env)

```env
DATABASE_URL=postgresql+asyncpg://postgres:password@localhost:5432/school_db
REDIS_URL=redis://localhost:6379/0
ELASTICSEARCH_URL=http://localhost:9200
API_HOST=0.0.0.0
API_PORT=8000
SECRET_KEY=your-secret-key

OPENAI_API_KEY=your-openai-api-key
ANTHROPIC_API_KEY=your-anthropic-api-key
DEEPSEEK_API_KEY=your-deepseek-api-key

ALLOWED_ORIGINS=http://localhost:3000
```

## 开发说明

### 前端开发
- 使用Vite作为构建工具
- 使用TypeScript确保类型安全
- 使用Tailwind CSS实现响应式设计
- 使用Recharts和ECharts实现数据可视化

### 后端开发
- 使用FastAPI实现高性能API
- 使用SQLAlchemy实现ORM
- 使用Redis实现缓存
- 使用ElasticSearch实现全文检索
- 使用WebSocket实现实时通信

## 许可证

MIT License

## 联系方式

如有问题，请联系开发团队。

## 版本历史

- v1.0.0 (2026-06-13): 初始版本
  - 完成前端Dashboard开发
  - 完成后端API开发
  - 完成Docker Compose配置
  - 完成AI Agent集成