Spective 핸드오프 문서
이 문서는 Spective(PBD 진단 플랫폼)를 인수인계받는 개발·운영 담당자를 위한 안내서입니다. 위에서 아래로 읽으면 시스템 이해 → 로컬 실행 → 인프라 → 배포 → 운영 → 권한 이전 순서로 온보딩됩니다.
목차
| # | 섹션 | 핵심 질문 |
|---|---|---|
| 0 | (이 문서) 핸드오프 개요 | 무엇을, 어떤 순서로 인계하는가 |
| 1 | 시스템 개요 | 이 제품은 무엇인가 |
| 2 | 아키텍처 | 어떻게 만들어졌는가 |
| 3 | 개발 환경 셋업 | 어떻게 로컬에서 돌리는가 |
| 4 | 인프라 & 환경 | 어디서 돌아가는가 |
| 5 | 배포 & 릴리스 | 어떻게 배포하는가 |
| 6 | 운영 런북 | 어떻게 살아있게 유지하는가 |
| 7 | 보안 & 접근 권한 이전 | 무엇을 넘겨받아야 하는가 |
| 8 | 도메인 지식 심화 | 비즈니스 로직을 어떻게 이해하는가 |
| 9 | 알려진 이슈 · 함정 | 무엇을 조심해야 하는가 |
| 10 | 부록 | 치트시트 · 링크 · FAQ |
인계 개요
- 인계 일정: 2026-06-03 시작 (완료 목표일 미정)
- 현 담당자(인계자): 이민수 (Minsu Lee, GitHub @amondnet) / minsu.lee@passionfactory.ai / CTO·백엔드·인프라 (열정팩토리)
- 인수 주체: 알렉스앤앨리스 주식회사 (서비스 소유사) — 담당자 미정
- 인계 범위: 개발 + 운영 (둘 다)
- 인계 형태: 열정팩토리(개발사) → 알렉스앤앨리스(소유사)에게 소스코드 + prod 운영 지식 전달. dev 환경·CI 인프라(GitHub/AWS)는 열정팩토리 잔류(dev는 일정 기간 후 폐기), prod는 이미 알렉스앤앨리스 소유. 상세 §7.1.
인계 체크리스트
인계 완료의 정의입니다. 각 항목은 인수자가 직접 검증한 뒤 체크합니다.
A. 접근 권한 이전 (→ 7장)
prod·외부서비스 계정(GCP prod·Cloudflare·토스PG·Resend·Supabase·도메인)은 이미 알렉스앤앨리스 소유라 별도 이전 없음 — 알렉스앤앨리스 자체 처리. 열정팩토리가 실제로 넘기는 것은 아래뿐. 상세 §7.1.
- [ ] 소스코드 전달 (GitHub 권한 이전 아님 — 코드 사본 형태)
- [ ] prod 접근 권한 이양 — 현재 이민수 단독 → 알렉스앤앨리스 담당자
- [ ] dotenvx 복호화 키(
.env.keys) 전달 (Bitwarden 공유 볼트 + GCP Secret Manager 권한 위임, §7.2)
dev 환경·CI 인프라(GitHub/AWS)는 열정팩토리 잔류(dev 폐기). prod·외부서비스는 알렉스앤앨리스가 이미 보유.
B. 지식 전달 (→ 각 장)
- [ ] 로컬 환경 구동 성공 (3장)
- [ ] dev 배포 1회 직접 수행 (5장)
- [ ] 운영 런북 walkthrough (6장)
- [ ] 장애 대응 시나리오 리허설 (6장)
- [ ] 알려진 이슈/함정 리뷰 (9장)
C. 검증 완료
- [ ] 인수자 단독으로 dev → prod 배포 수행 가능
- [ ] 인수자 단독으로 배치 작업 점검 가능
- [ ] 최종 인계 확인 서명: 인계자 __ / 인수자 __ / 일자 __