소형전시기

우리 위성 5기(1~5호기)의 통과 시간과 다른 물체와의 충돌 위험을 지켜보는 감시 도구입니다. 자리를 비웠을 때도 상황을 놓치지 않게 하는 게 목적이라, 통과 예보·충돌위협·궤도기동을 미리 알림으로 알려줍니다.우리 위성 5기(1~5호기)의 통과 시간을 한눈에 보는 도구입니다. 자리를 비웠다 돌아왔을 때 "다음 교신이 언제인지"를 1초 만에 확인하는 것이 목적입니다. 이 버전은 알림을 보내지 않고, 충돌위협·궤도기동 감시는 들어 있지 않습니다. 신기한 기능을 늘리기보다 "몰라서 생기는 비효율을 없애는 것"에 초점을 둡니다.

의도된 설계이며 고장이 아닙니다. 위성 식별정보는 항상 민감정보로 다루기 때문에, 남이 화면을 흘깃 봤을 때 무슨 앱인지 바로 드러나지 않게 홈 화면 아이콘·앱 이름·최근 앱 화면 미리보기를 위장합니다. 같은 이유로 위성 이름은 "N호기"로, 지상국은 도시 이름으로만 표시합니다. 아이콘 종류는 "🖥 화면 표시 → 앱 아이콘 / 이름"에서 바꿉니다.

화면은 크게 셋입니다 — 위쪽 헤더(현재 시각·데이터 기준시각·우주기상), 가운데 지도(위성 위치·궤적), 아래 사이드바(통과 시간 목록 ↔ 충돌 위협 목록)("위성 통과 추정시간" 목록). 보통은 사이드바의 "위성 통과 추정시간"만 보면 됩니다. 헤더 바로 아래 띠에 다음 교신까지 남은 시간이 항상 떠 있으니, 급할 땐 그 줄만 봐도 됩니다.

· 시계 — 현재 날짜·시각. 옆의 UTC/KST 버튼을 누르면 앱 전체(통과 시각·기준시각·목록)가 그 시간대로 한꺼번에 바뀝니다.
· 데이터 소스 — 어느 기관 데이터로 계산할지 고릅니다(아래 "데이터 소스는 뭘 고르나요?" 참고).
· ⟳ 업데이트 — 최신 궤도데이터(TLE)를 다시 받아옵니다. 앱을 열 때 자동으로 받아오므로 평소엔 누를 일이 없습니다. 눌렀는데 "이미 최신입니다"라고 나와도 고장이 아닙니다 — 궤도데이터 원본이 2시간에 한 번만 갱신되기 때문입니다(아래 "업데이트를 눌러도 안 받아오는 것 같아요" 참고).
· 기준시각 + 경과 배지 — 지금 화면의 계산이 언제 받은 궤도데이터에 기반하는지입니다. 이 값이 오래됐으면 배지 색이 바뀝니다. 3시간 넘게 갱신이 안 되면 "⚠ 궤도기동 감지 중단 의심" 경고가 뜹니다.
· 우주기상 배지 — 태양·지자기 활동(Kp·F10.7, R/S/G 등급). 활동이 높으면 대기가 부풀어 저궤도 위성의 궤도 감쇠가 평소보다 빨라질 수 있다는 참고 정보입니다. 눌러서 자세히 볼 수 있습니다.
· ▴ 버튼 — 헤더를 접어 지도를 넓게 씁니다. 위아래로 드래그해 높이를 직접 조절할 수도 있습니다.

위성 위치와 궤적을 2D 지도 또는 3D 지구본으로 봅니다.
· 위성 선택 — 목록이나 지도에서 위성을 누르면 지도가 그 위성을 따라갑니다. 지도를 직접 드래그하면 추적이 풀립니다(화면 위 "추적 중" 배지를 누르면 다시 따라감).
· 🎯 우리 위성 전체 보기 — 5기가 모두 보이도록 화면을 맞춥니다.
· 🌐 3D 지도 — 지구본 보기로 전환(+/− 로 확대·축소).
· 📍 — 한반도로 화면 이동.
· ▾ — 사이드바를 접어 지도를 넓게 봅니다.
지도 위 안테나 표시는 실제 시설 좌표가 아니라 흐려둔 참고 지점입니다.

사이드바는 두 화면을 오갑니다. "위성 통과 추정시간"은 앞으로 24시간의 교신 예정을, "충돌 위협"은 접근 중인 물체를 보여줍니다. 제목줄 오른쪽 버튼으로 전환합니다. 통과마다 [자동|포함|제외]로 순번(N번째)에 넣을지 직접 정할 수 있고, 목록 맨 위 "✎ 패스 순번 편집"에서 묶음 전체를 한 번에 고칠 수 있습니다. 📌 핀 버튼을 누르면 지금 높이로 고정되고, 손잡이를 위아래로 드래그해 높이를 바꿀 수 있습니다.

위성 목록은 추적 중인 물체 전체를 보여주고, 누르면 지도가 따라갑니다. 안테나 필터는 특정 지상국이 담당하는 위성만 남겨 봅니다(전체를 고르면 원래대로). 안테나는 여러 개를 함께 고를 수 있어, 예를 들어 "현위치 기준 + 내가 추가한 안테나"만 같이 볼 수 있습니다. 필터가 켜져 있는 동안에는 지도 위에 표시가 떠서, 안 보이는 위성이 있어도 고장이 아니라 필터 때문임을 알 수 있습니다.

AOS는 위성이 지상국 위로 떠오르는 시각(고도 0° 기준), LOS는 사라지는 시각입니다. 기본은 안양·제주 지상국 기준이며 앞으로 24시간을 보여줍니다.

· 회차 번호("N번째") — 이어지는 통과 묶음에서 몇 번째인지(주간·야간으로 나눠 세는 위성은 "주간/야간 N패스"). 묶음이 끝나 한동안 안 보이면 다음 묶음은 다시 1번부터 셉니다.
· 순번 포함/제외 — 통과마다 순번(N번째)에 넣을지 사람이 정합니다. [포함]은 짧거나 낮아도(1분 미만 포함) 실제 교신한 통과로 셉니다. [제외]는 정상 통과라도 교신하지 않은 통과로 보고 번호에서 뺍니다. [자동]은 아래 "자동 판단" 규칙을 따릅니다. 포함/제외를 바꿔도 통과 자체(AOS·LOS·최대고도·지속시간)는 목록에 그대로 남고 번호만 다시 매겨집니다. 카드 머리줄의 작은 칩(● 순번 포함/○ 순번 제외/◐ 번호 보류, 직접 정한 것은 노란 테두리)을 누르면 [자동|포함|제외]가 그 카드 안에 펼쳐집니다. 목록 맨 위 "✎ 패스 순번 편집"은 지금 묶음의 통과(이미 지나간 것 포함)를 체크 목록으로 보여주며, 체크한 통과만 셉니다. 설정은 저장되어 목록이 다시 계산돼도 같은 통과에 남고(궤도가 몇 분 움직여도 같은 통과로 알아봄), 통과 뒤 3일이 지나면 저절로 정리됩니다.
· 카드 접기/펼치기 — 카드 오른쪽 ▾/▴로 접고 폅니다. 접힌 카드는 위성·지상국·N번째·AOS까지 남은 시간·순번 칩만 보여주고, 펼치면 AOS·LOS·지속시간·최대고도와 판단 근거가 나옵니다. 목록 맨 위 "목록 표시"에서 자동(짧거나 낮은 통과만 접음)/모두 접기/모두 펼치기를 고릅니다. 접는 것은 화면 표시일 뿐이라 순번에는 아무 영향이 없습니다(접힌 통과 ≠ 순번 제외).
· 자동 판단(첫/마지막 패스 기준) — [자동]인 통과에만 쓰입니다. 첫 패스 기준(기본)은 접히지 않은 첫 통과를 1번으로 셉니다. 마지막 패스 기준은 마지막 통과에서 거꾸로 세어, 묶음 맨 앞의 짧은 통과까지 순서에 넣습니다. 직접 포함/제외한 통과에는 영향이 없습니다.
· 짧은 패스 — 기본 7분 미만이면 개수 집계에서만 빠지고 목록·알림에는 그대로 남습니다(예측이 어긋나 실제 통과를 놓칠 수 있어서).
· 낮은 패스 — 최고 고도각이 기본 5도 미만이면 지평선을 스치는 통과로 보고 한 줄로 접힙니다(역시 목록에서 빠지지는 않음).
· 동시관제 — 안양·제주 통과가 기본 5분 이내로 가까우면 색깔로 묶어 표시합니다. 한 사람이 두 곳을 동시에 볼 수 없다는 뜻입니다.
· 비가시 구간 — 통과 간격이 기본 150분 이상 벌어지면 "다음 통과까지 몇 시간 비가시"라고 적어, 자리를 비워도 되는 시간을 알려줍니다.
지나간 48시간의 기록은 "📁 기록 및 현황 → 지나간 패스 보기"에서 봅니다.

세 가지 출처를 나란히 보여줍니다 — ① Space-Track 공식 접근경보(CDM, 하루 1회 갱신), ② 무료 SOCRATES 스크리닝, ③ 공식 데이터가 없을 때 이 앱이 궤도데이터로 직접 계산한 참고값.

출처마다 최근접거리가 크게 다를 수 있습니다(예: 0.14km vs 142km). 이건 오류가 아니라 계산에 쓰는 궤도데이터 자체가 달라서 생기는 정상적인 차이이고, 그 차이 자체가 정보입니다. 이럴 땐 항상 더 가까운(더 위험한) 값을 기준으로 보수적으로 판단합니다 — 두 값이 어긋난다고 "해제됐다"고 보지 않습니다.

위협은 관심 → 주의 → 심각 → 충돌 4단계입니다. 판정 기준(TCA·최소접근거리·충돌확률·반경방향거리 R)은 "🎯 충돌위협 판정 기준"에서 직접 정합니다. 기준을 안 채운 단계는 "위협 없음"이 기본값이라, 채운 단계만 실제로 뜨기 시작합니다(Space-Track 공식 긴급보고대상 지정은 예외로 항상 뜸).

해제된 위협은 원인별(상대측 기동 / 우리측 기동 / 원래 그 경로가 아니었음 / 기타)로 정리되고, 카드의 "📋 해제 원인 보기"나 "🎬 시뮬레이션 보기"로 그 상황을 다시 볼 수 있습니다.

위성의 궤도데이터(TLE)가 갑자기 크게 바뀌면 기동으로 추정해 기록·알림합니다(공식 확인이 아닌 참고용 비공식 추정치).

· 판정 기준 — 순간 고도가 아니라 궤도 크기(장반경) 변화를 봅니다. 기본 100m 미만이면 기동으로 안 칩니다. 단 경사각만 바뀐 기동(궤도면 변경)은 애초에 고도 얘기가 아니라 이 값과 무관하게 그대로 감지됩니다.
· 고도 급하강 — 인위적 기동보다 자연 감쇠일 가능성이 높아 목록에서 기본적으로 숨겨집니다(감지·기록 자체는 계속됩니다).
· 위치 보기 / 여러 바퀴 보기 — 기동이 일어난 지점과, 여러 바퀴에 걸친 고도 추이·나선 궤적을 볼 수 있습니다.
· 연료·델타V 추적 — 지금까지의 기동 기록으로 남은 추진제 예산을 대략 계산합니다(로켓방정식 기반 추정치이며 실제 임무 의사결정용 데이터가 아닙니다).

세 종류가 있고 동작 방식이 서로 다릅니다.

① AOS 알림 — 통과 몇 분 전. 설정한 시간대·요일에만 울립니다. 서버 연결이 켜져 있고 푸시 구독이 되어 있으면 앱을 완전히 종료해도 옵니다. 서버 연결을 꺼두면 앱이 열려 있거나 백그라운드에 살아 있는 동안에만 옵니다.
② 충돌위협(CDM) 알림 — 공식 접근경보가 뜨면. 서버가 대신 보내주는 방식이라 앱이 완전히 꺼져 있어도 옵니다(서버 연결을 꺼두면 못 옴). 설정한 시간대에만 오지만, 무음 설정과 무관하게 항상 소리+진동입니다.
③ 궤도기동 알림 — 기동이 추정되면 즉시. 앱이 꺼져 있어도 오고 시간대·요일과 무관합니다.

알림이 안 온다면: 종류별로 켜져 있는지, 시간대·요일이 지금과 맞는지, 기기 자체가 무음·배터리 절약 모드는 아닌지, 서버 연결을 꺼두지 않았는지 확인하세요. 지나간 알림은 "📁 기록 및 현황 → 알림 저장 목록"에 남습니다.

헤더의 우주기상 배지를 누르면 뜨는 팝업 하나에서 전부 확인할 수 있습니다.

· 확인 시각 — "확인 08/26 16:13:50 KST (12분 전)"처럼 언제 받아온 값인지와 얼마나 지났는지가 함께 표시됩니다. R/S/G 등급과 Kp/F10.7이 각각 따로 표시되는데, 둘은 출처가 달라서 한쪽만 안 될 수 있기 때문입니다.
· ⟳ 업데이트 — 지금 바로 다시 받아옵니다. 성공하면 "✅ 우주기상 정보를 새로 불러왔습니다", 일부만 되면 어느 쪽이 실패했는지, 전부 실패하면 "마지막 정보 유지"라고 알려줍니다(연타 방지로 20초 간격 제한).
· ⚠ 경고 문구 — 갱신에 실패했거나 값이 너무 오래됐으면(Kp 기준 6시간 초과) 주황색 경고가 그 자리에 뜹니다. 경고가 없으면 정상입니다.

자동 갱신 주기: R/S/G 등급은 40분마다, Kp/F10.7은 3시간마다입니다. Kp가 3시간인 것은 원본 데이터 자체가 3시간마다만 바뀌기 때문이라, 더 자주 불러도 같은 값만 받습니다. 값이 한동안 그대로여도 고장이 아닙니다 — 확인 시각이 갱신되고 있는지를 보세요.

· Space-Track — 미 우주군이 공식 운영. 공식 접근경보(CDM)까지 함께 봅니다. 가장 권위 있는 출처입니다.
· SOCRATES — CelesTrak이 전 카탈로그를 직접 스크리닝한 무료 공개 결과(10~11시간마다 갱신).
· CelesTrak — 민간 비영리 공개 카탈로그. 충돌 판정은 이 앱이 직접 계산한 참고값입니다.
· SpaceMap — 국내 업체. 아직 연동되지 않아 CelesTrak 데이터로 대체됩니다.
· tle.ivanstanojevic.me — NASA 공개 API 목록에 등재된 서비스. 주 출처가 응답하지 않을 때 자동 예비로도 쓰입니다.

무엇을 고르든 위성 위치·통과 시간 계산 방식은 같습니다. 차이는 "충돌 판정을 누가 했느냐"입니다.이 버전에서 고를 수 있는 것은 위 세 가지이고, 어느 것을 골라도 위성 위치·통과 시간 계산 방식은 같습니다 — 궤도데이터를 어디서 받아오는지만 달라집니다.

AOS·충돌위협·궤도기동 세 알림을 각각 켜고 끕니다. AOS 알림은 몇 분 전에 받을지, 어떤 시간대·요일에만 받을지 정할 수 있어 야간·주말에 안 울리게 할 수 있습니다. 소리·진동·무음도 알림별로 정합니다(기기 자체가 무음이면 앱 설정과 무관하게 안 울릴 수 있음).

지나간 패스 보기는 최근 48시간의 통과 기록을, 알림 저장 목록은 지나간 알림을, 주간/야간 패스 개수는 낮·밤 통과가 몇 번씩인지를 보여줍니다. 화면 위에 떴다 사라진 안내(토스트)도 24시간 동안 따로 보관되어 나중에 다시 확인할 수 있습니다.

글자 크기(레이아웃이 깨지지 않게 자동 조정 · "더 크게" 이상을 고르면 위쪽 정보창이 접힌 채로 시작해 통과 목록이 먼저 보입니다), 관제실 상시 표시(다음 교신까지 남은 시간만 크게 띄우는 벽걸이·태블릿용 화면), 홈 화면에 설치, 앱 아이콘/이름(NEWS·계산기·날씨·백신·커비 중 선택), 마스코트 자동 말풍선, 위성 색상(지도에서 위성마다 다른 색, 눌러서 변경), 위성 이름 표시(N호기 ↔ 실제 코드명)를 정합니다.

· 잠금 — PIN(4자리)·패턴·지문/얼굴 인식으로 화면을 잠급니다. PIN이 항상 기본 해제 수단이고 패턴·생체는 그 위에 얹는 더 빠른 방법일 뿐이라, 둘 다 실패해도 PIN으로는 항상 풀립니다. 5회 연속 틀리면 30초부터 시작해 틀릴 때마다 길어지는 대기시간(최대 5분)이 걸립니다.
· 보안 정책 — 이 앱이 무엇을 하고 무엇을 하지 않는지 항목별로 정리돼 있습니다.

정직하게 밝히는 한계: 백그라운드 전환 시 화면 가리기는 100% 보장되는 차단이 아니라 최선의 완화 조치입니다 — 운영체제가 화면을 캡처하는 정확한 시점은 앱이 알거나 개입할 수 없어서, 타이밍에 따라 가려지기 전 화면이 순간적으로 찍힐 수 있습니다. 이 잠금은 기기를 가진 사람을 빠르게 막는 용도이지 절대적인 보안 장치가 아닙니다.

현위치 기준을 켜면 지금 있는 곳 기준 통과 시간도 함께 나옵니다(이동했으면 "위치 갱신"을 다시 눌러야 합니다). 현위치를 정하는 방법은 세 가지입니다 — 위치 갱신(GPS), 지도에서 직접 지정, 좌표로 직접 입력(십진수 또는 도·분·초). 실내라 GPS가 안 잡히거나 좌표를 이미 알고 있을 때는 세 번째가 가장 정확합니다. 해외안테나(칠레·노르웨이) 기준도 켤 수 있고, 가상 안테나는 이름과 위치만 정하면 개수 제한 없이 추가됩니다(위도·경도를 몰라도 지도를 눌러 지정 가능 — 3D 지도를 보고 있으면 자동으로 2D로 바뀝니다). 이 세 가지는 모두 참고용 계산이며 실제 관제소가 아닙니다.

안테나별 감시 위성 — 참고용 안테나마다 거기서 볼 위성만 골라둘 수 있습니다(설정에 저장되므로 앱을 껐다 켜도 유지됩니다). 예를 들어 "대전 안테나는 3호기·5호기만"으로 해두면 통과 목록·지도에 그 두 기만 나옵니다. 고르지 않으면 지금까지처럼 전부 봅니다. 안양·제주는 실제 담당이라 항상 전부 표시됩니다 — 놓치면 안 되는 통과가 필터에 가려지지 않게 하기 위해서입니다. 좁혀둔 동안에는 지도 위 표시등에 "○기만"이라고 계속 떠 있습니다.

안테나를 옮기거나 바꿨다면 같은 화면 아래쪽에서 기준값도 함께 맞춰주세요 — 지상국 페일오버(안테나 고장 시 담당 전환), 지상국 AOS/LOS 시간 보정(예측이 실측과 어긋날 때 초 단위), 최소 통과 지속시간, 최소 통과 고도각(그 안테나가 실제로 잡을 수 있는 높이). 예전에는 "고급 설정" 안에 있던 항목들이라 못 찾으셨다면 지금은 여기 모여 있습니다.
※ 시간 보정은 이제 추가한 가상·해외 안테나에도 걸 수 있습니다(새 안테나는 기본 0초 = 보정 없음). 페일오버도 그 안테나로 전환할 수 있습니다 — 단 옮길 대상을 고르는 쪽은 여전히 안양·제주입니다(위성이 배정된 곳이 그 두 곳뿐이라서). 또 휴대폰 알림 시각은 안양·제주 기준으로만 계산되므로, 가상·해외 안테나로 전환하면 그 전환은 이 기기 화면에만 반영됩니다.

일부 기능은 개발자가 운영하는 서버를 거칩니다 — 앱이 꺼져 있을 때 오는 알림, 공식 접근경보 조회, Space-Track 확인, 우주환경센터(KASA) 값, 초대코드 확인.

그 서버를 신뢰하지 않기로 했다면 "서버 사용 안 함"으로 전부 차단할 수 있습니다. 이때도 통과 시간 계산·지도·위성 목록·궤도데이터 갱신·NOAA 우주기상·잠금은 그대로 작동합니다(이 기기 안에서만 도는 기능이라서). 꺼지는 기능의 전체 목록은 끈 뒤 그 화면에 항상 표시됩니다.

연결할 서버 주소도 바꿀 수 있지만 아무 주소나 넣으면 안 됩니다 — 이 앱 전용 백엔드가 도는 서버만 가능하며, 추가할 때 자동으로 호환 여부를 확인합니다.

· 충돌위협 판정 기준 — 4단계 기준을 직접 정합니다. 위에서부터 먼저 맞는 단계로 판정하고, 비워두면 그 조건은 쓰지 않습니다.
· 궤도기동 이력 보기 — 지금까지 감지된 기동 기록.
· 고도 급하강 이벤트 표시 — 자연 감쇠로 보이는 하강을 목록에 보일지.
· 궤도기동 판정 최소 고도변화 — 기본 100m. 이 기기에만 적용되며, 서버 알림 기준까지 맞추려면 관리자 화면에서 따로 설정해야 합니다.
· 해제 원인 리포트 — 해제된 위협을 원인별로 정리(이 기기가 못 본 서버 기록도 포함).
· 저장 공간 사용량 — 이 브라우저에 저장된 기록의 용량과 한도 게이지.
· 기록 백업 · 되살리기 — 기록을 파일로 저장하고 되살립니다. 되살릴 때는 지금 있는 기록에 합쳐지고 기존 기록은 지워지지 않습니다. 잠금 비밀번호는 파일에 들어가지 않습니다.
· 동시관제 판정 기준 — 안양·제주 통과가 몇 분 이내면 겹친 것으로 볼지(기본 5분, 0분이면 완전히 겹칠 때만).

예측과 실측이 어긋날 때 맞추는 항목들입니다.
· 지상국 페일오버 — 아래 별도 항목 참고.
· AOS/LOS 시간 보정 — 초 단위로 당기거나 늦춥니다(양수=늦춤, 음수=당김, ±5분까지). 제주는 기본 80초 늦춰져 있습니다.
· 주간/야간 시간 기준 — 패스 목록의 낮·밤 구분 기준(야간 종료는 항상 다음날 취급).
· 상단 정보창 드래그 범위 — 헤더를 접었다 펼 때의 상·하한.
· 최소 통과 지속시간(기본 7분) / 최소 통과 고도각(기본 5도) — 개수 집계·접기 기준이며 목록·알림에서 빼지는 않습니다. 0으로 두면 꺼집니다.
· 비가시 구간 판정 기준 — 통과 간격이 몇 분 이상이면 "비가시"로 볼지(기본 150분).

안테나 장애 등 비상 상황에서 담당 지상국을 다른 곳으로 옮기는 기능입니다. 기본은 그 지상국이 맡던 위성 전체가 대상이고, 특정 위성만 옮기고 싶으면 체크를 해제하면 됩니다(해제된 위성은 원래 지상국 그대로). 전환하면 AOS/LOS 시각·통과 목록·동시관제 판정·알림 시각까지 전부 새 지상국 기준으로 즉시 바뀝니다. 평상시에는 "정상"으로 두세요.

다음 교신까지 남은 시간만 크게 띄우는 전용 화면으로, 벽걸이 화면이나 여분 태블릿용입니다(처음 한 번은 잠금을 통과해야 다음부터 바로 뜹니다).

서버가 하루 한 번 받아둔 최신 결과를 보여줍니다 — 여러 번 눌러도 Space-Track에 추가로 접속하지 않습니다.

화면이 깨지거나 값이 이상할 때 증상을 눌러 자동으로 바로잡는 항목들입니다(개인 설정은 유지됩니다). 레이아웃이 접히거나 잘림, 글자 크기 문제, 갱신이 안 되는 느낌, 흰 화면, 아이콘이 안 바뀜, 알림이 안 옴 등을 다룹니다. 어디에도 안 맞으면 마지막 "Terra 9. 전체 초기화"를 씁니다. 단, 충돌위협·궤도기동 기록은 초기화해도 지워지지 않습니다.

충돌위협·궤도기동 기록은 절대 자동으로 지워지지 않고, 삭제 버튼도 없습니다 — 이 기록이 나중에 시뮬레이션·분석에 쓰이는 원본 데이터라 한 번 지우면 복구할 수 없기 때문입니다. 이 버전은 따로 쌓아두는 기록이 없습니다 — 통과 시간은 열 때마다 다시 계산하고, 받아온 궤도데이터만 이 기기에 남습니다. 용량이 걱정되면 "🎯 저장 공간 사용량"에서 지금 얼마나 쓰는지 게이지로 확인할 수 있습니다(수치 기준으로 언제 정리할지는 사용자가 판단합니다).

⚠️ 다만 이 기록은 이 기기의 브라우저 안에만 있습니다. 브라우저 데이터를 지우거나 기기를 바꾸면 앱이 되살릴 방법이 없습니다 — "기록 백업 · 되살리기"에서 가끔 파일로 저장해 두세요. 되살릴 때는 지금 있는 기록에 합쳐지므로, 백업이 오래된 것이어도 최신 기록이 사라지지 않습니다.⚠️ 설정과 받아둔 궤도데이터는 이 기기의 브라우저 안에만 있습니다 — 브라우저 데이터를 지우면 처음 상태로 돌아갑니다(앱은 다시 열면 최신 궤도데이터를 다시 받아옵니다).

위성·우주기상 데이터는 전부 공개 정보입니다 — 미국 Space-Track·CelesTrak, NASA 공개 API 목록의 tle.ivanstanojevic.me, 미국 NOAA, 한국 우주항공청(KASA) 우주환경센터.위성·우주기상 데이터는 전부 공개 정보입니다 — CelesTrak, NASA 공개 API 목록의 tle.ivanstanojevic.me, 미국 NOAA. 이 버전은 중간 서버 없이 이 기기가 그 공개 사이트에 직접 접속해 받아옵니다.

인터넷이 끊겨도 앱은 멈추지 않습니다. 마지막으로 받아둔 궤도데이터를 이 기기에 저장해 두고, 다음에 열 때 그 값으로 계산을 이어갑니다. 화면 위 기준시각이 그 값이 언제 것인지 알려주고, 너무 오래됐으면 경고 배지가 뜹니다. 인터넷이 돌아오면 다음 갱신 때 자동으로 최신값을 다시 받아옵니다.

Q. 회차 번호("N번째")가 갑자기 바뀌었어요.
버그가 아닙니다. 번호는 KST 하루 기준으로 자정에 1번으로 리셋되고, 그 하루 전체가 예보 범위 안에 들어와야 총 개수가 확정됩니다. 확정 전에는 "예보 범위를 넘어가 총 몇 회인지 확정할 수 없다"는 안내가 함께 뜹니다.

Q. 고도가 오르락내리락해요 — 지금 올라가는 건가요, 내려가는 건가요?
궤도는 원이 아니라 타원이라 순간 고도차만으로는 판단할 수 없습니다(한 바퀴 안에서도 부호가 뒤집힙니다). 방향은 장반경(궤도 크기)의 여러 바퀴 추세로 봐야 정확합니다. 또 "무엇과 비교한 값인지"에 따라 방향이 반대로 나올 수도 있습니다 — 기동 전 궤도와 비교할 때, 자연 감쇠까지 감안한 예상 궤도와 비교할 때가 다릅니다.

Q. 같은 접근인데 최근접거리가 출처마다 너무 달라요.
정상입니다. 출처마다 쓰는 궤도데이터가 달라 생기는 차이이며, 항상 더 가까운 값을 기준으로 보수적으로 판단합니다.

Q. 충돌위협이 하나도 안 떠요.
판정 기준을 안 채운 단계는 "위협 없음"이 기본값입니다. "🎯 충돌위협 판정 기준"에서 원하는 단계의 조건을 채워야 그 단계가 뜨기 시작합니다.

Q. 설정을 바꿨는데 화면에 바로 안 보여요.
대부분 즉시 반영되지만, 홈 화면 아이콘처럼 운영체제가 캐시해두는 항목은 홈 화면에서 지우고 다시 추가해야 바뀝니다. 그래도 이상하면 "🔧 문제 해결"에서 증상에 맞는 항목을 눌러보세요.

Q. 지도에 위성이 몇 개 안 보여요.
안테나 필터가 켜져 있을 수 있습니다(지도 위에 필터 표시가 떠 있는지 확인). "전체"를 고르면 원래대로 돌아옵니다.

Q. 업데이트를 눌러도 안 받아오는 것 같아요 ("이미 최신입니다"라고 나와요).
정상입니다. 궤도데이터(TLE) 원본이 2시간에 한 번만 갱신되기 때문에, 그 사이에 다시 받아봐야 똑같은 값입니다. 그래서 이 앱은 마지막으로 받은 시각을 기억해두고 2시간이 지나기 전에는 다시 받지 않습니다 — 대신 버튼을 누르면 이미 받아둔 궤도데이터로 위치·통과·충돌 정보를 다시 계산합니다(이건 매번 실제로 새로 계산됩니다). 토스트에 마지막으로 받은 시각이 함께 나오니 그 값으로 확인하세요.
이렇게 만든 이유가 하나 더 있습니다 — 이 앱은 중간 서버 없이 각자의 휴대폰이 자료 제공처에 직접 접속합니다. 쓰는 사람이 많아지면 그만큼 그쪽에 부담이 가고, 자료 제공처의 이용규칙도 "2시간 안에는 다시 받지 말 것"이라고 정해두고 있어 그 규칙을 지키는 것이기도 합니다. 규칙을 어기면 접속이 차단돼 모두가 데이터를 못 받게 됩니다.

Q. 우주기상은 눌러도 바로 바뀌는데 궤도데이터는 왜 다른가요?
갱신 주기가 다르기 때문입니다. 우주기상(R/S/G 등급)은 원본이 40분마다, Kp 지수는 3시간마다 바뀌고, 궤도데이터는 2시간마다 바뀝니다. 우주기상 팝업의 "⟳ 업데이트"는 20초 간격으로 다시 받을 수 있게 열어뒀습니다.

2026년 7월 16일에 첫 버전이 만들어졌고, 그 뒤로 200회가 넘는 수정을 거쳐 지금 모습이 됐습니다. 전체 규모는 약 2만 8천 줄이며, 화면 쪽(약 2만 2천 줄)과 서버 쪽(약 4천 8백 줄)으로 나뉩니다.

만드는 방식은 "기능을 먼저 늘리고 나중에 고치는" 쪽이 아니라, 실제로 겪은 문제를 하나씩 막아 나가는 쪽에 가깝습니다. 예를 들어 예전에 배포 명령 하나가 공개하면 안 될 내부 파일까지 같이 올린 적이 있었는데, 그 뒤로는 사람이 조심하는 대신 도구가 기계적으로 막도록 배포 절차 자체를 바꿨습니다. 지금은 배포할 때마다 공개 대상 파일만 따로 골라내고, 실수로 내부 문서가 섞이면 배포 자체가 중단됩니다. 화면에 보이는 "문제 해결(Terra 0~9)" 항목들도 상상해서 만든 게 아니라, 실제로 한 번씩 겪었던 증상들을 그대로 목록으로 만든 것입니다.

화면 쪽은 React·Vue 같은 프레임워크를 쓰지 않은 순수 JavaScript·HTML·CSS입니다. 외부 라이브러리는 꼭 필요한 3개만 씁니다 — 2D 지도는 Leaflet.js, 위성 궤도 계산은 satellite.js(SGP4/SDP4 표준 궤도 전파 모델), 오프라인 서명 검증은 ML-DSA-65(미국 NIST 양자내성 표준 FIPS 204) 구현체입니다. 3D 지구본은 라이브러리 없이 Canvas로 직접 그렸습니다.

지도 배경에 외부 타일 서버를 쓰지 않는 것이 이 앱의 특징입니다. 보통 지도 앱은 지도 이미지를 외부 서버에서 실시간으로 받아오는데, 그러면 "이 사람이 지금 지구 어느 지점을 보고 있는지"가 그 외부 서버에 그대로 남습니다. 이 앱은 전 세계 육지 윤곽선 데이터를 앱 안에 통째로 내장해서 직접 그리기 때문에, 지도를 아무리 확대·이동해도 외부로 나가는 요청이 한 건도 없습니다.

서버 쪽은 Cloudflare Worker(JavaScript)이고, 데이터는 KV 저장소에, 알림 예약은 Durable Object에 보관합니다. 서버도 궤도 계산에 같은 satellite.js를 써서, 화면에서 계산한 통과 시각과 서버가 알림을 보내는 시각이 어긋나지 않게 했습니다.

또 이 앱은 설치형 웹앱(PWA)이라 화면을 구성하는 파일이 기기에 미리 저장됩니다. 그래서 인터넷이 끊겨도 앱 자체가 열리고, 궤도 계산은 서버가 아니라 기기 안에서 도는 것이라 마지막으로 받아둔 궤도데이터만 있으면 계산이 계속됩니다.

앱이 스스로 지켜보는 게 아니라, 서버가 대신 지켜보고 있다가 밀어주는 방식(웹 푸시)이기 때문입니다. 서버는 2분마다 깨어나 지금 알려야 할 게 있는지 확인하고, AOS 알림은 그보다 정확하게 알릴 시각에 딱 맞춰 깨어나도록 미리 예약해둡니다.

그래서 AOS 알림에는 경로가 두 개 있습니다. ① 서버 푸시 — 서버 연결이 켜져 있고 푸시 구독이 되어 있으면, 앱을 완전히 종료해도 알림이 옵니다. ② 기기 자체 카운트다운 — 앱이 열려 있거나 백그라운드에 살아 있는 동안, 인터넷 상태와 무관하게 기기가 직접 시간을 세어 알립니다. ②는 ①의 대체가 아니라 보완입니다(푸시 전달이 네트워크 사정으로 늦어질 때를 메꿉니다). 반대로 서버 연결을 꺼두면 ①이 사라지므로, 앱이 완전히 닫힌 동안의 알림은 오지 않습니다.

두 경로가 있으니 같은 알림이 두 번 뜰 수 있는데, 이를 막기 위해 기기 쪽과 서버 쪽 양쪽에 "이미 보낸 알림" 기록을 남겨 서로 대조합니다. 예전에 삼성 기기에서 실제로 중복 알림이 뜬 적이 있었고, 원인이 이 대조 규칙이 양쪽에서 어긋난 것이라 지금은 두 곳이 완전히 같은 규칙을 쓰도록 맞춰져 있습니다.

앱스토어를 거치지 않고, 앱을 다시 열면 자동으로 최신 버전이 적용됩니다. 홈 화면 아이콘으로 열든 브라우저로 열든 똑같습니다. 화면이 예전 상태로 남아 있는 것 같으면 앱을 완전히 닫았다가 다시 열어보시고, 그래도 이상하면 설정의 "문제 해결"에서 해당 증상을 눌러주세요.

지금 쓰고 있는 버전이 언제 것인지는 설정 화면 맨 아래 "마지막 업데이트" 날짜로 확인할 수 있습니다. 이 날짜는 손으로 적는 게 아니라 배포할 때 자동으로 새겨지므로, 실제 배포 시점과 항상 일치합니다.

궤도 계산은 위성 업계 표준인 SGP4 모델을 그대로 쓰지만, 그걸 화면에 어떻게 보여주는지에서 실수가 날 수 있어 별도로 검증합니다.

실제로 있었던 예를 들면, 궤도기동을 "보기 좋게" 과장해서 그리는 코드가 물리적인 방향(위로 올라간 건지 내려간 건지)을 반대로 뒤집어버린 적이 있었습니다. 그래서 지금은 실제 위성의 진짜 궤도데이터로 직접 계산해서 대조하는 방식으로 확인합니다 — 예를 들어 국제우주정거장(ISS)이 실제로 수행한 궤도상승 기록의 진짜 데이터를 넣어보고, 화면에 나오는 방향·수치가 실제와 맞는지 검산합니다.

화면 동작도 사람이 눈으로만 보고 넘기지 않고, 자동 브라우저로 실제 화면을 열어 버튼을 눌러보며 확인합니다(화면 폭 320px 좁은 폰부터 데스크톱까지). 그리고 이 앱은 오차를 숨기지 않습니다 — 추정치인 값에는 "참고용·추정치"라고 명시하고, 출처마다 값이 다르면 감추지 않고 나란히 보여준 뒤 더 위험한 쪽으로 판단합니다.

· TLE (궤도요소) — 위성의 궤도를 두 줄 숫자로 적은 표준 형식. 모든 위치·통과 계산의 원본 데이터입니다.
· AOS / LOS — 위성이 지상국 위로 떠오르는 시각 / 사라지는 시각.
· 고도각 — 지평선에서 위로 얼마나 높이 떴는지(0도=지평선, 90도=머리 위). 낮으면 건물·산에 가려 실제로는 못 잡을 수 있습니다.
· 장반경 — 궤도의 크기. 이게 커지면 궤도가 올라간 것, 작아지면 내려간 것입니다. 순간 고도보다 신뢰할 수 있는 지표입니다.
· 경사각 — 궤도면이 적도와 이루는 각도. 이것만 바뀌면 고도 변화 없는 궤도면 변경 기동입니다.
· TCA — 두 물체가 가장 가까워지는 시각.
· 최근접거리 — 그때의 거리. 이 앱에서 가장 중요한 숫자입니다.
· 반경방향거리(R) — 최근접 시점의 고도 차이. 옆으로 스치는 것과 위아래로 겹치는 것을 구분합니다.
· CDM — Space-Track이 발행하는 공식 접근경보 문서.
· SOCRATES — CelesTrak이 전 카탈로그를 훑어 공개하는 무료 충돌 스크리닝 결과.
· SGP4 — TLE로 위성 위치를 계산하는 표준 방식. 이 앱의 모든 위치는 이걸로 계산합니다.
· Kp · F10.7 — 지자기 활동 지수 / 태양 전파 플럭스. 높으면 대기가 부풀어 궤도 감쇠가 빨라집니다.
· R / S / G 등급 — NOAA의 우주기상 5단계 등급(전파 교란 / 태양방사선 / 지자기 폭풍).
· 궤도 감쇠 — 옅은 대기 저항으로 궤도가 서서히 낮아지는 자연 현상. 기동이 아닙니다.
· 델타V — 궤도를 바꾸는 데 든 속도 변화량. 연료 소모량의 척도입니다.