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=<output of openssl rand -hex 32>

선박 및 화재 데이터용 키를 선택적으로 추가할 수 있습니다:

AISSTREAM_API_KEY=<your aisstream.io key>
FIRMS_MAP_KEY=<your NASA FIRMS key>

빠른 시작

개발, 프로덕션, Heroku 옵션은 배포를 참조하세요.

환경 변수

데이터 소스

테스트

bun test            # run all tests
bun test --watch    # watch mode
bun run docker:test # run in Docker

배포

개발

bun run docker:dev:up          # https://localhost (self-signed cert)
bun run docker:dev:down        # stop

개발 전용 픽스처 오버라이드

두 환경 변수는 개발 중 실시간 데이터 조회를 우회하여 알려진 고정 상태를 기준으로 작업할 수 있게 해줍니다. 두 변수 모두 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       # stop

TLS를 사용한 프로덕션

DOMAIN=sigint.example.com bun run docker:prod:tls:up
bun run docker:prod:tls:down   # stop

Heroku

git push heroku main

정리

bun run docker:clean:all       # remove containers, volumes, images

PWA

SIGINT는 프로그레시브 웹 앱(PWA)으로 설치할 수 있습니다. 배포된 앱에 접속한 후:

• 데스크톱 (Chrome/Edge): 주소 표시줄의 설치 아이콘을 클릭하세요
• iOS Safari: 공유 > 홈 화면에 추가
• Android Chrome: 메뉴 > 홈 화면에 추가

서비스 워커는 오프라인 부팅을 위해 앱 셸을 캐시합니다. 오프라인 상태에서는 라이브 데이터를 IndexedDB에서 불러옵니다. 연결이 끊기면 오프라인 표시 막대가 나타나며, RETRY 버튼과 터치 기기의 당겨서 새로고침이 제공됩니다. 업데이트가 있으면 배너가 사용자에게 다시 로드하도록 안내합니다 — 세션 중 조용한 코드 교체는 없습니다.

문서

아키텍처, 데이터 흐름, 기능 시스템, 패널 시스템, 렌더링, 캐싱, 검색, 제약 조건을 다루는 전체 기술 문서는 docs/에 있습니다.

라이선스

이중 라이선스:

• 비상업적 사용은 SIGINT 비상업적 라이선스에 따라 무료입니다
• 상업적 사용은 작성자에게 문의하여 조건을 확인하세요

작성자

Anthony Tropeano