산출물 예시

인수 코드 분석 보고서

착수 후 2~3주차에 전달드릴 산출물의 형태입니다. 코드를 읽지 않으셔도 무엇이 완성되어 있고 무엇이 남았는지 판단하실 수 있도록 정리합니다. 아래 수치는 형식을 보여드리기 위한 예시입니다.

앱·웹·서버 전 영역의 화면과 기능을 하나씩 확인해, 완성 / 부분 완성 / 미구현으로 분류합니다. 개발자가 아니어도 목록만 보고 남은 일을 파악하실 수 있게 만드는 것이 목적입니다.

확인한 기능86
4개 영역 전체
완성51
동작 확인 완료
부분 완성22
일부 동작 또는 오류
미구현13
코드 없음

영역별 완성도

어느 영역에 시간이 더 필요한지 한눈에 보이도록 정리합니다

백엔드 (Django)
32건
관리자 웹
25건
승객 앱 (Android)
17건
승객 앱 (iOS)
17건
기사 앱 (태블릿)
12건
완성 부분 완성 미구현
예시 기준으로는 iOS 앱의 미구현 비중이 가장 큽니다. 이런 결과가 나오면 "두 플랫폼을 동시에 맞출지, Android를 먼저 열고 iOS를 뒤에 붙일지"를 먼저 정하시는 편이 일정에 유리합니다.

기능 목록 (발췌)

실제 보고서에는 86건 전체가 같은 형식으로 들어갑니다

영역기능상태확인 내용
승객 앱회원가입 · 로그인완성정상 동작 확인
승객 앱노선 조회 · 정류장 지도완성지도 SDK 연동 정상
승객 앱실시간 차량 위치부분화면은 있으나 갱신 주기가 고정되어 실시간 반영 안 됨
승객 앱탑승 QR 인증미구현화면만 존재, 서버 연동 코드 없음
기사 앱운행 시작 · 종료완성정상 동작 확인
기사 앱승객 탑승 확인부분단건 처리만 가능, 일괄 처리 미구현
관리자 웹노선 · 배차 관리완성정상 동작 확인
관리자 웹실시간 관제 화면부분지도 표시는 되나 차량 다중 표시 시 지연
관리자 웹정산 관리신규메뉴 자리만 있음 — 신규 개발 대상
백엔드운행 이력 API완성테스트 호출 정상
백엔드정산 관련 API미구현모델·엔드포인트 모두 없음

코드가 있다고 해서 바로 돌아가는 것은 아닙니다. 각 앱과 서버를 실제로 빌드해 실행되는지부터 확인합니다. 여기서 막히면 그 자체가 첫 번째 과업이 됩니다.

빌드 · 구동 결과

전달받은 코드를 그대로 빌드했을 때의 결과입니다

대상빌드구동확인 내용
백엔드 (Django)성공정상의존성 설치 후 로컬 기동 확인
관리자 웹성공일부일부 화면에서 콘솔 오류 발생
승객 앱 (Android)성공정상에뮬레이터 구동 확인
승객 앱 (iOS)실패-인증서·프로비저닝 정보 누락으로 빌드 불가
기사 앱성공정상태블릿 실기기 확인
가장 먼저 확인이 필요한 항목
iOS 앱은 Apple 개발자 계정과 인증서가 있어야 빌드할 수 있습니다. 이전 개발사 계정으로 만들어져 있다면 계정 이관 또는 신규 발급이 선행되어야 하며, 이 절차에 시간이 걸릴 수 있어 착수 즉시 확인을 요청드립니다.

구동 로그 (발췌)

확인 과정을 그대로 기록해 남깁니다

# 백엔드
$ python manage.py migrate
  적용된 마이그레이션 24건 · 오류 없음
$ python manage.py runserver
  서버 기동 정상 (http://127.0.0.1:8000)

# 승객 앱 (Android)
$ ./gradlew assembleDebug
  BUILD SUCCESSFUL  1m 42s

# 승객 앱 (iOS)
$ xcodebuild -scheme Passenger
  error: Signing for "Passenger" requires a development team
  → Apple 개발자 계정 확인 필요

인수인계 문서가 없어도 데이터베이스에서 구조를 역으로 추출해 정리합니다. 어떤 정보가 어떻게 연결되어 있는지 그림으로 남겨두면, 이후 담당자가 바뀌어도 파악이 빨라집니다.

주요 테이블 관계 (ERD 발췌)

실제 보고서에는 전체 테이블이 포함됩니다

passenger id (PK) name, phone created_at boarding id (PK) passenger_id (FK) trip_id (FK) boarded_at trip id (PK) route_id (FK) driver_id (FK) route id (PK) name, company_id fare settlement 신규 생성 필요 정산 대상·기준 주기 협의 후 확정 1 : N N : 1 N : 1
붉은 점선으로 표시한 settlement(정산) 테이블은 현재 존재하지 않아 신규 설계가 필요합니다. 정산 대상과 산정 기준, 주기를 정해주시면 그에 맞춰 구조를 설계해 드립니다.

데이터 현황

테스트 데이터인지 실제 데이터인지도 함께 확인합니다

테이블행 수비고
passenger142테스트 데이터로 추정 (이름 패턴 반복)
route8실제 노선으로 보이나 확인 필요
trip1,204테스트 운행 기록
boarding3,881테스트 데이터
settlement-테이블 없음

분석 결과를 근거로 남은 일을 목록화하고, 각 항목의 예상 공수와 우선순위를 붙여 드립니다. 이 문서를 함께 보며 어디까지 이번에 할지 정하는 것이 다음 단계입니다.

잔여 과업35
항목
운영 필수18
없으면 운행 불가
권장11
운영 안정성 관련
예상 공수9.5
인월(man-month)

잔여 과업 목록 (발췌)

우선순위 · 공수 · 근거를 함께 표시합니다

구분과업우선순위공수사유
정산정산 데이터 구조 설계 및 API 개발필수2.0 MM신규 개발 · 요건 협의 필요
정산관리자 웹 정산 화면필수1.2 MM신규 개발
승객 앱탑승 QR 인증 서버 연동필수0.8 MM화면만 존재
승객 앱실시간 위치 갱신 방식 수정필수0.5 MM현재 실시간 아님
iOS빌드 환경 복구 및 미구현 화면 개발필수2.5 MM미구현 비중 최대
기사 앱승객 일괄 탑승 처리권장0.4 MM현장 사용성
관리자 웹관제 화면 다중 차량 성능 개선권장0.6 MM차량 증가 시 지연
운영배포 환경 정리 및 운영 매뉴얼권장0.5 MM인수인계 대비
공통테스트 데이터 정리 및 초기화선택0.2 MM운영 개시 전 필요
이 표를 기준으로 이번 계약 범위와 운영 개시 후 과제를 나눠 정하실 수 있습니다. 예시처럼 iOS 비중이 크게 나온다면, Android 우선 오픈 후 iOS를 뒤이어 여는 방안도 함께 검토해 드립니다.

본 화면은 분석 보고서의 형식을 보여드리기 위한 예시이며, 표시된 수치와 항목은 실제 코드를 분석한 결과가 아닙니다. 실제 내용은 착수 후 분석 단계에서 확정합니다.