설치 마법사

• 경로: /setup
• 라우트 이름: setup
• 컴포넌트: apps/web-ui/src/pages/SetupPage.vue
• 권한: 공개 (단, 설치 완료 후 접근 시 /로 리다이렉트)

개요

처음 배포된 인스턴스를 초기화하기 위한 단계별 마법사입니다. 백엔드 /api/v1/setup/status가 미완료를 반환하면 모든 라우트 요청이 자동으로 /setup으로 리다이렉트됩니다.

단계

Step	제목	내용
0	Supabase 연결	URL / anon key / service key 입력, 스키마 상태 확인 (/api/v1/setup/schema-status), 테이블별 SQL 가이드
1	관리자 계정	첫 super_admin 계정 생성 (이메일 / 비밀번호)
2	사이트 기본 설정	사이트명, 로고, 기본 언어, 점검 모드 등
3	시스템 에이전트 설정	기본 에이전트·MCP·LLM 등록 (스킵 가능)
4	최종 확인	입력 요약 후 설치 완료 처리

• Step 3은 agentSetupSkipped 플래그로 건너뛸 수 있으며, 인디케이터에서 별도 표시됩니다.
• 모든 단계는 백엔드(/api/v1/setup/*)와 통신해 영속화됩니다.

연계

• 백엔드: /api/v1/setup/status, /setup/schema-status, /setup/item-sql/{name}, 단계별 저장 엔드포인트
• 스토어: setup
• 라우터 가드: router/index.ts에서 setup.checkStatus()로 진입 여부 결정