← Workflow Map

설치하고 첫 화면 열기

설치 방식과 환경값을 정한 뒤 서비스가 열리는지 확인합니다. Docker 문서 기준이며, live runtime은 이 패키지에서 실행하지 않았습니다.

목적

이 lesson은 운영자·평가자가 Open Design에서 다음 판단을 안전하게 하기 위한 절차입니다.

언제 쓰나

설치하고 첫 화면 열기가 현재 목표일 때 사용합니다. 다른 목표라면 Workflow Map에서 다른 흐름을 먼저 선택하세요.

준비물

Repo 문서 또는 설치 경로를 볼 수 있어야 합니다.
필요한 경우 Docker, Node 24, pnpm 10.33.x, agent CLI 또는 API 키를 준비합니다.
이 패키지는 live 실행을 하지 않았으므로 현장 값은 실제 환경에서 다시 읽습니다.

단계별 확인

1 설치 방식 선택: Docker Compose/installer 또는 dev mode 중 하나를 정합니다.
README.md, QUICKSTART.md, docs/install-guide.md에서 요구 조건을 확인
2 토큰과 포트 준비: OD_API_TOKEN과 OPEN_DESIGN_PORT를 먼저 채웁니다.
deploy/.env.example 또는 install guide의 env 표 확인
3 서비스 기동 확인: docker compose 또는 tools-dev로 실행하고 상태를 봅니다.
docs/screenshots/deployment/docker/04-docker-compose-ps-healthy.png 같은 health 증거 확인
4 브라우저 진입: 기본 Docker 포트는 7456입니다.
http://localhost:7456 접근 경로를 확인

구체 증거

1. 설치 방식 선택 — README.md, QUICKSTART.md, docs/install-guide.md에서 요구 조건을 확인

2. 토큰과 포트 준비 — deploy/.env.example 또는 install guide의 env 표 확인

3. 서비스 기동 확인 — docs/screenshots/deployment/docker/04-docker-compose-ps-healthy.png 같은 health 증거 확인

4. 브라우저 진입 — http://localhost:7456 접근 경로를 확인

흔한 실수

토큰이 비어 있거나 포트가 충돌하면 UI 확인보다 환경값 수정이 먼저입니다.
토큰을 비워 둔 채 UI만 새로고침하거나, 포트 충돌을 앱 오류로 오해하지 않습니다.

검증 / readback

다음 질문에 답할 수 있으면 이 lesson의 기본 이해는 통과입니다.

이 흐름의 첫 입력은 무엇인가?
성공을 어떤 파일, 화면, 명령 결과, 문서 근거로 확인하는가?
다음 단계로 가기 전에 멈춰야 하는 조건은 무엇인가?

근거

README.md, QUICKSTART.md, docs/install-guide.md에서 요구 조건을 확인
deploy/.env.example 또는 install guide의 env 표 확인
docs/screenshots/deployment/docker/04-docker-compose-ps-healthy.png 같은 health 증거 확인
http://localhost:7456 접근 경로를 확인

다음 판단

브라우저 첫 화면이 열리면 “첫 디자인 산출물 만들기”로 이동합니다. 서비스가 열리지 않으면 health/logs 확인으로 돌아갑니다.

검증 경계

이 lesson은 repo/docs와 포함된 screenshot 근거의 정적 매뉴얼입니다. 실제 서버 실행, 현재 UI label, agent 인증 성공, 생성 품질은 현장 검증이 필요합니다.