mirror of
https://github.com/BigBodyCobain/Shadowbroker.git
synced 2026-05-28 10:01:31 +02:00
BigBodyCobain
19a8560a80
Three stacked filters meant the gps_jamming layer almost never lit up: 1. nac_p == 0 aircraft were dropped on the theory that "0 = old transponder." That's only half right — modern Mode-S Enhanced Surveillance transponders also fall back to nac_p=0 when they lose GPS lock entirely, which IS the jamming signature we want to catch. Discarding them was discarding the strongest signal. None (no field at all — typical for OpenSky-sourced records) is still skipped because absence-of-data isn't evidence. 2. GPS_JAMMING_MIN_AIRCRAFT was 5 per 1°x1° cell. Jamming hotspots (eastern Med, Russia/Ukraine border, Iran/Iraq) tend to have sparser traffic because pilots avoid them. Lowered to 3. 3. GPS_JAMMING_MIN_RATIO was 0.30. Combined with the (preserved) -1 noise cushion that made the effective bar high. Lowered to 0.20. The 1-aircraft noise cushion is intact so a single quirky transponder still can't flag a zone alone. Also extracted the detector loop into a pure ``detect_gps_jamming_zones()`` function at module scope so it's testable in isolation (was previously inlined inside ``_classify_and_publish``). The public signature accepts threshold overrides for ad-hoc re-tuning without code edits. 16 new tests cover nac_p=0 inclusion, None-skip preservation, MIN_AIRCRAFT lowering, MIN_RATIO lowering, noise cushion preservation, constant pinning, override behavior, lon/lng key compatibility, and robustness to empty/None inputs. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
40 lines
3.0 KiB
Python
40 lines
3.0 KiB
Python
# ─── ShadowBroker Backend Constants ──────────────────────────────────────────
|
|
# Centralized magic numbers. Import from here instead of hardcoding.
|
|
|
|
# ─── Flight Trails ──────────────────────────────────────────────────────────
|
|
FLIGHT_TRAIL_MAX_TRACKED = 2000 # Max concurrent tracked trails before LRU eviction
|
|
FLIGHT_TRAIL_POINTS_PER_FLIGHT = 200 # Max trail points kept per aircraft
|
|
TRACKED_TRAIL_TTL_S = 1800 # 30 min - trail TTL for tracked flights
|
|
DEFAULT_TRAIL_TTL_S = 300 # 5 min - trail TTL for non-tracked flights
|
|
|
|
# ─── Detection Thresholds ──────────────────────────────────────────────────
|
|
HOLD_PATTERN_DEGREES = 300 # Total heading change to flag holding pattern
|
|
GPS_JAMMING_NACP_THRESHOLD = 8 # NACp below this = degraded GPS signal
|
|
GPS_JAMMING_GRID_SIZE = 1.0 # 1 degree grid for aggregation
|
|
# Tuned 2026-05: previously 0.30 / 5 aircraft which — combined with the
|
|
# -1 noise cushion in the detector AND the pre-fix nac_p==0 filter that
|
|
# discarded jamming victims — meant the layer almost never lit up.
|
|
# Lowering the bar so genuine jamming zones with sparser ADS-B coverage
|
|
# clear (eastern Med, Russia/Ukraine border, Iran/Iraq).
|
|
GPS_JAMMING_MIN_RATIO = 0.20 # 20% degraded aircraft to flag zone
|
|
GPS_JAMMING_MIN_AIRCRAFT = 3 # Min aircraft in grid cell for statistical significance
|
|
|
|
# ─── Network & Circuit Breaker ──────────────────────────────────────────────
|
|
CIRCUIT_BREAKER_TTL_S = 120 # Skip domain for 2 min after total failure
|
|
DOMAIN_FAIL_TTL_S = 300 # Skip requests.get for 5 min, go straight to curl
|
|
CONNECT_TIMEOUT_S = 3 # Short connect timeout for fast firewall-block detection
|
|
|
|
# ─── Data Fetcher Intervals ────────────────────────────────────────────────
|
|
FAST_FETCH_INTERVAL_S = 60 # Flights, ships, satellites, military
|
|
SLOW_FETCH_INTERVAL_MIN = 30 # News, markets, space weather
|
|
CCTV_FETCH_INTERVAL_MIN = 1 # CCTV camera pipeline
|
|
LIVEUAMAP_FETCH_INTERVAL_HR = 12 # LiveUAMap scraper
|
|
|
|
# ─── External API ──────────────────────────────────────────────────────────
|
|
OPENSKY_RATE_LIMIT_S = 300 # Only re-fetch OpenSky every 5 minutes
|
|
OPENSKY_REQUEST_TIMEOUT_S = 15 # Timeout for OpenSky API calls
|
|
ROUTE_FETCH_TIMEOUT_S = 15 # Timeout for adsb.lol route lookups
|
|
|
|
# ─── Internet Outage Detection ─────────────────────────────────────────────
|
|
INTERNET_OUTAGE_MIN_SEVERITY = 0.10 # 10% drop minimum to show
|