SIGINT

लाइव विमान, जहाज, भूकंपीय, आग, मौसम और घटना ट्रैकिंग के साथ रीयल-टाइम OSINT डैशबोर्ड, एक इंटरैक्टिव ग्लोब पर। Bun, React 19, और कस्टम Canvas 2D + Web Worker रेंडरिंग इंजन के साथ निर्मित। PWA के रूप में स्थापित करने योग्य।

स्क्रीनशॉट

विषय सूची

• SIGINT
  • स्क्रीनशॉट
  • विषय सूची
  • विशेषताएँ
    • लाइव डेटा
    • खुफिया
    • विज़ुअलाइज़ेशन
    • प्लेटफॉर्म
  • स्थापना
  • त्वरित आरंभ
  • पर्यावरण चर
  • डेटा स्रोत
  • परीक्षण
  • परिनियोजन
    • विकास
    • उत्पादन
    • TLS के साथ उत्पादन
    • Heroku
    • सफाई
  • PWA
  • दस्तावेज़ीकरण
  • लाइसेंस
  • लेखक

विशेषताएँ

लाइव डेटा

• विमान ट्रैकिंग (adsb.fi)
• AIS जहाज ट्रैकिंग (aisstream.io)
• भूकंपीय निगरानी (USGS)
• आग हॉटस्पॉट का पता लगाना (NASA FIRMS)
• गंभीर मौसम अलर्ट (NOAA)
• GDELT घटना खुफिया
• RSS समाचार एकत्रीकरण (6 वैश्विक स्रोत)
• HLS वीडियो फीड (iptv-org)

खुफिया

• क्रॉस-सोर्स उत्पादों और स्कोर किए गए अलर्ट के साथ सहसंबंध इंजन
• सैन्य विमान वर्गीकरण
• वॉच मोड (स्वचालित ग्लोब टूर)
• तस्वीरों, मार्गों, मेटाडेटा के साथ एंटिटी डोजियर

विज़ुअलाइज़ेशन

• ग्लोब और फ्लैट मैप प्रोजेक्शन
• ड्रैग, मिनिमाइज़, प्रीसेट के साथ मल्टी-पेन रिसाइज़ेबल लेआउट
• कैमरा लॉक-ऑन, आइसोलेशन मोड, ट्रेल रेंडरिंग
• लाइव ग्लोब फ़िल्टरिंग के साथ वैश्विक खोज
• वर्चुअल-स्क्रॉलिंग डेटा तालिका
• लाइव टिकर फीड

प्लेटफॉर्म

• डार्क/लाइट थीम
• अलग लेआउट प्रीसेट के साथ मोबाइल रिस्पॉन्सिव
• ऑफ़लाइन समर्थन, अपडेट सूचनाएं, पुल-टू-रिफ्रेश के साथ PWA
• कनेक्टिविटी डिटेक्शन के साथ ऑफ़लाइन संकेतक
• कुकी-प्रमाणित API (HMAC-SHA256, HttpOnly)

स्थापना

git clone https://github.com/iitoneloc/sigint.git
cd sigint
bun install

प्रोजेक्ट रूट में कम से कम निम्नलिखित के साथ एक .env फ़ाइल बनाएं:

SIGINT_SERVER_SECRET=<openssl rand -hex 32 का आउटपुट>

वैकल्पिक रूप से जहाज और आग डेटा के लिए कुंजियाँ जोड़ें:

AISSTREAM_API_KEY=<आपकी aisstream.io कुंजी>
FIRMS_MAP_KEY=<आपकी NASA FIRMS कुंजी>

त्वरित आरंभ

विकास, उत्पादन और Heroku विकल्पों के लिए परिनियोजन देखें।

पर्यावरण चर

डेटा स्रोत

परीक्षण

bun test            # सभी परीक्षण चलाएं
bun test --watch    # वॉच मोड
bun run docker:test # Docker में चलाएं

परिनियोजन

विकास

bun run docker:dev:up          # https://localhost (स्व-हस्ताक्षरित प्रमाणपत्र)
bun run docker:dev:down        # रोकें

केवल विकास-फिक्सचर ओवरराइड

दो env vars विकास में लाइव डेटा फ़ेच को शॉर्ट-सर्किट करते हैं ताकि आप ज्ञात निश्चित स्थिति पर काम कर सकें। दोनों NODE_ENV !== "production" पर गेटेड हैं और उत्पादन बिल्ड में अनदेखा किए जाते हैं।

लेबल /^[a-z0-9-]+$/ से मेल खाते हैं (OWASP A01 — किसी भी फ़ाइल लुकअप से पहले सख्त अनुमति सूची) और tests/fixtures/<source>/<label>.json पर रिज़ॉल्व होते हैं। अमान्य लेबल स्टार्टअप पर फेंकते हैं; गुम फ़ाइलें रिज़ॉल्व किए गए पथ के साथ फेंकती हैं। उपयोग करने के लिए:

CYCLONES_FIXTURE=multi-storm bun run dev
AIRCRAFT_FIXTURE=conus-snapshot bun run dev

या Docker Compose के माध्यम से (docker-compose.dev.yml दोनों पास करता है):

CYCLONES_FIXTURE=single-cat5 bun run docker:dev:up

उत्पादन

bun run docker:prod:up         # http://localhost:5500
bun run docker:prod:down       # रोकें

TLS के साथ उत्पादन

DOMAIN=sigint.example.com bun run docker:prod:tls:up
bun run docker:prod:tls:down   # रोकें

Heroku

git push heroku main

सफाई

bun run docker:clean:all       # कंटेनर, वॉल्यूम, इमेज हटाएं

PWA

SIGINT एक प्रोग्रेसिव वेब ऐप के रूप में स्थापित करने योग्य है। तैनात ऐप पर जाने के बाद:

• डेस्कटॉप (Chrome/Edge): एड्रेस बार में इंस्टॉल आइकन पर क्लिक करें
• iOS Safari: शेयर करें > होम स्क्रीन पर जोड़ें
• Android Chrome: मेनू > होम स्क्रीन पर जोड़ें

सर्विस वर्कर ऑफ़लाइन बूट के लिए ऐप शेल को कैश करता है। ऑफ़लाइन होने पर लाइव डेटा IndexedDB से लोड होता है। जब कनेक्टिविटी खो जाती है तो एक ऑफ़लाइन संकेतक पट्टी दिखाई देती है, जिसमें रीट्राई बटन और टच डिवाइस पर पुल-टू-रिफ्रेश होता है। जब कोई अपडेट उपलब्ध होता है, तो एक बैनर उपयोगकर्ता को पुनः लोड करने का संकेत देता है — कोई मौन मिड-सत्र कोड स्वैप नहीं।

दस्तावेज़ीकरण

docs/ में पूर्ण तकनीकी दस्तावेज़ आर्किटेक्चर, डेटा प्रवाह, फीचर सिस्टम, पेन सिस्टम, रेंडरिंग, कैशिंग, खोज और बाधाओं को कवर करता है।

लाइसेंस

द्वैत-लाइसेंस:

• गैर-वाणिज्यिक SIGINT गैर-वाणिज्यिक लाइसेंस के तहत मुफ्त
• वाणिज्यिक शर्तों के लिए लेखक से संपर्क करें

लेखक

एंथनी ट्रोपियानो