버전 관리

모든 변경 사항은 Proyecta가 관리하는 비공개 GitHub 저장소에 commit됩니다. builder 툴바의 버전 드롭다운을 사용하여 이전 스냅샷을 탐색하고 전환할 수 있습니다.

AI가 앱에 가하는 모든 변경 사항은 Proyecta가 관리하는 비공개 GitHub 저장소에 commit됩니다. 코드는 builder에서 언제든지 접근하고 내보낼 수 있습니다.

버전 히스토리

builder 툴바의 버전 드롭다운을 사용하여 스냅샷 간에 전환할 수 있습니다. 모바일에서는 More 메뉴를 통해 버전 히스토리에 접근할 수 있습니다. 이전 버전을 보는 중에는 버전 배너에서 Open history를 클릭하여 전체 버전 목록을 확인할 수 있습니다. 각 버전에는 다음 정보가 표시됩니다:

버전 번호 (예: “v12”)
레이블 (예: 초기 frontend 전용 스냅샷의 경우 ‘v1 (pre-cloud)’, 반복 버전의 경우 공백)
사용자의 로케일 기준 생성 타임스탬프
git commit 해시의 앞 7자리

이전 버전 열기

버전 카드를 클릭하면 해당 스냅샷이 미리보기로 열립니다. 이전 버전은 읽기 전용 모드로 열리며 — 코드와 미리보기를 확인할 수 있지만, 이전 버전 뷰 안에서는 편집할 수 없습니다.

이전 버전을 탐색하는 동안 툴바 아래의 배너에 “Viewing version N in read-only mode.” 가 표시됩니다. 배너에서 Return to latest를 클릭하면 현재 작업 상태로 돌아가 편집을 재개할 수 있습니다.

아직 아무것도 편집하지 않은 경우, 시트에는 “No snapshots yet — versions are created automatically after builder turns that commit changes.” 라고 표시됩니다.

실제로 어떻게 되돌리나요?

버전 히스토리 시트에서 원클릭으로 되돌리는 기능은 로드맵에 있습니다. 현재는 두 가지 방법을 사용할 수 있습니다:

AI에게 요청하기 — "Revert the last change", "Go back to how the homepage looked in version 6", "Undo everything from the last three commits". AI가 히스토리를 읽고 역방향 commit을 대신 적용해 줍니다.
터미널에서 git 사용하기 — 정밀한 제어가 필요한 경우:

# View recent commits
git log --oneline -20

# Revert a specific commit (creates a new commit undoing it)
git revert <commit-hash>

# Or reset to a specific point (destructive)
git reset --hard <commit-hash>

GitHub

프로젝트 코드는 Proyecta가 관리하는 비공개 GitHub 저장소에 저장됩니다. builder 내부의 코드 에디터에서 직접 코드에 접근하거나 내보낼 수 있습니다. 자신의 GitHub 조직을 연결한 경우, 저장소는 해당 조직에 생성됩니다.

자주 묻는 질문

각 버전에는 무엇이 포함되나요?

코드 변경 사항, 설정 업데이트, 스키마 수정 사항 — git에 저장되는 모든 것이 포함됩니다. 저장소 외부에 저장된 에셋(업로드된 파일, 데이터베이스 레코드 등)은 버전 관리되지 않습니다.

branch를 만들 수 있나요?

네. 터미널에서 branch를 생성하고 전환할 수 있습니다: git checkout -b feature/new-homepage. AI는 현재 체크아웃된 branch에 commit합니다.

팀원들과 협업하려면 어떻게 하나요?

여러 팀원이 GitHub의 동일한 저장소에 접근할 수 있습니다. 협업에는 표준 git 워크플로(branch, pull request)를 활용하세요.

곧 추가될 기능

원클릭 되돌리기 — 이전 스냅샷과 동일한 새 버전을 생성하는 버전 히스토리 시트의 “Revert to this version” 버튼
커스텀 버전 태그 — 나중에 쉽게 찾을 수 있도록 개별 버전에 이름 지정