Skip to content

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 배포 수행 가능
  • [ ] 인수자 단독으로 배치 작업 점검 가능
  • [ ] 최종 인계 확인 서명: 인계자 __ / 인수자 __ / 일자 __