환경 이전 센터

# 환경 이전 센터 ClinicOS의 **최초 핸드오프**와 **기존 개발환경 이전**을 한곳에서 안내합니다. 두 흐름은 목적과 패키지를 만드는 주체가 다르지만, 새 환경에서 계정을 다시 연결하고 실제 동작을 검증한 뒤 승인한다는 원칙은 같습니다. | 구분 | 누가 전송을 준비하나요? | 언제 사용하나요? | |---|---|---| | 최초 핸드오프 | 제작팀 | 제작이 끝난 사이트를 클라이언트가 처음 인수할 때 | | 개발환경 이전 | 기존 환경의 클라이언트 에이전트 | 새 컴퓨터·Codespace·담당자 환경으로 옮길 때 | | 장애 복구 | 복구를 맡은 에이전트 | 기존 환경을 사용할 수 없을 때 | 다운로드만으로 완료되지 않습니다. 새 환경의 GitHub·Cloudflare·ChatGPT/Codex 연결과 사이트 검증을 통과한 뒤 최종 승인해야 합니다. --- ## 1. 최초 핸드오프 제작팀이 운영 배포, 브랜드 자산, 콘텐츠, 지도, 데이터 연결 상태를 검사하고 인수 패키지를 ClinicOS HQ에 올립니다. 클라이언트는 **HQ 환경 이전 센터**에 표시된 명령으로 패키지를 내려받습니다. 인수 후에는 다음 항목을 클라이언트 본인 계정으로 연결합니다. 1. 클라이언트 소유의 비공개 GitHub 저장소 2. Cloudflare Pages·D1·R2에 접근할 Cloudflare 계정 3. ChatGPT 구독 계정과 Codex CLI 4. 관리자 비밀번호 교체 5. 홈페이지·관리자·지도·이미지·모바일 화면 검증 자동 검증이 끝나면 환경 이전 센터에서 최종 인수 승인을 진행합니다. --- ## 2. 기존 개발환경 이전 일반 ZIP이나 공개 다운로드 링크를 만들지 않습니다. 기존 환경의 에이전트가 전송 가능한 코드와 로컬 상태만 선별하고, 비밀정보를 제외한 뒤 **AES-256-GCM 암호화 일회용 묶음**을 HQ에 업로드합니다. ### 기존 환경에서 에이전트에게 다음처럼 요청합니다. ```text 환경 이전 센터로 새 컴퓨터 이전을 준비해줘. ``` 에이전트가 내부적으로 다음 절차를 실행합니다. ```bash npm run workspace:transfer ``` 30분 동안 유효한 전송 코드가 한 번만 표시됩니다. 이 코드는 인수 비밀값과 복호화 키를 포함하므로 비밀번호처럼 취급합니다. ### 새 환경에서 새 환경에서 프로젝트를 연 에이전트에게 다음처럼 요청합니다. ```text 기존 환경에서 받은 전송 코드로 개발환경을 인수하고 끝까지 검증해줘. ``` 에이전트는 대상 폴더, 도구, 디스크, Cloudflare 접근 권한을 먼저 검사한 뒤 다음 인수 절차를 실행합니다. ```bash npm run workspace:claim ``` 전송 코드는 화면에 보이지 않는 입력창에 붙여 넣습니다. 명령 인자, 파일, 채팅 로그에 기록하지 않습니다. 대상은 같은 사이트의 `owner` 또는 `workspace_move` 권한을 가진 장치여야 합니다. ### 새 환경 검증 후 새 환경에서 코드, 바인딩, 선택한 로컬 상태와 비밀정보 재인증을 확인합니다. 대상 검증이 완료된 뒤에만 기존 환경에서 다음 절차로 이전을 확정합니다. ```bash npm run workspace:transfer -- --finalize ``` 이 시점에 새 설치가 활성화되고 기존 설치 권한이 종료됩니다. 검증 전에는 기존 컴퓨터를 초기화하거나 접근 권한을 해제하지 않습니다. --- ## 3. 보안 원칙 - HQ에는 복호화 키가 없는 암호문만 저장합니다. - 전송 코드와 승인된 대상 장치 권한이 모두 있어야 인수할 수 있습니다. - 첫 인수 즉시 같은 코드의 재사용과 재다운로드가 차단됩니다. - 전송은 30분 뒤 만료되며 완료·취소 시 서버의 전송 객체를 삭제합니다. - `.env`, API 토큰, 설치 토큰, 임시 관리자 비밀번호는 전송하지 않습니다. - GitHub·Cloudflare·ChatGPT/Codex는 새 환경에서 본인이 다시 인증합니다. - 전송 코드를 메일 첨부, 단체 채팅, 화면 캡처로 공유하지 않습니다. - 로컬 D1에 환자정보가 있을 수 있으므로 명시적으로 승인한 경우에만 포함합니다. > 전송 코드가 노출되었다고 의심되면 사용하지 말고 기존 환경의 에이전트에게 즉시 취소와 > 새 전송 생성을 요청하세요. --- ## 4. 중단되었을 때 일회용 코드를 무작정 다시 소비하지 않습니다. 에이전트가 저장된 인수 상태를 진단한 뒤 재개·재시도·취소 중 하나를 선택합니다. ```bash npm run workspace:claim -- --resume npm run workspace:claim -- --retry npm run workspace:claim -- --revoke ``` 문제가 계속되면 기존 환경을 보존한 채 오류 문구와 전송 상태만 지원팀에 전달하세요. 전송 코드 자체는 전달하지 않습니다. --- ## 5. 최종 확인 - [ ] 새 환경에서 GitHub 원격 저장소와 최신 코드가 확인됨 - [ ] 새 환경에서 Cloudflare D1·R2·Pages 접근이 확인됨 - [ ] ChatGPT 계정으로 Codex CLI 로그인 완료 - [ ] Codex 이미지 생성 스모크 테스트 완료 - [ ] 로컬 빌드와 홈페이지·관리자 화면 확인 - [ ] 대상 환경 검증 완료 후 기존 환경 종료 - [ ] HQ 환경 이전 센터에서 최종 승인 또는 완료 상태 확인 관련 실행 기준은 에이전트 내장 `environment-transfer` 스킬과 `workspace-migrate` 절차가 관리합니다.