로봇 <-> 서버 연동 기능 명세서 요약

[iinow]

• 중앙에서 제어 명령을 내리도록
• 로봇 -> 서버 로 보낼 때는 음성 데이터만 영상 데이터는 안 됨 (처리가 너무 오래 걸림)
• 오케스트레이어에서 고수준으로 다른 어댑터로 명령을 내릴 때는 어댑터 자체적으로 저 수준으로 변환하여 로봇으로 명령을 내림

로봇 <-> 서버 연동 기능 명세서 요약

1. 전체 기능 요약

구분	기능	설명	서버가 받아야 할 데이터	서버가 내려줄 데이터
상태 관리	로봇 상태 수집	로봇의 기본 운영 상태를 수집	로봇 ID, 연결 상태, 배터리, 모드, 위치, 속도, 센서 상태, 오류 코드	-
언어 인터랙션	음성 입력 수집	사용자 발화 및 STT 결과 수신	세션 ID, 음성 데이터, STT 텍스트, 발화 시각, 신뢰도, 화자 정보	-
언어 인터랙션	대화 처리	발화 의도 분석 및 문맥 관리	발화 텍스트, 대화 이력, 사용자 식별자, 로봇 상태	intent, 응답 텍스트, 제어 요청
언어 인터랙션	응답 전달	서버 응답을 로봇이 출력	-	응답 텍스트, TTS 여부, 출력 타입, 우선순위
따라가기	대상 추적 상태 수집	추종 대상 인식 및 추적 상태 관리	대상 ID, 상대 거리, 상대 각도, 추적 상태, 추적 신뢰도	재탐색 요청, 정지 요청
이동 관리	이동 상태 수집	로봇 이동 상태 모니터링	위치, 속도, 방향, 경로, 목표 지점, 이동 상태	이동, 정지, 재개 명령
안전 관리	장애물/위험 감지	충돌 위험 및 장애물 대응	장애물 거리, 방향, 위험도, 충돌 위험 여부	긴급 정지, 회피 요청
제어 기능	서버 명령 전달	서버가 로봇 행동을 제어	명령 실행 결과, ACK, 실패 사유	따라가기 시작/중지, 목적지 이동, 정지, 재개, 모드 변경

---

2. 로봇 -> BE 서버로 받아야하는 데이터

기능 영역	필수 데이터
로봇 상태	로봇 ID, 연결 상태, 배터리, 충전 여부, 현재 모드, 위치, 속도, 센서 상태, 오류 코드
음성/대화	세션 ID, 음성 데이터 또는 STT 텍스트, 발화 시작/종료 시각, 신뢰도, 화자 정보
대화 처리	사용자 식별자, 대화 이력, intent, slot 정보, 대화 상태
추종 기능	대상 ID, 상대 거리, 상대 각도, 추적 상태, 추적 신뢰도, 대상 상실 여부
이동 기능	현재 위치, 이동 속도, 목표 속도, 방향, 목표 지점, 경로, 이동 상태
안전 기능	장애물 여부, 장애물 거리/방향, 위험도, 충돌 위험 여부, 안전 정지 상태
운영/에러	이벤트 ID, 이벤트 타입, timestamp, severity, 오류 코드, 오류 메시지

• 이족보행 기능

---

3. BE 서버 -> 로봇에 내려줄 데이터

기능 영역	명령 항목
대화 제어	응답 텍스트, TTS 실행 여부, 화면 출력 문구, 제스처/LED 제어
추종 제어	따라가기 시작, 따라가기 중지, 특정 대상 재탐색
이동 제어	목적지 이동, 일시정지, 재개, 정지
안전 제어	긴급 정지, 회피 명령
운영 제어	모드 변경, 초기화, 상태 재전송 요청

---

4. 이벤트 목록 (있다면)

이벤트명	설명
robot_connected	로봇 연결 성공
robot_disconnected	로봇 연결 해제
robot_status_updated	로봇 상태 갱신
battery_low	배터리 부족
voice_detected	사용자 음성 감지
stt_completed	음성 인식 완료
intent_detected	사용자 의도 분석 완료
response_dispatched	로봇 응답 전달 완료
follow_target_acquired	추종 대상 확보
follow_target_lost	추종 대상 상실
navigation_started	이동 시작
navigation_paused	이동 일시정지
navigation_stopped	이동 정지
obstacle_detected	장애물 감지
collision_risk_detected	충돌 위험 감지
emergency_stop	긴급 정지 수행
error_occurred	오류 발생

---

5. MVP 기준 최소 명세

구분	최소 필요 항목
상태 관리	로봇 ID, 연결 상태, 배터리, 현재 모드, 오류 코드
언어 인터랙션	세션 ID, STT 텍스트, intent, 응답 텍스트
따라가기	대상 ID, 상대 거리, 추적 상태, 추적 신뢰도
이동	위치, 속도, 이동 상태
안전	장애물 감지 여부, 충돌 위험 여부, 긴급 정지
제어	따라가기 시작/중지, 정지, 재개, 응답 출력

---

6. 비기능 요구사항 요약

항목	요구사항	우선 순위
실시간성	상태/이벤트가 실시간 또는 준실시간 반영되어야 함
신뢰성	연결 끊김, 명령 실패, 오류 발생 여부를 추적할 수 있어야 함
안전성	충돌 위험 시 긴급 정지가 최우선 처리되어야 함
보안성	로봇-서버 간 인증 및 명령 권한 검증 필요	낮음
확장성	향후 안내, 순찰, 디스플레이 인터랙션 기능 확장 가능해야 함

---