시스템 구조

웹 앱, 클라우드 제어 평면과 Host의 협력 방식을 설명합니다.

함께 작동하는 세 부분

웹 앱은 워크스페이스, 프로젝트, 작업, 세션과 결과를 보여줍니다. 클라우드 제어 평면은 멤버십, 권한, 대화 기록, 통합 상태와 전달 요청을 관리합니다. 연결된 Host는 저장소, 작업 디렉터리, 파일, 제공자 실행과 실시간 미리보기를 담당합니다.

요청 흐름

사용자가 웹 앱에서 요청을 보냅니다. 제어 평면은 권한을 확인하고 승인된 Host에 아웃바운드 보안 연결로 명령을 전달합니다. Host는 격리된 실행 환경에서 제공자를 실행하고 이벤트를 스트리밍합니다. 큰 파일과 결과물은 HTTPS로 전송하고 실시간 제어 채널은 명령, 이벤트와 메타데이터를 전달합니다.

상태 저장

대화 기록은 클라우드에 저장됩니다. 원본 작업 파일과 미리보기는 Host의 작업 영역에 있습니다. 제공자 고유 상태는 세션마다 비공개입니다. 업로드된 결과에는 별도의 객체 ID와 접근 메타데이터가 있습니다. 각 데이터는 다른 저장소와 수명 주기를 가집니다.

GitHub와 Vercel 통합은 제어 평면이 관리하고 신뢰된 원본 수집은 Host에서 합니다. 외부 푸시, Pages 게시와 배포는 실행자와 결과가 남는 명시적 동작입니다.