빌더

빌더 구조와 작업 영역

현재 Studio 진입점과 연구 설정·수집·디자인 작업 영역입니다.

기준일
이 페이지에서

빌더는 연구 앱의 구성을 다루는 데스크톱 작업 영역입니다. 현재 renderer는 main.tsx에서 시작하며 기본 창은 StudioShell, #settings 창은 SettingsWindow를 표시합니다. 이 진입 경로를 기준으로 화면 구조를 확인해야 합니다.

작업 영역

ActualVersionPreview.tsx의 주요 탭에는 연구 설정, 수집, 디자인이 정의되어 있습니다. StudioShell은 프로젝트 상태, 연구 설정 검토, 수집 구성, 화면 미리보기와 대화 영역을 연결합니다.

영역확인할 내용
연구 설정연구 목적과 참여 조건 등 설정 초안 및 검토 상태
수집수집 구성과 실행 미리보기, 관련 수정 상태
디자인연구 앱의 화면과 표현을 구성하는 작업

화면의 미리보기와 참여 기기에서의 실제 수집은 구분해야 합니다. 권한·백그라운드 실행·건강 데이터 제공 조건은 Android 권한 문서에서 확인합니다.

저장과 적용을 읽는 방법

renderer는 preload의 window.api를 통해 프로젝트 상태 조회·수정 요청을 전달합니다. StudioShell에는 수정 중인 초안, 저장 중 상태, 오류 상태를 다루는 경로가 있습니다. 현재 화면에 보이는 초안과 저장·적용된 결과를 같은 것으로 해석하지 않아야 합니다.

기본 창 종료 전에는 main.tsx에서 flushAllDrafts를 호출하고 성공 또는 실패를 메인 프로세스에 알립니다. 이 동작만으로 모든 외부 실행이나 배포가 완료됐다고 볼 수는 없습니다.

문서를 확장할 때

설치·프로젝트 생성·수집 규칙·미리보기·빌드 가이드는 실제 사용자 흐름을 확인한 뒤 별도 문서로 확장할 수 있습니다. 현재 페이지는 구조를 파악하기 위한 진입 문서입니다. 모든 화면을 순서대로 따라 하는 사용 매뉴얼은 아직 포함하지 않습니다.

에이전트의 역할과 프롬프트 구성은 에이전트 문서를 참고하세요. 기존 단계형 화면과 호환 경로를 현재 기본 Studio 화면으로 혼동하지 않는 것이 중요합니다.

컴포넌트 참고 자료

컴포넌트 카탈로그에서 연구 앱 화면을 구성할 때 참고할 컴포넌트 자료를 확인할 수 있습니다. 외부 참고 사이트이며, Android에서 사용할 때는 현재 JSON 노드·renderer·바인딩 구현과 함께 확인하세요.

참고 사이트는 현재 ChatGPT 로그인이 필요합니다.

문서 근거

현재 작업 트리 기준 · 소스 경로 · HEAD 8213e6b7

  • app-electron/src/renderer/src/main.tsx
  • app-electron/src/renderer/src/studio/StudioShell.tsx
  • app-electron/src/renderer/src/studio/ActualVersionPreview.tsx
DTRAC Project연세대학교 · 이봉신 연구팀