MINARA데이터 스튜디오
자연어로 실시간 금융 대시보드를 구축, 검토, 미리보기, 게시
🟢 입문자용. 데이터 스튜디오(Data Studio)는 읽기 전용 대시보드만 만듭니다. 거래, 이체, 지갑 연결, 개인 키 입력을 수행하지 않습니다.
데이터 스튜디오는 자연어 요청을 실시간 또는 로드 시점 금융 데이터를 사용하는 React 대시보드로 바꿉니다. 프로젝트에는 계획, 소스 코드, 검증된 빌드가 포함됩니다. 게시를 선택하면 공유 가능한 로컬 사이트도 생성됩니다.
시장 모니터, 관심 목록, 순위, 실적 표, 포트폴리오 화면, 히트맵, K선, 위험 화면, 수익률 곡선, 오더북 깊이 등 재사용 가능한 대화형 페이지에 적합합니다.
현재 작업 흐름
- 데이터 스튜디오를 열고 원하는 대시보드를 설명합니다. 참고 이미지를 첨부할 수도 있습니다.
- 입력창에서 계획 또는 자동을 선택합니다.
- Agent가 프로젝트 계획을 만들고 데이터 및 컴포넌트 계약을 확인한 뒤 소스를 작성하고 결정적 빌드와 미리보기 검사를 실행합니다.
- 미리보기, Code, 계획, 데이터 및 통계, 설정에서 결과를 검토합니다. 같은 프로젝트를 채팅으로 계속 수정할 수 있습니다.
- 미리보기가 준비되면 고정된 버전을 사용자 지정 가능한 로컬 링크에 게시할 수 있습니다.
채팅의 작업 로그와 도구 표시는 기본 Chat 모듈과 동일합니다. 성공한 turn에서는 Agent 출력 끝에 대시보드 결과 카드가 나타납니다. 이 카드에서 미리보기를 열고 프로젝트 루트로 이동할 수 있습니다.
계획 및 자동 모드
계획은 구현 전에 전체 제안을 먼저 만듭니다. 계획이 저장되면 데이터 스튜디오가 즉시 계획 탭을 엽니다. 실행을 승인하기 전에 계획과 결과물을 검토하고 수정을 요청할 수 있습니다. 승인하면 새 Agent turn이 시작되고 일반 데이터 스튜디오 도구를 사용할 수 있습니다.
자동은 구현을 즉시 시작합니다. Agent는 프로젝트에 plan.md를 저장하고 동일한 데이터, 컴포넌트, 빌드, 미리보기 검사를 수행합니다. 이후 요청에서 언제든 모드를 바꿀 수 있습니다. 계획 모드는 고정된 기본값이 아닙니다.
프로젝트 파일 및 버전
각 프로젝트는 Minara의 안정적인 workspace에 저장되며 임시 Git worktree나 런타임 디렉터리에 의존하지 않습니다. 다음 항목이 유지됩니다.
- 현재
plan.md src/아래의 생성 소스- 변경되지 않는 성공 빌드 버전과 최신 미리보기 산출물
세션에 업로드한 파일은 별도의 영구 복구 저장소에도 보관되므로 프로세스를 다시 시작한 뒤에도 이미지와 파일 참조를 사용할 수 있습니다.
Code → 프로젝트 루트에서 프로젝트 디렉터리를 열 수 있습니다. 컴포넌트 계약, 컴파일, 필수 런타임 검사를 모두 통과한 빌드만 정식 버전이 됩니다. 실패한 수정은 마지막 정상 미리보기를 덮어쓰지 않습니다.
프로젝트를 다시 열면 미리보기가 기본으로 표시됩니다. 재시작 후 소스가 있지만 미리보기 산출물이 없으면 일반 미리보기 loading 상태에서 자동 빌드를 한 번 시도합니다. 실패하면 빈 상태에 복구 버튼이 나타납니다. 계획만 있고 빌드가 없으면 빈 상태에서 계획 탭으로 이동할 수 있습니다.
데이터 접근 및 새로 고침 규칙
생성 코드는 데이터 스튜디오 SDK를 통해 허용 목록의 데이터만 요청합니다. Provider 자격 증명은 로컬 gateway 또는 publisher에 남으며 생성 소스에 포함되지 않습니다.
데이터 스튜디오는 필요한 동작에 따라 데이터 경로를 선택합니다.
- 실시간 데이터가 필요하면 모든 필수 필드를 제공하는 등록된 공개, Key 불필요 WebSocket을 우선합니다.
- Key가 필요 없는 Public API는 한 번만 로드하거나 데이터 소스가 허용하는 간격으로 폴링할 수 있습니다.
- 사용자가 직접 설정한 Key를 사용하는 API는 한 번 로드하거나 폴링할 수 있습니다.
- 지원되는 Key 기반 Provider에 로컬 Key가 없으면 Minara 데이터 포워딩으로 한 번 로드할 수 있습니다. 설정에 Minara 데이터 포워딩 사용 중으로 표시됩니다.
- Minara 데이터 포워딩은 폴링할 수 없습니다. 폴링이 필요하면 Public API 또는 사용자의 Key를 사용해야 합니다.
HTTP 데이터는 기본적으로 페이지를 열 때 한 번만 요청합니다. 자주 새로 고치는 대시보드는 간격과 사용량 안내를 표시합니다. 새로 고치는 동안 기존의 유효한 데이터를 유지하고 변경된 차트와 값만 갱신합니다. 차트 전체를 다시 마운트하거나 전체 화면 loading을 반복하지 않습니다.
데이터 및 통계에서 호출 수, 오류, 지연 시간을 확인할 수 있습니다. 설정에서는 각 데이터 소스가 공개 데이터, 로컬 Key, Minara 포워딩, 사용 불가 중 어느 상태인지 확인할 수 있습니다. API Key는 설정 → API Keys에서 통합 관리합니다.
금융 UI 및 차트 규칙
생성된 대시보드는 고정 @minara/studio primitives와 공통 차트 테마를 사용합니다. 코드를 작성하기 전에 Agent가 현재 컴포넌트 Schema와 Types를 읽습니다. 생성 후 자동 계약 검토가 알 수 없는 Prop, 필수 필드 누락, 잘못된 import, 지원되지 않는 JSX spread를 차단합니다.
컴포넌트는 일반적인 금융 질문을 다룹니다.
MetricCard,SignedValue,SparklineChart는 단일 값과 작은 추세에 사용합니다.LineChart,AreaChart,KLineChart,MixedLineBarChart,PerformanceChart는 시계열, 가격과 거래량, 성과, 낙폭에 사용합니다.HorizontalBarChart,DataTable,AssetHeatmapChart,MatrixHeatmapChart,HistogramChart는 순위, 상세 정보, 시장 지도, 상관관계, 분포에 사용합니다.OrderBookDepthChart,VolumeProfileChart,YieldCurveChart,RangeBandChart,VolatilitySurfaceChart는 전문 금융 화면에 사용합니다.
PnL, change, return처럼 방향이 있는 값은 부호와 금융 상승·하락 색상을 함께 표시합니다. 값이 바뀔 때 짧은 색상 전환을 사용하며 카드 전체를 깜박이지 않습니다. 통화와 기타 측정값에는 항상 단위를 표시하고 히트맵의 금액에도 통화 기호를 붙입니다. 색상만으로 정보를 전달하지 않습니다.
공통 테마가 축, 그리드, Tooltip, Legend, 글꼴, 간격, 상승·하락 색상, 애니메이션을 관리합니다. 생성 프로젝트는 개별 차트 option을 다시 쓰지 않고 전역 CSS의 공개 --studio-chart-* 변수를 재정의할 수 있습니다. 완성된 대시보드는 데스크톱과 390 px 모바일에서 검사되며 loading, 빈 데이터, 부분 실패, 새로 고침 상태도 확인합니다.
게시 및 공유
게시 양식은 프로젝트에서 짧은 사이트 ID를 생성합니다. 게시 전에 수정할 수 있습니다. 링크를 가진 사람은 로그인하지 않고 사이트를 열 수 있습니다.
다음 두 옵션은 기본으로 켜지며 게시 후에도 변경할 수 있습니다.
- 로컬 네트워크 접근 허용은 publisher를 LAN에 바인딩하고 이 컴퓨터의 LAN IP 주소와 publisher 포트를 사용하는 링크를 표시합니다.
- Minara 종료 후에도 사용 가능은 로컬 publisher를 계속 실행하고 이 컴퓨터에 로그인할 때 게시된 사이트를 복원합니다.
LAN 접근을 끄면 링크는 이 컴퓨터에서만 사용할 수 있습니다. 백그라운드 게시를 끄면 사이트는 실행 중인 Minara 클라이언트에 의존합니다. 게시 취소는 해당 프로젝트의 모든 링크를 취소하고 사이트 제공을 중지합니다.
게시 사이트는 로컬 또는 LAN에서 호스팅됩니다. LAN 접근을 허용해도 공개 인터넷에 노출되지 않습니다. 호스트 컴퓨터는 전원이 켜져 있고 접근 가능한 상태여야 합니다.
안전 경계
데이터 스튜디오는 허용 목록의 읽기 전용 데이터를 요청하고 자체 프로젝트 디렉터리에만 파일을 쓸 수 있습니다. 다음 작업은 수행할 수 없습니다.
- 지갑, 거래, swap, withdraw, order 도구 호출
- MetaMask, WalletConnect 또는 다른 브라우저 지갑 연결
- 생성 파일에 API Key나 기타 secret 포함
- 미리보기에서 임의의 외부 URL 요청
- 게시 대시보드에 거래 또는 자금 이동 컨트롤 추가
거래를 실행하려면 Chat, Portfolio, Trading, Strategy Studio 또는 Autopilot을 사용하십시오. 각 모듈은 자체 미리보기와 확인 게이트를 적용합니다.