Mothership
앱 올리기와 배포
빌드한 ZIP을 후보 버전으로 올리고, 공동 검증에서 검토하고, 승인된 후보만 운영에 반영해 카탈로그에 게시해요.
흐름
갈피 없이도 이 흐름 전체가 돼요. 갈피를 이으면 갈피가 보낸 소스를 Mothership이 빌드해 후보를 만들어요(소스 빌드 실행기가 필요해요). → 제품 잇기
1. 앱 추가
업무 앱 → 카탈로그 관리 → 앱 추가에 Golden Image가 만든 dist/<release>.zip을 끌어다 놓아요. 새 앱이 되거나, 같은 앱이면 새 후보 버전이 돼요. Mothership은 manifest schema, agents.sha256 증거, 안전한 asset 경로, 그리고 entry 파일이 release.artifact_hash와 맞는지 확인한 뒤 asset을 직접 저장하고 내줘요. 따로 호스팅할 것이 없어요.


올린 ZIP은 바뀌지 않는 후보예요. 공동 검증이나 운영은 아래 단계를 거쳐야 바뀌어요.
- 소스에서 빌드할 빈 앱 만들기: 소스 빌드 실행기가 설정된 Mothership에서, 갈피 프로젝트를 이어 소스로 버전을 만들 때 써요.
- 외부 백엔드 연결 · 고급: 백엔드 worker(Python/Node)를 URL과 미리 나눈 서명 키로 연결해요. 등록이
/health와/v1/handshake로 키를 확인한 뒤 게시해요. 프런트엔드 URL 등록은 지원하지 않아요(frontend_url_unsupported).
2. 버전·환경
앱을 열면 개요, 카탈로그 정보, 접근 권한, 버전·환경, 비밀값, 미리보기 탭이 있어요.


- 검토 후보로 접수 — 검토받을 버전과 바뀐 점(검토자에게 보여요)을 적어 접수해요. 이 버전이 요청하는 접근(데이터, 플랫폼 기능)이 함께 보여요.
- 공동 검증에 올리기 — 대기열 순서가 되면 올려요. 공동 검증은 한 번에 후보 하나이고, 지금 검토를 끝내거나 닫기 전에는 다음 후보가 바꾸지 못해요. 준비가 끝나면 공동 검증에서 열기로 앱을 열어 확인해요.
- 검토 결정 — 검토자가 승인 · 운영에 반영해도 돼요 또는 수정 요청과 의견을 기록해요. 결정은 지금 공동 검증에 올라간 상태에만 적용돼요.
- 운영에 반영 — 승인된 후보와, 운영 앱 설정도 같이 바꿀지 확인하고 반영해요. 반영 요청은 순서대로 처리되고, 이미 시작된 작업이 끝날 때까지 기다려요. 저장된 업무 데이터는 되돌아가지 않아요.


- 되돌리기: 운영 이전 버전으로 되돌리기로 명시적으로 요청해요. 저장소 schema 서명이 다르면 저절로 되돌리지 않고, 데이터 migration을 추측해 되돌리지 않아요.
- 검토자는 일반 구성원이어도 돼요. 그 앱의
candidate.review와 공동 검증의environment.run을 받으면 검토할 수 있어요.
3. 카탈로그 게시
카탈로그 정보에서 직원에게 보일 이름, 설명, 아이콘, 분류를 정하고 운영 카탈로그에 게시를 켜요. 게시 여부는 카탈로그에 보이는지만 바꿔요. 게시를 해제해도 앱 실행은 멈추지 않아요.
접근 권한과 비밀값
- 접근 권한: 앱을 열 수 있는 대상(구성원, 팀 공간)과 앱이 선언한 claim을 정해요.
- 비밀값: 앱 실행에 필요한 비밀값을 환경마다 넣어요. 앱 설정 JSON에는 비밀값을 두지 않아요(앱 코드가 읽을 수 있어서요).


미리보기와 환경 격리
미리보기 탭은 서버가 발급한 pv_ 키로 만든 짧은 환경이에요. TTL, 소유자, 공유 대상이 기록되고, Mothership의 새 탭에서 열려요. 공동 검증·미리보기·운영의 레코드, 파일, 지식, 작업, 실행은 서로 다른 환경 범위예요. 공동 검증과 미리보기의 커넥터는 운영 비밀값으로 넘어가지 않고, 환경마다 따로 연결해요.