d3mocide/Vertex
GitHub: d3mocide/Vertex
本地优先的多源态势感知仪表盘，将航空、船舶、无线电、天气和交通等信号整合到统一的暗色战术地图界面中。
Stars: 0 | Forks: 0
**实时态势感知。本地优先。无需云端。**
本地情报工具 [Sovereign Watch](https://github.com/d3mocide/Sovereign_Watch) 家族的一部分。
## // 00 · 概述
Vertex 将航空、船舶、交通、天气、警报、无线电和社区信息流整合到一个以地图为中心的仪表盘中，旨在您控制的硬件上运行。黑玛瑙风格的界面、琥珀金色的信号高亮以及去饱和的战术地图，使您的注意力始终集中在最重要的地方——数据本身。
```
DOMAIN · PUBLIC SAFETY DENSITY · HIGH / DATA-FIRST
THEME · DARK ONLY RADIUS · 0px / ALL
```
## // 01 · 架构
五个容器。一个 Compose 文件。
| 容器 | 角色 | 入口点 |
|-----------|------|-------------|
| `db` | PostgreSQL 16 + PostGIS 3.4 | `db/` 初始化脚本 |
| `redis` | 状态缓存 + 发布/订阅事件总线 | 原始镜像 |
| `backend` | FastAPI REST + WebSocket API | `backend/main.py` |
| `poller` | 9 个异步后台轮询器 | `poller/main.py` |
| `frontend` | React + MapLibre GL，由 Nginx 提供服务 | `frontend/src/main.tsx` |
```
External APIs / SDR hardware
↓
poller (9 async tasks)
↓ bulk INSERT
PostgreSQL ← PostGIS geofence queries
↓ Redis pub/sub
backend WebSocket /ws
↓ JSON events
frontend Zustand → Deck.gl → MapLibre GL
```
## // 02 · 数据源
| 信号 | 颜色 | 来源 |
|--------|-------|--------|
| 航空器 (ADS-B) | `#00BFFF` 青色 | OpenSky · 本地 Ultrafeeder |
| 船舶 (AIS) | `#00C853` 绿色 | AISstream.io · 本地 AIS-catcher |
| P25 无线电 | `#FF8F00` 琥珀色 | OP25 集群无线电 |
| 紧急事件 | `#C62828` 红色 | NWS 警报 · FlashAlert · 县紧急管理 |
| 交通 | `#FFB800` 金色 | ODOT TripCheck |
| Mesh | `#FFB800` 金色 | MeshCore 节点 |
## // 03 · 快速开始
```
cp .env.example .env
cp config/sources.example.yml config/sources.yml
# 使用你的 region、API keys 和 data sources 编辑 .env
$EDITOR .env
docker compose up -d
```
打开 `http://localhost`。有关详细的设置，请参阅 [docs/getting-started.md](docs/getting-started.md)。
## // 04 · 支持的集成
- **ADS-B** — Ultrafeeder（本地）或 OpenSky Network（云端备用）
- **AIS** — AIS-catcher（本地）或 AISstream.io（云端备用）
- **P25** — OP25 集群无线电解码器（本地 SDR）
- **Mesh** — 通过 WebSocket 跟踪 MeshCore 节点
- **天气** — NWS 观测和警报区域
- **交通** — ODOT TripCheck 事件和摄像头流
- **警报** — FlashAlert 和县紧急管理 RSS
## // 05 · 文档
| 文档 | 描述 |
|----------|-------------|
| [入门指南](docs/getting-started.md) | 安装、配置与首次运行 |
| [架构概览](docs/architecture/overview.md) | 服务布局与数据流 |
| [功能概览](docs/features/overview.md) | 仪表盘功能与面板 |
| [环境变量配置](docs/configuration/environment.md) | `.env` 变量参考 |
| [数据源配置](docs/configuration/sources.md) | `sources.yml` 参考 |
## // 06 · 许可证
GPL-3.0 — 详见 [LICENSE](LICENSE)。
标签：AV绕过, Deck.gl, Docker Compose, ESC4, FastAPI, GIS, HTTP/HTTPS抓包, MapLibre GL, Nginx, OSINT, PostGIS, PostgreSQL, Raspberry Pi, React, Redis, SDR, Syscalls, WebSocket, Zustand, 交通监控, 仪表盘, 传感器数据, 依赖分析, 公共安全, 内存执行, 地图可视化, 地理信息系统, 异步轮询, 态势感知, 情报收集, 战术地图, 搜索引擎查询, 数据融合, 无云架构, 本地部署, 气象数据, 测试用例, 漏洞研究, 版权保护, 物联网, 社区警报, 离线优先, 空间数据库, 自动化攻击, 航空监控, 船舶追踪, 软件定义无线电, 边缘计算, 逆向工具