브라우저 릴리스: 2026년 8월 26일 · 소스 압축파일 및 본 릴리스 노트 공개: 2026년 8월 31일.
SprayOps Toolkit은 기록 또는 시뮬레이션 드론 분무 로그를 검토하는 브라우저 전용 품질확인 도구입니다. v0.1.0은 사용자가 선택한 로컬 CSV의 행을 검증하고, 기록된 경로를 재구성하며, 임무 요약과 원본 행이 연결된 검토 대기열을 만듭니다. 선택한 파일은 이 워크플로에서 브라우저 내부에서 처리되며 UAM KoreaTech로 업로드되지 않습니다.
이 릴리스의 목적은 의도적으로 좁습니다. 이미 로그에 들어 있는 값을 사람이 검토하도록 돕습니다. 기체·펌프·밸브·페이로드·지상통제시스템·약제 시스템이나 실시간 텔레메트리에 연결하지 않습니다. 살포량 처방, 분무 효과 판정, 커버리지 인증, 비행 승인 또는 법적 준수 판정을 수행하지 않습니다.
공개 워크플로
페이지는 내장된 합성 CSV를 기본으로 불러옵니다. 사용자는 로컬 CSV로 교체하고, 계산된 지표와 원본 행 기반 발견사항을 확인하며, 경로·분무 상태 트레이스를 보고, JSON 요약을 내려받을 수 있습니다. JSON에는 도구명과 버전, 생성시각, 선택 파일명, 범위 문장과 계산 요약이 포함됩니다. 이는 이동 가능한 선별 검토 기록이지 불변 감사기록이나 운영 인증서가 아닙니다.
v0.1.0은 전체·유효·제외 행 수, 첫 유효 시각과 마지막 유효 시각 사이의 경과시간, 연속 좌표 사이의 Haversine 경로거리, 보고 유량을 유효 시간구간에 적분한 분무 작동시간과 추정 토출량을 계산합니다. 또한 첫 분무 활성 행과 마지막 활성 행 사이에서 이동 중 분무가 꺼진 구간을 묶고, CSV가 제공한 경계거리가 10 m 미만인 행을 표시하며, 평균 보고 지상속도와 최대 보고 고도를 제시합니다.
30초를 초과하거나 길이가 0이거나 역전된 시간구간은 작동시간·토출량 적분에 0초로 반영합니다. 이 규칙은 긴 텔레메트리 공백을 연속 분무로 오인하지 않게 하지만 누락 데이터를 복원하지는 않습니다.
CSV 입력계약
필수 헤더는 다음과 같습니다.
timestamp,latitude,longitude,altitude_m,groundspeed_mps,spray_on,flow_rate_ml_min,geofence_distance_m
timestamp는 날짜·시간으로 해석 가능해야 합니다. 위도는 -9090, 경도는 -180180이어야 하며 고도·지상속도·유량·경계거리는 유한한 0 이상의 숫자여야 합니다. spray_on은 대소문자 구분 없이 true, false, 1, 0, yes, no, on, off를 받습니다. 조건을 통과하지 못한 행은 계산에서 제외하고 원래 CSV 행 번호로 표시합니다.
파서는 쉼표를 기준으로 셀을 나누는 단순 구조이며 일반적인 따옴표 필드 CSV 엔진은 아닙니다. 필수 필드에 쉼표가 들어가지 않게 해야 합니다. 유효 행은 요약 계산 전에 시각 순서로 정렬합니다.
발견사항의 의미
커버리지 공백은 첫 분무 활성 행과 마지막 활성 행 사이의 유효 행에서 지상속도가 0.5 m/s를 초과했지만 분무 상태가 꺼짐으로 기록됐다는 뜻입니다. 경계 경고는 CSV 자체의 geofence_distance_m 값이 10 m 미만이라는 뜻입니다. 어느 결과도 실제 미처리 구역이나 법정 완충거리 침범을 입증하지 않습니다. 도구는 폴리곤에서 경계거리를 계산하거나 노즐 작동·침착량을 측정하거나 로그와 제품 라벨을 대조하지 않습니다.
0.5 m/s와 10 m는 v0.1.0에 공개된 선별 검토 기본값입니다. 농학 권고, 제조사 한계, 법정 거리 또는 검증된 운용 임계값이 아닙니다.
합성 샘플
내장 sample-spray-log.csv에는 2026-08-26 시각으로 작성한 합성 데이터 13행이 들어 있습니다. 좌표·분무 상태·유량·경계거리는 파싱, 이동 중 분무 꺼짐 구간, 검토 임계값 미만의 제공 거리를 보여주기 위해 만든 값입니다. 현장시험, 고객 운용, 기체시험, 약제 살포 또는 규제기관 점검에서 얻은 관측값이 아닙니다.
샘플은 인터페이스와 출력구조를 이해하는 용도로 사용해야 합니다. 통제된 평가에서는 계산 결과를 원본 행과 하나씩 대조하고 각 입력필드를 어느 원천 시스템이 만들었는지 기록해야 합니다.
Apache-2.0 소스 패키지 경계
버전 고정 소스 압축파일을 내려받을 수 있습니다. open-source/sprayops-toolkit에 공개된 UAMKT 작성 참조 패키지는 Apache License 2.0에 따라 배포합니다. TypeScript 파서·요약 함수인 src/index.ts, 합성 입력인 examples/sample-spray-log.csv, 사용법과 안전 경계를 설명하는 README.md, 상위 프로젝트 참조와 라이선스 경계를 담은 THIRD_PARTY_NOTICES.md, 라이선스 본문인 LICENSE, 패키지 메타데이터인 package.json으로 구성됩니다.
재사용 가능한 웹 인터페이스는 웹사이트 소스의 src/components/build/SprayLogQA.tsx에서 별도로 관리합니다. 패키지에는 ArduPilot, PX4, QGroundControl, MAVSDK 또는 OpenDroneMap 소스 코드를 복사해 넣지 않았습니다. 해당 프로젝트 링크는 상호운용 맥락을 설명할 뿐 제휴·보증·인증 또는 호환성 시험을 뜻하지 않습니다.
릴리스 한계와 평가
v0.1.0에는 서버 로그 저장소, 사용자 계정, 접근통제 계층, 전자서명, 네이티브 비행로그 디코더, 폴리곤 엔진, 교정기록 또는 실시간 명령경로가 없습니다. 브라우저 처리만으로 기밀성이 보장되는 것도 아닙니다. 단말·브라우저·로컬 파일·내보낸 기록의 보존과 접근통제 책임은 사용자에게 있습니다.
확대 사용을 검토하기 전에 합성 데이터 또는 적절하게 관리된 과거 데이터로 평가해야 합니다. CSV 스키마, 제외 행, 일부 거리·토출량 계산과 각 경고를 독립적으로 원본과 대조해야 합니다. 실제 운용과 가까운 사용은 책임 운용자, 기체·페이로드 제조사, 적격 분야 전문가와 적용 가능한 항공·농약·환경·현장 권한기관의 별도 검토가 필요합니다.
v0.1.0에서 허용되는 주장은 좁습니다. SprayOps Toolkit은 사용자가 제공한 CSV 값을 브라우저에서 검토 가능한 요약으로 정리합니다. 현장성능·운용안전·처리효과 또는 법적 준수를 입증하지 않습니다.
