# ATC数据处理系统 - 使用说明

## 🚀 系统启动

### 后端启动
```bash
cd 信息抽取+数据检验/Django123/atc_extractor
source venv_linux/bin/activate
cd backend
python manage.py runserver
```
后端运行在: http://127.0.0.1:8000/

### 前端启动
```bash
cd vue2
npm run serve
```
前端运行在: http://localhost:8080/

## 📋 功能说明

### 1. 控制台 (推荐使用)
- **地址**: http://localhost:8080/dashboard
- **功能**: 一站式数据处理和结果展示
- **特点**: 
  - 一键完整处理
  - 实时数据展示
  - 处理进度跟踪
  - 多步骤数据查看

### 2. 分步处理
- **地址**: http://localhost:8080/process
- **功能**: 逐步执行数据处理流程
- **步骤**:
  1. 文件上传
  2. 数据预处理
  3. 格式合并
  4. 单词纠错
  5. AI分析
  6. 数据验证
  7. 结果展示

### 3. 数据统计
- **地址**: http://localhost:8080/statistics
- **功能**: 数据可视化和统计分析

## 🔄 使用流程

### 快速使用 (推荐)
1. 打开控制台页面
2. 点击"重新上传"按钮
3. 上传CSV/Excel文件 (可使用测试文件: vue2/public/test_data.csv)
4. 点击"一键完整处理"
5. 等待处理完成
6. 查看各步骤处理结果

### 分步使用
1. 打开分步处理页面
2. 按步骤逐一执行:
   - 上传文件
   - 执行预处理
   - 执行格式合并
   - 执行单词纠错
   - 执行AI分析
   - 查看结果

## 📊 数据格式要求

### 输入文件格式
- **支持格式**: CSV, Excel (.xlsx, .xls)
- **必需列**: 
  - `id`: 记录唯一标识
  - `text`: ATC对话文本内容

### 示例数据
```csv
id,text
APP-001,"AT: China Eastern 123 climb FL350
PI: turn left direct WAYPOINT1 China Eastern 123"
APP-002,"AT: Lufthansa 456 descend FL280
PI: contact approach 119.1 Lufthansa 456"
```

## 🔧 API接口

### 核心接口
- `POST /api/upload/` - 文件上传
- `POST /api/complete-process/` - 一键完整处理
- `POST /api/process-data/` - 快速AI处理
- `GET /api/health/` - 系统健康检查

### 数据查询接口
- `GET /api/original-data/` - 原始数据
- `GET /api/preprocessed-data/` - 预处理结果
- `GET /api/merged-data/` - 格式合并结果
- `GET /api/corrected-data/` - 单词纠错结果
- `GET /api/processed-data/` - AI抽取结果
- `GET /api/final-data/` - 最终有效数据
- `GET /api/quarantine-data/` - 异常数据
- `GET /api/statistics/` - 处理统计

## 🎯 处理结果

### AI抽取字段
- **Call Sign**: 飞机呼号
- **Behavior**: 飞行行为 (climb, descend, turn等)
- **Flight Level**: 飞行高度
- **Location**: 位置信息
- **Time**: 时间信息

### 数据验证
- 有效数据存储在 `final_table`
- 异常数据存储在 `quarantine_table`
- 提供详细的验证统计信息

## ⚠️ 注意事项

1. **文件大小**: 建议单个文件不超过50MB
2. **处理时间**: 完整处理可能需要2-5分钟，请耐心等待
3. **网络连接**: 确保前后端网络连接正常
4. **浏览器兼容**: 推荐使用Chrome、Firefox等现代浏览器

## 🐛 常见问题

### 1. 上传失败
- 检查文件格式是否正确
- 确认后端服务是否正常运行
- 查看浏览器控制台错误信息

### 2. 处理超时
- 检查后端服务状态
- 减少数据量重试
- 查看后端日志

### 3. 数据显示异常
- 刷新页面重试
- 检查API接口响应
- 确认数据格式正确

## 📞 技术支持

如遇问题，请检查:
1. 后端服务状态: http://127.0.0.1:8000/api/health/
2. 前端控制台错误信息
3. 后端日志输出