"개발 끝났습니다. 수고하셨어요!"

이 말을 듣고 안도하며 잔금을 지급했는데... 몇 달 뒤 문제가 생겼어요. 서버 접속은 어떻게 하지? 코드를 수정하려는데 문서가 없네? 그 개발사는 연락이 안 되고...

인수인계를 제대로 안 받으면 내 돈 주고 만든 서비스인데 내 맘대로 못 하는 황당한 상황이 벌어집니다.

인수인계, 왜 중요한가요?

외주 개발은 끝이 아니라 시작이에요. 출시 후에도 이런 일들이 필요합니다:

버그 수정 및 기능 개선
서버 장애 대응
보안 업데이트
다른 개발사로 유지보수 이관

이때 필요한 자료가 없으면? 처음부터 다시 분석해야 하거나, 최악의 경우 새로 만드는 게 나을 수도 있어요.

실제 사례: 인수인계 없이 개발사가 폐업해서 서버 접속 정보를 몰라 서비스가 3일간 마비된 스타트업이 있었습니다.

필수 인수인계 항목 체크리스트

1. 소스코드 일체

단순히 "코드 줬어요"가 아니라, 동작 가능한 전체 코드를 받아야 해요.

받아야 할 것들:

항목	설명	확인 방법
프론트엔드 코드	웹/앱 화면 소스	빌드 가능 여부 테스트
백엔드 코드	서버/API 소스	로컬 실행 테스트
데이터베이스 스키마	DB 구조 정의	SQL 파일 또는 마이그레이션
환경 설정 파일	.env 예시 파일	필요한 키 목록

중요: 코드를 받으면 반드시 직접 빌드해서 실행해보세요. "코드는 줬는데 안 돌아가요"를 방지할 수 있습니다.

2. 계정 및 접속 정보

프로젝트에 사용된 모든 서비스의 접속 정보가 필요해요.

필수 계정 목록:

서비스	필요한 정보
서버 (AWS, GCP 등)	루트/IAM 계정, SSH 키
데이터베이스	호스트, 포트, 계정/비밀번호
도메인	관리자 계정, DNS 설정 정보
앱스토어 (iOS)	Apple Developer 계정
플레이스토어 (Android)	Google Play Console 계정
외부 API	결제, 본인인증, 푸시 등 API 키
모니터링	Sentry, Firebase 등 접속 정보

계정을 개발사 명의로 만들면 안 됩니다! 반드시 클라이언트(본인) 명의로 생성하고, 개발사에게 접근 권한만 부여하세요.

3. 기술 문서

코드만으로는 시스템을 이해하기 어려워요. 최소한의 문서가 필요합니다.

필수 문서 목록:

문서	내용	중요도
시스템 아키텍처	전체 구조도, 서버 구성	⭐⭐⭐
API 명세서	엔드포인트, 요청/응답 형식	⭐⭐⭐
DB 설계서	테이블 구조, 관계도	⭐⭐⭐
배포 가이드	빌드/배포 절차	⭐⭐⭐
환경 변수 설명	각 환경변수의 용도	⭐⭐
코드 컨벤션	코딩 규칙 (있다면)	⭐

API 명세서 예시:

POST /api/users/login
- 설명: 사용자 로그인
- 요청: { email: string, password: string }
- 응답: { token: string, user: {...} }
- 에러: 401 (인증 실패), 400 (필수값 누락)

4. 디자인 원본 파일

수정이 필요할 때 원본이 없으면 처음부터 다시 디자인해야 해요.

받아야 할 파일:

항목	파일 형식
UI 디자인	Figma 링크 또는 Sketch/XD 파일
아이콘/이미지	SVG, PNG 원본
로고	AI, SVG, PNG (다양한 크기)
폰트	사용된 폰트 파일 또는 라이선스 정보
스타일 가이드	컬러, 타이포그래피 정의

Figma는 편집 권한으로 공유받아야 해요. 뷰어 권한만 있으면 수정이 안 됩니다.

5. 운영 관련 정보

서비스 운영에 필요한 정보들이에요.

확인해야 할 것들:

관리자 페이지 접속 정보: URL, 최고관리자 계정
테스트 계정: QA용 테스트 계정들
정기 작업: 백업 스케줄, 배치 작업 목록
모니터링 설정: 알림 받는 조건, 대시보드 접속
비용 현황: 월 서버비, API 사용료 등

인수인계 프로세스

단계별 진행 방법

1. 체크리스트 공유 (개발 완료 2주 전)
   ↓
2. 1차 자료 수령 (완료 1주 전)
   ↓
3. 검증 및 보완 요청 (완료 시점)
   ↓
4. 최종 인수인계 미팅 (잔금 지급 전)
   ↓
5. 인수인계 완료 확인서 작성

인수인계 미팅에서 할 것

1시간 정도 화상/대면 미팅을 잡고 이 순서로 진행하세요:

시스템 구조 설명 (15분)
- 전체 아키텍처 훑어보기
- 주요 기술 스택 설명
배포 프로세스 시연 (15분)
- 실제로 배포하는 과정 보여주기
- 롤백 방법 확인
운영 도구 안내 (15분)
- 모니터링 대시보드
- 로그 확인 방법
- 장애 대응 절차
Q&A (15분)
- 궁금한 점 질문
- 추가 자료 요청

인수인계 완료 확인서

모든 자료를 받았다면, 서면으로 확인하세요.

[인수인계 완료 확인서]

프로젝트명: ○○○ 앱 개발
인수인계 일시: 2025년 ○월 ○일

[인수 항목]
✅ 소스코드 일체 (GitHub 저장소 이관 완료)
✅ 서버 접속 정보 (AWS 루트 계정 인계)
✅ API 명세서 (Notion 문서)
✅ DB 설계서 (ERD 다이어그램)
✅ 디자인 원본 (Figma 편집 권한)
✅ 관리자 계정 정보

위 항목에 대해 인수인계가 완료되었음을 확인합니다.

발주사: (서명)
개발사: (서명)

흔한 실수와 해결법

❌ "소스코드만 받으면 되겠지"

→ 코드만 있고 문서가 없으면, 새로운 개발자가 코드를 이해하는 데 2~4주가 더 걸립니다.

❌ "나중에 받아도 되겠지"

→ 잔금 지급 후에는 협상력이 사라져요. 잔금 지급 전에 모든 자료를 확보하세요.

❌ "개발사가 알아서 해주겠지"

→ 요청하지 않으면 안 줍니다. 체크리스트를 먼저 공유하고 요청하세요.

❌ "검증은 안 해도 되겠지"

→ 받은 코드가 실제로 빌드되는지, 문서가 정확한지 직접 확인해야 해요.

마치며

개발 완료는 끝이 아니라 운영의 시작입니다.

인수인계 핵심 정리:

소스코드: 빌드 가능한 전체 코드
계정 정보: 모든 서비스 접속 정보
기술 문서: 아키텍처, API, DB 설계
디자인 원본: Figma, 아이콘, 폰트
운영 정보: 관리자 계정, 백업 정책

그리고 가장 중요한 것: 잔금 지급 전에 모든 자료 확보!

인수인계가 제대로 되었는지 불안하신가요? 받은 자료가 충분한지 무료 진단을 통해 점검받아보세요.

Photo by Unsplash