基于 Python Flask + Vue 3 + ECharts 构建的全栈气象数据可视化系统,覆盖实时天气、历史气候分析、机器学习预测、AI 预警助手,以及面向农业、能源、交通、海洋、医疗、旅游等 10+ 行业的垂直气象服务模块。
| 领域 | 模块 |
|---|---|
| 农业 | 农业气象、土壤墒情、物候遥感 |
| 能源 | 风电功率预测、光伏出力监测、电网负荷气象关联、微电网调度 |
| 交通 | 高速路况气象、航空终端气象、航海港口气象、低空飞行气象 |
| 灾害 | 台风追踪、洪涝模拟沙盘、森林火险监测、输电线路灾害预警、避难所路线规划 |
| 公共服务 | 医疗健康气象、旅游景区气象、生活指数助手、个人生活助手 |
| 环境 | 碳通量监测、雷达实况图层、卫星遥感图层、风切变雷达、结冰模型 |
| 平台 | 系统监控、开放 API 控制台、报告生成器、周报中心、公告管理 |
| 层级 | 技术 |
|---|---|
| 后端 | Python 3、Flask 3、Flask-SQLAlchemy、Flask-Migrate、Flask-CORS、APScheduler、scikit-learn、numpy、redis、reportlab、gunicorn |
| 前端 | Vue 3、Vue Router 4、Axios、ECharts 5、Three.js、Vite 7、html2canvas、jsPDF |
| 数据库 | SQLite(默认),支持 MySQL(含 ER 建模 SQL) |
| 数据源 | Open-Meteo(免费无 Key,默认)+ 和风天气 API(可选) |
| AI 能力 | OpenRouter / 通义千问等 OpenAI 兼容接口(多 LLM 容灾,无 Key 自动降级) |
| 部署 | Docker + docker-compose(后端 gunicorn + 前端 nginx + Redis) |
| CI | GitHub Actions(后端测试 + 前端构建 + E2E 冒烟 + Docker 镜像构建) |
.
├── backend/
│ ├── app.py # Flask 应用入口
│ ├── config.py # 配置管理
│ ├── models.py # SQLAlchemy 数据模型
│ ├── requirements.txt
│ ├── routes/ # 18 个 API 路由模块
│ │ ├── auth.py # 用户认证
│ │ ├── weather.py # 实时天气与预报
│ │ ├── climate.py # 气候大数据分析
│ │ ├── ml.py # 机器学习预测
│ │ ├── subscribe.py # 告警订阅
│ │ ├── disaster.py # 灾害应急
│ │ ├── emergency.py # 应急指挥
│ │ ├── agri.py # 农业气象
│ │ ├── energy.py # 能源气象
│ │ ├── traffic.py # 交通气象
│ │ ├── radar.py # 雷达实况
│ │ ├── report.py # 报告生成
│ │ ├── system.py # 系统监控
│ │ └── ...
│ ├── services/ # 50+ 业务服务
│ ├── tests/ # pytest 单元测试
│ ├── utils/ # 工具函数
│ ├── migrations/ # Flask-Migrate 迁移
│ └── data/ml_models/ # 训练好的 ML 模型
├── frontend/
│ ├── src/
│ │ ├── views/ # 50+ 页面组件
│ │ ├── components/ # 24 个通用组件
│ │ ├── api/ # API 封装
│ │ ├── router/ # 路由配置
│ │ └── main.js
│ └── vite.config.js
├── docs/ # 技术文档
├── .github/workflows/ # CI 配置
├── docker-compose.yml
└── README.mdcd backend
python -m venv .venv
.venv\Scripts\activate # Windows
# source .venv/bin/activate # Linux/macOS
pip install -r requirements.txt
copy .env.example .env编辑 backend/.env,填入可选的和风天气 Key 和大模型 Key(不填也能运行,自动使用 Open-Meteo 免费数据源和 AI 降级模式)。
python app.py后端运行在 http://127.0.0.1:5000。首次启动自动创建 SQLite 数据表,预置管理员账号:
username: admin
password: admin123cd frontend
npm install
npm run dev浏览器访问 http://127.0.0.1:5173。Vite 自动将 /api 请求代理到 Flask 后端。
docker compose up -d --build访问 http://localhost:8181(admin / admin123)。数据库持久化在 backend/weather.db,ML 模型与缓存在 backend-data 卷。
生产部署要点:
SCHEDULER_ENABLED=0(gunicorn gthread 4 worker×8 线程,长连接 SSE 不再占死 worker),由独立的 scheduler 单进程服务(python -m services.scheduler_worker)承担采集/告警/订阅评估/每日数据归档,Redis + 文件双 leader 锁保证只有一份在跑。weather_records 建立 (location_id, obs_time) 复合唯一索引,采集并发重复写入由约束兜底。WEATHER_RETENTION_DAYS 调整),Open-Meteo 历史回查数据也会落库沉淀为自有数据资产。flask --app app db upgrade(存量库应用迁移);全新库也可直接起服务(bootstrap_database 会 create_all + 预置 admin)。手动迁移:cd backend && flask --app app db upgrade。/api/system/health 探活数据库与 Redis;/api/system/metrics 输出 Prometheus 格式的 per-route 请求耗时指标。ALLOW_ADMIN_PASSWORD_RESET 生产环境保持 0(防止旧 scrypt 哈希被自动重置回默认密码)。SECRET_KEY、QWEATHER_API_KEY、OPENROUTER_API_KEY 等在 compose 环境或 .env 中提供。# 后端单元测试(196 个用例:鉴权契约/气候统计/订阅引擎/ML对齐/调度锁/限流回退等)
cd backend && .venv\Scripts\python -m pytest tests/ -q
# 前端 E2E 冒烟(需先启动后端和前端)
cd frontend && npm run test:e2e全部
/api/*接口默认需要登录(统一鉴权钩子),白名单与分级明细见 docs/security/api-auth-matrix.md (148 个方法×路径条目:public 6 / ApiKey 2 / login 134 / admin 6)。
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /api/auth/login | 用户登录 |
| GET | /api/auth/me | 当前用户信息 |
| GET | /api/weather/city/search?keyword=北京 | 城市搜索 |
| GET | /api/weather/now/:locationId | 实时天气 |
| GET | /api/weather/daily/:locationId?days=7 | 未来预报 |
| GET | /api/weather/chart/{line|bar|scatter|heatmap} | 图表数据 |
| GET | /api/weather/map-cities | 全国天气地图 |
| POST | /api/weather/alert/chat | AI 预警对话 |
| GET | /api/climate/overview | 气候态总览 |
| GET | /api/climate/extremes | 极端事件识别 |
| GET | /api/ml/forecast | ML 温度/降水预测 |
| GET | /api/ml/backtest | 模型回测指标 |
| POST | /api/subscribe | 创建告警订阅 |
| GET | /api/system/health | 系统健康检查 |
完整 API 文档运行后访问后端 /api/docs 或查看 docs/ 目录。
backend/.env.example 为 backend/.env,在本地填写自己的服务凭证气象数据来源于 Open-Meteo(默认,免费无需 Key)和和风天气(可选)。使用时请遵守对应服务条款。
版权所有 (c) 2026 QiuFeng1965,保留所有权利。未经书面授权,不得复制、修改、分发或用于商业用途。