> For the complete documentation index, see [llms.txt](https://docs.uvify.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.uvify.com/ui-coverage.md).
# 작성 범위 점검표
이 파일은 리뷰용 작업 기록입니다. 사용자 본문은 `README.md`와 `chapters/`에서 관리합니다.
기준: KGroundControl 1.5.0, 소스 커밋 `b09333e30f4045cfa7dafb14dd8bd3a3642b8a3b`.
## 현재 그림과 설명을 작성한 항목
| 시작점 | 다룬 화면·메뉴 | 본문 | 핵심 소스 |
| -------- | ------------------------------------------------- | -- | -------------------------------------------------------------------------------------- |
| 로그인 | 정상·실패·잠금·인증 미구성, 영문·기호·숫자 키보드 | 1장 | `src/UI/LoginGate.qml`, `TouchKeyboard.qml` |
| 비행 화면 | 연결 후 지상 대기 전체 화면, 설정·표적·HUD·UI·카메라 버튼 | 2장 | `FlyView.qml`, `FlyViewSidebar.qml` |
| 로고 | 화면 선택 메뉴, 버전, 시간 동기화 상태 표 | 3장 | `SelectViewDropdown.qml`, `TimeSyncStatusTable.qml` |
| 기체 상태 | 시동, 메시지, 센서, 강제 시동 | 3장 | `MainStatusIndicator.qml` |
| 비행 모드 | 8개 일반 모드, 길게 누르기 확인 설정 | 3장 | `FlightModeIndicator.qml` |
| 보안·알림 | 전송 보호와 서명 상태, 알림 있음·없음 | 3장 | `XShieldTelemetryIndicator.qml`, `AppNotificationIndicator.qml` |
| GPS·RTK | 위치 정보, RTK 설정 확장 | 3장 | `GPSIndicatorPage.qml` |
| 통신 | RC·텔레메트리·영상 통계, 통신모듈 이력·상세·슬롯 | 3장 | `VideoBandwidthIndicator.qml`, `MicrohardIndicator.qml` |
| 전원 | 배터리와 표시 설정 | 3장 | `BatteryIndicator.qml` |
| 기체 선택·지원 | 기체 선택, 다중 기체 패널 스위치, 지원 전달 상태 | 3장 | `MultiVehicleSelector.qml`, `APMSupportForwardingIndicator.qml` |
| 비행 조작 | 이륙·착륙·복귀·일시정지·고도·속도 확인, 추가 동작 | 4장 | `GuidedActionsController.qml`, `GuidedActionConfirm.qml`, `GuidedValueSlider.qml` |
| 지도 | 중심 선택과 좌표 입력, 지도 클릭 메뉴, 고급 메뉴, 이동·홈·ROI 확인, 참고 마커 | 5장 | `CenterMapDropButton.qml`, `FlyViewMapClickDropPanel.qml`, `ReferenceMarkerButton.qml` |
| 센서 | 자이로·지자기·가속도·수평 보정의 시작 화면, 재부팅 버튼 | 6장 | `FlyViewQuickSettingsPanel.qml` |
| 안전 | 제한구역, 접근·우회, 통신 두절, 배터리, 복귀, 숫자 편집·한도 경고 | 6장 | `FlyViewQuickSettingsPanel.qml`, `FactSliderEditor.qml` |
| 짐벌 | 조작·설정의 전체 스크롤 영역, 마운트 변경 펼침 | 6장 | `FlyViewQuickSettingsPanel.qml` |
| 로그·LED | 수신·추가 항목·빈/선택된 저장 로그·내보내기/삭제 승인·기체 로그, LED 모드와 색상 | 6장 | `FlyViewLogPanel.qml`, `FlyViewLEDDropPanel.qml` |
| 카메라 | 동영상·사진, 해상도·프레임률·비트레이트 선택, 변경 확인 | 7장 | `FlyViewCameraPanel.qml` |
| 표적 | 수동 추적·손실 표적·유지·지도, AI 설정 | 7장 | `DetectionTargetPanel.qml`, `DetectionSettingsPanel.qml` |
| HUD | 프리셋, 선택 요소, 위젯 전체 목록, 모양·격자 | 7장 | `HudEditorControls.qml`, `GlassCockpitOverlayModel.qml` |
## 로고 메뉴의 상세 설명과 탐색 추가
2026-09-18 개정. 목차는 장·절로 단순화했고 세부 항목은 절 내부 링크로 이동합니다. 모든 현재 그림에는 번호와 항목명을 표시하고 바로 아래 번호별 설명으로 연결했습니다. 센서·안전·짐벌 조작·짐벌 설정·로그 수신·LED·HUD는 전체 내용을 펼친 긴 그림으로 합쳤습니다. 기존 하위 제목의 링크 주소는 유지합니다.
| 로고 목적지 | 세부 설명 | 주요 근거 | 그림 상태 |
| ------ | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |
| 비행 | 2–7장, 상태·동작·지도·빠른 설정·촬영·표적·HUD | `FlyView`와 toolbar 및 관련 컨트롤러 | 기존 메뉴 그림 유지, 번호 전체 화면 추가 |
| 계획 | 9장, 파일 6개 동작·임무·경로점·촬영 패턴의 카메라/지형/프리셋·제한구역·대체 착륙점·업로드 안내 | `PlanView`, `PlanViewToolBar`, `PlanViewRightPanel`, 각 ItemEditor와 `CameraCalc*`, `TransectStyleComplexItem*` | 계획 전체와 시작·이륙·경로점 편집 그림, 9.2–9.10 단계별 경로 설계·위치 입력·고도 그래프·경고·.plan 파일 |
| 갤러리 | 10장, 파일 선택·제목 변경·직접 삭제·재생·촬영 정보·보안 내보내기·전체 초기화 | `GalleryView`, `GalleryResetDialog`, `MediaGalleryManager` | 사진·영상·촬영 정보·보안 내보내기·초기화 5개 그림 추가 |
| 기체 설정 | 11장, ArduPilot 멀티콥터 구성 전체와 조건부 장비, 공통 짐벌·조이스틱·스크립팅·파라미터·펌웨어 | `SetupView`, `APMAutoPilotPlugin`, 각 Component와 `ParameterEditor`, `FirmwareUpgrade`, `EostFirmwarePanel` | 11.1–11.16의 16개 페이지 그림 추가. 장비 조건부 항목은 별도 표시 |
| 앱 설정 | 12장, `SettingsPagesModel`에 등록된 일반·관리자 페이지와 하위 탭 | `SettingsPagesModel`, 각 AppSettings QML, `AppLogging`, `Viewer3DSettings`, `MicrohardChannelControls` 등 | 원격 ID·개발용 페이지 제외. 12.16에 사용자 ID 생성·생성 결과·삭제·삭제 결과 그림과 절차 추가 |
| 시간 동기화 | 13장, 표의 전체 항목·대기/실패·RTC·창 닫기 | `TimeSyncStatusTable`, `TimeSyncManager::rows` | 기존 상태 표 예시 활용 |
| 종료 | 14장, 통합 확인창의 네 가지 조건·예/아니요 | `MainWindow::showExitConfirmation`, `requestApplicationClose`, `finishCloseProcess` | 미저장 임무·기체 연결 상태가 있는 종료 확인창 추가 |
앱 설정의 이전 파일이 남아 있더라도 현재 메뉴에서 열 수 없는 페이지는 현행 메뉴로 설명하지 않습니다. 예를 들어 지형 관심 영역 준비 편집기와 이전 통신모듈 네트워크 편집기는 일반 앱 설정 메뉴와 구분했습니다. 메뉴별 소스·본문 대응은 `tools/page-coverage.json`에서 확인할 수 있습니다.
기체 설정의 동적 파라미터 이름·선택지는 기체가 제공하므로 모든 기체에 고정된 목록으로 서술하지 않습니다. 이 개정의 기체 설정 본문은 ArduPilot 멀티콥터와 명시한 조건부 구성 기준이며, 다른 펌웨어·고정익·수중 기체의 전체 조작 절차를 실기체에서 검증한 것은 아닙니다.
## 아직 ‘모든 상태의 그림 완료’로 처리하지 않은 항목
다음은 현재 본문에서 기능을 설명했더라도 별도 상태 그림을 모두 갖추지는 않은 항목입니다. 이 초안을 전체 UI 문서 완성본으로 표시하지 않습니다.
| 항목 | 추가로 필요한 그림 또는 확인 |
| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 전체 비행 화면 | 원본 FlyView 배치의 1600×1000 논리 픽셀 지상 대기 화면입니다. 현재 그림 2-1은 25개 번호와 영상 30 fps·4.00 Mbps와 Microhard RSSI −60·SNR 22·BW 8·2445 MHz 예시를 표시합니다. 영상 중심 배치·비행 중 전체 화면과 실제 배포 화면의 대조는 미실시입니다. |
| 보정 진행·결과 | 지자기 구면 진행, 6면 가속도 진행, 완료·실패·취소 대기·재부팅 필요 상태 |
| 선택 기능 | 제품별 비행 전 점검표, 3D 보기, 다중 기체 명령 패널의 별도 상세 장 |
| 지도 추가 편집 | 선회 원 편집, 이미 설정된 ROI의 위치 편집·해제 메뉴, 엔진별 영상/지도 배치 전환 |
| 짐벌 세부 상태 | 속도 모드, 제어권 경쟁, 보정 진행 안내, 마운트 변경 결과·재부팅 |
| 예외·권한 상태 | 각 패널의 명령 거절·타임아웃·연결 끊김·권한 부족·장치 미지원 상태 전부 |
| 목록의 모든 선택지 | 실제 기체가 제공하는 동적 모드·파라미터·장비 선택지. Microhard 배포 슬롯 8개는 3.12 그림에 모두 표시 |
| 주요 화면의 추가 상태 | 새 페이지 그림은 추가했습니다. 계획의 패턴·제한구역·랠리 편집, QVM 하위 탭, Microhard 관리 탭, 기타 조건부 확인창의 모든 상태 그림은 별도 확장 대상입니다. |
## 그림 검증과 한계
* 제품 실행파일을 빌드하거나 기체·계정·통신장비를 연결하지 않았습니다.
* 원본 QML과 한국어 번역을 문서 렌더러에서 읽고, C++ 객체 대신 정적인 표시용 객체를 공급했습니다. 실제 기체 명령·로그 파일 작업·인증은 실행되지 않습니다.
* 기본 위젯, 아이콘, 색상을 원본에서 읽습니다. 문서용 글꼴 크기·창 크기·예시값은 fixture에서 정합니다. 숨겨진 컴포넌트를 읽기 위한 접근 속성은 렌더링 사본에만 추가합니다.
* 실제 운용 동작을 시험했다는 의미가 아닙니다. 설명은 QML의 이벤트 연결 및 관련 컨트롤러 소스에 근거합니다.
* 본문 그림의 경로·해시·필수 출처를 검사하고, 그림 모음에서 잘림과 빈 화면을 확인합니다. 출처 요약은 `assets/ui/provenance.json`에 저장합니다.
* Qt 렌더러의 글꼴 별칭 안내, 원본 QML의 구식 Connections 문법 안내, QtMultimedia 시작·오디오 장치 조회 안내는 문서 데이터 누락 오류와 구분합니다.
* 전체 비행 화면의 지도는 내려받은 OSM 래스터 타일과 QtLocation itemsoverlay로 구성합니다. 제품의 지도 엔진·영상·3D·다중 기체 실행 경로를 시험하지 않았습니다. 자세한 대체 범위는 `MAINTAINING.md`에 기록합니다.
## 이번 수정의 확인 항목
* 미연결 기체 절과 그리퍼 절을 삭제하고 뒤 절과 그림 번호를 다시 정렬했습니다. 기존 3.13 통신모듈은 현재 3.12입니다.
* 운용 슬롯의 8개 주파수·8 MHz 대역폭은 배포 설정에서 확인했습니다. 송신·수신 변조의 `16-QAM 3/4 FEC`는 pMDDL 운영 매뉴얼의 지원 선택값에서 가져온 예시입니다.
* 센서 보정·재부팅 1.5초, 기본 비행 확인 0.5초, 지도 길게 누르기 0.6초, 영상 수동 추적 0.5초와 조이스틱 설정별 시간을 코드에서 확인했습니다.
* 미션 예제는 파일 구조와 명령 순서를 검사합니다. 기체 업로드·실제 비행은 검증 범위에 포함하지 않습니다.
## 경로 설계·고도 검토·EOST·사용자 ID 개정
* 경로점 3개를 하나씩 추가하고 복귀까지 만드는 상태를 각각 그림으로 구성했습니다. 위치 편집과 지형 최고점·최저점, 충돌·데이터 없음·조회 중·업로드 선택창을 포함합니다.
* EOST 원본 QML에서 파일 선택·브리지 속도 변경 대기·전송 응답 상태를 렌더링했습니다. 실제 펌웨어 전송은 하지 않았습니다.
* 기존 12.14 원격 ID를 제외해 뒤 절 번호를 한 칸 당겼습니다. 기존 12.17은 12.16입니다.
* 계정 생성은 일반 사용자 생성이며, 삭제 버튼의 기본 지연 시간은 500 ms입니다. 실제 계정을 변경하지 않았습니다.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.uvify.com/ui-coverage.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.