-
${t('panels.spaceWatch','Space Watch')}
${t('badges.orbital','CELESTRAK')}
+
${t('panels.spaceWatch','Space Watch')}
${D.space ? `
New Objects (30d)${D.space.totalNewObjects||0}
Military Sats${D.space.militarySats||0}
@@ -953,7 +1014,7 @@ function plotMarkers(){
});
// === ISS + Space Stations (bright white, pulsing) ===
- (D.space?.stationPositions||[]).forEach(s=>{
+ if(spaceDisplayMode === 'icons') (D.space?.stationPositions||[]).forEach(s=>{
points.push({
lat:s.lat, lng:s.lon, size:0.4, alt:0.04,
color:'rgba(255,255,255,0.95)', type:'space', priority:1,
@@ -973,12 +1034,15 @@ function plotMarkers(){
});
});
- // Set points on globe
- globe.pointsData(points);
- globe.labelsData(labels);
-
// === ACLED CONFLICT EVENTS (pulsing rings) ===
- const conflictRings = (D.acled?.deadliestEvents || []).filter(e => e.lat && e.lon).map(e => {
+ const visiblePoints = points.filter(p => shouldShowType(p.type));
+ const visibleLabels = labels.filter(l => !l.type || shouldShowType(l.type));
+
+ // Set points on globe
+ globe.pointsData(visiblePoints);
+ globe.labelsData(visibleLabels);
+
+ const conflictRings = shouldShowType('conflict') ? (D.acled?.deadliestEvents || []).filter(e => e.lat && e.lon).map(e => {
const logFatal = Math.log2(Math.max(e.fatalities, 1));
return {
lat: e.lat, lng: e.lon,
@@ -988,12 +1052,12 @@ function plotMarkers(){
popHead: e.type || 'CONFLICT', popMeta: 'ACLED Conflict Data',
popText: `${e.fatalities} fatalities
${e.location}, ${e.country}
Date: ${e.date}`
};
- });
+ }) : [];
globe.ringsData(conflictRings);
// === FLIGHT CORRIDORS (3D arcs) ===
const arcs = [];
- if(flightsVisible){
+ if(flightsVisible && shouldShowType('air')){
const airCoordsFlight = [
{region:'Middle East',lat:30,lon:44}, {region:'Taiwan Strait',lat:24,lon:120},
{region:'Ukraine Region',lat:49,lon:32}, {region:'Baltic Region',lat:57,lon:24},
@@ -1040,6 +1104,17 @@ function plotMarkers(){
});
});
}
+ if(spaceDisplayMode === 'orbits' && shouldShowType('space')){
+ (D.space?.stationPositions||[]).forEach(s=>{
+ arcs.push({
+ startLat: Math.max(-65, s.lat - 18), startLng: s.lon - 80,
+ endLat: Math.min(65, s.lat + 18), endLng: s.lon + 80,
+ color: ['rgba(224,176,255,0.55)','rgba(224,176,255,0.12)'],
+ stroke: 0.7,
+ label: `${s.name} approximate orbital track`
+ });
+ });
+ }
globe.arcsData(arcs);
// Zoom-aware marker sizing: scale markers and labels with camera altitude
@@ -1055,11 +1130,11 @@ function plotMarkers(){
globe.arcDashAnimateTime(lowPerfMode ? 0 : 2000);
// Priority-based point visibility: hide low-priority markers when zoomed out
if(alt > 2.0){
- globe.pointsData(points.filter(p => (p.priority||3) <= 1));
+ globe.pointsData(visiblePoints.filter(p => (p.priority||3) <= 1));
} else if(alt > 1.2){
- globe.pointsData(points.filter(p => (p.priority||3) <= 2));
+ globe.pointsData(visiblePoints.filter(p => (p.priority||3) <= 2));
} else {
- globe.pointsData(points);
+ globe.pointsData(visiblePoints);
}
};
if(typeof globe.onZoom==='function') globe.onZoom(onGlobeZoom);
@@ -1178,7 +1253,7 @@ function initFlatMap(){
flatG.selectAll('.marker-circle').attr('r',function(){return +this.dataset.baseR/Math.sqrt(k)});
flatG.selectAll('.marker-label').style('font-size',Math.max(7,9/Math.sqrt(k))+'px')
.style('display',k>=2.5?'block':'none');
- });
+ }).on('end',()=>{ flatG.selectAll('.marker-label').style('display','block'); });
flatSvg.call(flatZoom);
drawFlatMap();
}
@@ -1197,7 +1272,8 @@ function drawFlatMap(){
function plotFlatMarkers(){
const mg=flatG.append('g').attr('class','markers');
const proj=flatProjection;
- const addPt=(lat,lon,r,fill,stroke,onClick,priority)=>{
+ const addPt=(lat,lon,r,fill,stroke,onClick,priority,type)=>{
+ if(type && !shouldShowType(type)) return null;
const[x,y]=proj([lon,lat]);if(!x||!y)return null;
const g=mg.append('g').attr('transform',`translate(${x},${y})`).style('cursor','pointer').attr('data-priority',priority||3);
if(onClick) g.on('click',ev=>{ev.stopPropagation();onClick(ev)});
@@ -1215,12 +1291,12 @@ function plotFlatMarkers(){
});
}
// Thermal
- D.thermal.forEach(t=>t.fires.forEach(f=>{
+ if(shouldShowType('thermal')) D.thermal.forEach(t=>t.fires.forEach(f=>{
addPt(f.lat,f.lon,2+Math.min(f.frp/50,5),'rgba(255,95,99,0.6)','rgba(255,95,99,0.2)',
ev=>showPopup(ev,'Thermal',`${t.region}
FRP: ${f.frp.toFixed(1)} MW`,'FIRMS'),3);
}));
// Chokepoints
- D.chokepoints.forEach(cp=>{
+ if(shouldShowType('maritime')) D.chokepoints.forEach(cp=>{
const[x,y]=proj([cp.lon,cp.lat]);if(!x||!y)return;
const g=mg.append('g').attr('transform',`translate(${x},${y})`).style('cursor','pointer').attr('data-priority',1)
.on('click',ev=>{ev.stopPropagation();showPopup(ev,cp.label,cp.note,'Maritime')});
@@ -1229,30 +1305,30 @@ function plotFlatMarkers(){
});
// Nuclear
const nukeCoords=[{lat:47.5,lon:34.6},{lat:51.4,lon:30.1},{lat:28.8,lon:50.9},{lat:39.8,lon:125.8},{lat:37.4,lon:141},{lat:31.0,lon:35.1}];
- D.nuke.forEach((n,i)=>{const c=nukeCoords[i];if(!c)return;addPt(c.lat,c.lon,4,'rgba(255,224,130,0.7)','rgba(255,224,130,0.3)',ev=>showPopup(ev,n.site,`CPM: ${n.cpm?.toFixed(1)||'--'}`,'Radiation'),2)});
+ if(shouldShowType('nuke')) D.nuke.forEach((n,i)=>{const c=nukeCoords[i];if(!c)return;addPt(c.lat,c.lon,4,'rgba(255,224,130,0.7)','rgba(255,224,130,0.3)',ev=>showPopup(ev,n.site,`CPM: ${n.cpm?.toFixed(1)||'--'}`,'Radiation'),2)});
// SDR
- D.sdr.zones.forEach(z=>z.receivers.forEach(r=>{addPt(r.lat,r.lon,2.5,'rgba(68,204,255,0.5)','rgba(68,204,255,0.2)',ev=>showPopup(ev,'SDR',`${r.name}
${z.region}`,'KiwiSDR'),3)}));
+ if(shouldShowType('sdr')) D.sdr.zones.forEach(z=>z.receivers.forEach(r=>{addPt(r.lat,r.lon,2.5,'rgba(68,204,255,0.5)','rgba(68,204,255,0.2)',ev=>showPopup(ev,'SDR',`${r.name}
${z.region}`,'KiwiSDR'),3)}));
// OSINT
const osintGeo=[{lat:45,lon:41,idx:0},{lat:48,lon:37,idx:1},{lat:48.5,lon:37.5,idx:2},{lat:45,lon:40.2,idx:3},{lat:50.6,lon:36.6,idx:5},{lat:48.5,lon:35,idx:6}];
- osintGeo.forEach(o=>{const p=D.tg.urgent[o.idx];if(!p)return;addPt(o.lat,o.lon,4,'rgba(255,184,76,0.7)','rgba(255,184,76,0.3)',ev=>showPopup(ev,(p.channel||'').toUpperCase(),cleanText(p.text?.substring(0,200)||''),`${p.views||'?'} views`),2)});
+ if(shouldShowType('osint')) osintGeo.forEach(o=>{const p=D.tg.urgent[o.idx];if(!p)return;addPt(o.lat,o.lon,4,'rgba(255,184,76,0.7)','rgba(255,184,76,0.3)',ev=>showPopup(ev,(p.channel||'').toUpperCase(),cleanText(p.text?.substring(0,200)||''),`${p.views||'?'} views`),2)});
// WHO
const whoGeo=[{lat:0.3,lon:32.6},{lat:-6.2,lon:106.8},{lat:-4.3,lon:15.3},{lat:35,lon:105},{lat:12.5,lon:105},{lat:35,lon:105},{lat:28,lon:84},{lat:24,lon:45},{lat:30,lon:70},{lat:-0.8,lon:11.6}];
- D.who.slice(0,10).forEach((w,i)=>{const c=whoGeo[i];if(!c)return;addPt(c.lat,c.lon,3.5,'rgba(105,240,174,0.6)','rgba(105,240,174,0.2)',ev=>showPopup(ev,w.title,w.summary||'','WHO'),2)});
+ if(shouldShowType('health')) D.who.slice(0,10).forEach((w,i)=>{const c=whoGeo[i];if(!c)return;addPt(c.lat,c.lon,3.5,'rgba(105,240,174,0.6)','rgba(105,240,174,0.2)',ev=>showPopup(ev,w.title,w.summary||'','WHO'),2)});
// News
- (D.news||[]).forEach(n=>{addPt(n.lat,n.lon,3,'rgba(129,212,250,0.6)','rgba(129,212,250,0.2)',ev=>showPopup(ev,n.source+' NEWS',cleanText(n.title),n.region),3)});
+ if(shouldShowType('news')) (D.news||[]).forEach(n=>{addPt(n.lat,n.lon,3,'rgba(129,212,250,0.6)','rgba(129,212,250,0.2)',ev=>showPopup(ev,n.source+' NEWS',cleanText(n.title),n.region),3)});
// NOAA weather
- (D.noaa?.alerts||[]).forEach(a=>{addPt(a.lat,a.lon,4,'rgba(255,152,0,0.7)','rgba(255,152,0,0.3)',ev=>showPopup(ev,a.event,a.headline||'','NOAA/NWS'),2)});
+ if(shouldShowType('weather')) (D.noaa?.alerts||[]).forEach(a=>{addPt(a.lat,a.lon,4,'rgba(255,152,0,0.7)','rgba(255,152,0,0.3)',ev=>showPopup(ev,a.event,a.headline||'','NOAA/NWS'),2)});
// EPA RadNet
- (D.epa?.stations||[]).forEach(s=>{addPt(s.lat,s.lon,3,'rgba(205,220,57,0.6)','rgba(205,220,57,0.2)',ev=>showPopup(ev,'RadNet: '+s.location,`${s.analyte||'--'}: ${s.result||'--'} ${s.unit||''}`,'EPA'),3)});
+ if(shouldShowType('environment')) (D.epa?.stations||[]).forEach(s=>{addPt(s.lat,s.lon,3,'rgba(205,220,57,0.6)','rgba(205,220,57,0.2)',ev=>showPopup(ev,'RadNet: '+s.location,`${s.analyte||'--'}: ${s.result||'--'} ${s.unit||''}`,'EPA'),3)});
// Space stations
- (D.space?.stationPositions||[]).forEach(s=>{
+ if(spaceDisplayMode === 'icons' && shouldShowType('space')) (D.space?.stationPositions||[]).forEach(s=>{
const g=addPt(s.lat,s.lon,5,'rgba(255,255,255,0.9)','rgba(255,255,255,0.4)',ev=>showPopup(ev,s.name,'Orbital position estimate','Space Station'),1);
if(g) g.append('text').attr('class','marker-label').attr('x',8).attr('y',3).attr('fill','rgba(255,255,255,0.7)').attr('font-size','8px').attr('font-family','var(--mono)').text(s.name.split('(')[0].trim());
});
// GDELT geo events
- (D.gdelt?.geoPoints||[]).forEach(g=>{addPt(g.lat,g.lon,2.5,'rgba(100,149,237,0.5)','rgba(100,149,237,0.2)',ev=>showPopup(ev,'GDELT Event',g.name||'','GDELT · '+g.count+' reports'),3)});
+ if(shouldShowType('gdelt')) (D.gdelt?.geoPoints||[]).forEach(g=>{addPt(g.lat,g.lon,2.5,'rgba(100,149,237,0.5)','rgba(100,149,237,0.2)',ev=>showPopup(ev,'GDELT Event',g.name||'','GDELT · '+g.count+' reports'),3)});
// ACLED
- (D.acled?.deadliestEvents||[]).filter(e=>e.lat&&e.lon).forEach(e=>{
+ if(shouldShowType('conflict')) (D.acled?.deadliestEvents||[]).filter(e=>e.lat&&e.lon).forEach(e=>{
const[x,y]=proj([e.lon,e.lat]);if(!x||!y)return;
const r=Math.max(4,Math.min(14,2+Math.log2(Math.max(e.fatalities,1))*1.5));
const g=mg.append('g').attr('transform',`translate(${x},${y})`).style('cursor','pointer').attr('data-priority',1)
@@ -1261,7 +1337,7 @@ function plotFlatMarkers(){
g.append('circle').attr('r',r*0.4).attr('fill','rgba(255,120,80,0.3)');
});
// Flight corridors
- if(flightsVisible){
+ if(flightsVisible && shouldShowType('air')){
const airCoordsFlight=[{lat:30,lon:44},{lat:24,lon:120},{lat:49,lon:32},{lat:57,lon:24},{lat:14,lon:114},{lat:37,lon:127},{lat:25,lon:-80},{lat:4,lon:2},{lat:-34,lon:18},{lat:10,lon:51}];
const hubs=[{lat:40.6,lon:-73.8},{lat:51.5,lon:-0.5},{lat:25.3,lon:55.4},{lat:1.4,lon:103.8},{lat:-33.9,lon:151.2},{lat:-23.4,lon:-46.5}];
const cG=flatG.append('g').attr('class','corridors-layer');
diff --git a/docs/sources/README.md b/docs/sources/README.md
new file mode 100644
index 0000000..008b1f5
--- /dev/null
+++ b/docs/sources/README.md
@@ -0,0 +1,18 @@
+# Source Operations
+
+Each source should fail visibly and safely. A missing key or remote outage must produce `degraded` source health instead of silent demo data.
+
+Check runtime state:
+
+```bash
+curl http://localhost:3117/api/health
+curl http://localhost:3117/api/metrics
+```
+
+Source docs:
+
+- [OpenSky](opensky.md)
+- [ACLED](acled.md)
+- [Telegram](telegram.md)
+- [FIRMS](firms.md)
+- [Maritime](maritime.md)
diff --git a/docs/sources/acled.md b/docs/sources/acled.md
new file mode 100644
index 0000000..c6ba1fb
--- /dev/null
+++ b/docs/sources/acled.md
@@ -0,0 +1,9 @@
+# ACLED
+
+Provides conflict events, fatalities, event types, and locations.
+
+- Auth: `ACLED_EMAIL` and `ACLED_PASSWORD`.
+- Flow: OAuth password grant is tried first, then cookie session fallback.
+- Failure modes: missing credentials, terms/profile not completed, expired token, account missing API access.
+- Behavior: missing or rejected credentials produce degraded source health with the ACLED error text.
+- Test: set credentials, run `node apis/sources/acled.mjs`, then check `/api/health`.
diff --git a/docs/sources/firms.md b/docs/sources/firms.md
new file mode 100644
index 0000000..c315972
--- /dev/null
+++ b/docs/sources/firms.md
@@ -0,0 +1,8 @@
+# FIRMS
+
+Provides NASA satellite fire and thermal detections.
+
+- Auth: `FIRMS_MAP_KEY` recommended.
+- Failure modes: missing key, timeout, regional API throttle.
+- Behavior: source health reports degraded or failed; dashboard panels stay visible and show available sources.
+- Test: set `FIRMS_MAP_KEY`, run a sweep, inspect thermal markers and `/api/metrics`.
diff --git a/docs/sources/maritime.md b/docs/sources/maritime.md
new file mode 100644
index 0000000..e8eafcb
--- /dev/null
+++ b/docs/sources/maritime.md
@@ -0,0 +1,8 @@
+# Maritime
+
+Provides chokepoint context and optional AIS-related maritime data.
+
+- Auth: `AISSTREAM_API_KEY` enables richer AIS behavior where supported.
+- Failure modes: missing key, remote stream unavailable, no vessels in a monitored region.
+- Behavior: static chokepoint context remains available, live source health reports degraded when remote data is unavailable.
+- Test: run a sweep and inspect maritime markers, source health, and network metrics.
diff --git a/docs/sources/opensky.md b/docs/sources/opensky.md
new file mode 100644
index 0000000..19ee63f
--- /dev/null
+++ b/docs/sources/opensky.md
@@ -0,0 +1,9 @@
+# OpenSky
+
+Provides public aircraft state data for regional air-activity hotspots.
+
+- Auth: public queries work without credentials.
+- Failure modes: timeouts, `HTTP 429`, and empty regions.
+- Behavior: source health is marked degraded on API errors. The dashboard may use the most recent non-empty air snapshot from `runs/` and marks it in `airMeta.fallback`.
+- Test: start a sweep and inspect `/api/health` plus `airMeta` from `/api/data`.
+- Operator note: Crucix does not bypass OpenSky throttles. Increase `REFRESH_INTERVAL_MINUTES` if the source degrades repeatedly.
diff --git a/docs/sources/telegram.md b/docs/sources/telegram.md
new file mode 100644
index 0000000..ccb050f
--- /dev/null
+++ b/docs/sources/telegram.md
@@ -0,0 +1,9 @@
+# Telegram
+
+Provides OSINT posts and bot commands/alerts.
+
+- Source collection uses configured public/channel inputs where available.
+- Bot alerts require `TELEGRAM_BOT_TOKEN` and `TELEGRAM_CHAT_ID`.
+- Polling failures are non-fatal and use backoff logging to avoid log spam.
+- `/brief` includes source integrity, evidence links, event id, why-it-matters, and next-step context.
+- Test: configure bot variables, start the container, send `/status` and `/brief`.