Home

제로원이그나이트 2026 — 설계 문서

자율 로봇 인터랙션 시스템의 설계·기술 검토 문서 모음입니다. 아래 순서로 읽으면 전체 구조를 빠르게 파악할 수 있습니다.

설계 문서 (읽는 순서)

#	문서	내용
1	시스템 설계	추상 아키텍처 — 도메인, 컴포넌트, 데이터 모델, 시퀀스, 안전, 캘리브레이션
2	OSS 통합	추상 설계를 Frigate / Mosquitto / Home Assistant / LangGraph / MCP로 매핑
3	서비스	서비스별 책임, 의존성, ACL, 폴백 자동화, OpenTelemetry 전파, 코드 스켈레톤
4	MQTT 스키마	모든 토픽·페이로드·QoS·retain 플래그의 단일 소스
4-1	SPOT 제어	SPOT 제어 토픽 스펙
4-2	반려로봇 제어	반려로봇 제어 토픽 스펙
4-3	로봇팔	로봇팔 토픽 스펙
4-4	오케스트레이션 서버	오케스트레이션 서버 토픽 스펙
4-5	Future Car	Future Car 토픽 스펙
4-6	Hub	Hub 토픽 스펙
4-7	Vision	Vision 토픽 스펙
5	배포	cloud-build / local-run 모델, ghcr.io 태깅, 시크릿 로테이션, 백업·복구, 하드웨어 사이징
6	개발	향후 개발 환경 — mock 어댑터, 페이즈 게이트, 코드 품질 기준
7	운영	비기술 운영자용 일일 런오브쇼 — 폴백 / e-stop 동작

기획

• 데이터 목록 정의 — 시스템이 다루는 데이터를 팀별로 명시하는 문서

논의 / 검토 자료

아래 문서는 논의용 자료이며 현재 설계 결정에 반영된 내용이 아닙니다.

• Google ADK 검토 (프레임워크·모델 비교)
• 페르소나 + 상황 카드 모델 (2차 시나리오 구동 방식)
• Mac Studio 로컬 LLM + Claude Opus 하이브리드 라우팅 전략
• 개발 일정·할 일 점검표 (단계별 진행 점검)
• 로봇 Adapter 개발 온보딩 (HA·MQTT 계정 등록, 토픽 적용, 테스트 송수신, 상태 확인)
• LG ThinQ 가전 연동 (HA 통합 · REST 데이터 취득 · 제어)

팀

• 전체 구성도 — 역할별 팀 구성