빠른 시작 가이드
이 가이드는 Archyl에서 몇 분 만에 첫 번째 아키텍처 다이어그램을 만드는 방법을 안내합니다.
1단계: 계정 만들기
- app.archyl.com으로 이동합니다
- 이메일로 가입하거나 GitHub, GitLab 또는 Bitbucket으로 연결합니다
- 이메일로 가입한 경우 이메일을 인증합니다
2단계: 첫 번째 프로젝트 만들기
- 대시보드에서 **"새 프로젝트"**를 클릭합니다
- 프로젝트 이름을 입력합니다 (예: "내 이커머스 플랫폼")
- 선택적으로 설명과 태그를 추가합니다
- **"프로젝트 만들기"**를 클릭합니다
3단계: 첫 번째 시스템 추가
- 새 프로젝트에서 시스템 컨텍스트 레벨로 시작합니다
- "+" 버튼을 클릭하거나 캔버스에서 우클릭합니다
- **"시스템 추가"**를 선택합니다
- 이름을 입력합니다 (예: "이커머스 플랫폼")
- 시스템이 하는 일에 대한 설명을 추가합니다
4단계: 외부 시스템 추가
실제 시스템은 독립적으로 존재하지 않습니다. 소프트웨어가 상호작용하는 외부 시스템을 추가하세요:
- **"+"**를 클릭하고 **"외부 시스템 추가"**를 선택합니다
- "결제 게이트웨이", "이메일 서비스", "CDN" 등의 시스템을 추가합니다
- 외부 시스템임을 나타내는 다른 스타일로 표시됩니다
5단계: 관계 만들기
시스템 간 통신 방식을 보여줍니다:
- 소스 시스템을 클릭합니다
- 연결 지점에서 대상 시스템으로 드래그합니다
- 관계를 설명하는 라벨을 추가합니다 (예: "API를 통해 결제 처리")
6단계: 컨테이너로 확대
메인 시스템을 더블 클릭하여 컨테이너 레벨로 들어갑니다:
- "웹 애플리케이션", "API 서버", "데이터베이스" 등의 컨테이너를 추가합니다
- 서로 간의 통신 방식을 보여줍니다
- 외부 시스템에 연결합니다
다음 단계
축하합니다! 첫 번째 아키텍처 다이어그램을 만들었습니다. 다음으로 탐색할 내용입니다:
- 저장소 연결 - AI가 자동으로 아키텍처를 발견하게 하기
- AI 디스커버리 - AI가 코드베이스를 분석하는 방법 알아보기
- 팀 협업 - 팀원 초대하기
- 내보내기 및 공유 - 이해관계자와 다이어그램 공유하기
성공 팁
- 높은 수준에서 시작하세요: 세부 사항에 들어가기 전에 시스템 컨텍스트부터 시작하세요
- 명확한 이름을 사용하세요: 시스템과 컨테이너에 설명적인 이름을 지으세요
- 설명을 추가하세요: 미래의 여러분(그리고 팀)이 감사할 것입니다
- 반복하세요: 아키텍처 문서는 살아있는 것입니다 - 시스템이 발전함에 따라 업데이트하세요