소프트웨어 인도물 점검

1. 개요

소프트웨어 인도물 점검은 개발 사업자가 계약 또는 약정에 따라 인도해야 하는 모든 산출물을 확인하고, 그것이 요구사항에 부합하는지를 검증하는 활동이다. 소프트웨어 인도물은 단순히 프로그램 코드만 의미하는 것이 아니라, 관련 문서, 데이터, 교육 자료 등 소프트웨어 운영과 유지보수에 필요한 모든 것을포괄한다. 인도물 점감이 적절히 이루어지지 않으면, 인도된 시스템이 요구사항을 충족하지 않거나, 운영 및 유지보수에 필요한 자료가 누락되어 후속 업무에 문제가 발생할 수 있다.

소프트웨어 인도물은 프로젝트 특성과 계약 조건에 따라 다르지만, 일반적으로 다음의 범주에 속한다. 산출물 문서로는 요구사항 정의서, 분석 설계 문서, 테스트 결과서, 운영 매뉴얼, 사용자 가이드 등이 있다. 소프트웨어로는 소스 코드, 실행 파일, 데이터베이스 스크립트, 설정 파일 등이 있다. 관련 자료로는 교육 자료,的品质保修証, 라이선스 관련 자료 등이 포함된다.

감리자는 인도물 점감을 통해 다음을 확인해야 한다. 첫째, 계약에서 정한 모든 인도물이 실제로 인도되었는지. 둘째, 인도물의 내용이 요구사항을 충족하는지. 셋째, 인도물의 품질이 적절한 수준인지. 넷째, 인도물引き渡し 절차가 계약에 따라 이루어졌는지.

2. ASCII 다이어그램

인도물 범주 분류

[소프트웨어 인도물 범주 분류]

┌─────────────────────────────────────────────────────────────────────┐
│                      소프트웨어 인도물 범주                            │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│   ┌───────────────────────────────────────────────────────────┐    │
│   │                    인도물 3대 범주                          │    │
│   ├───────────────────────────────────────────────────────────┤    │
│   │                                                           │    │
│   │   ┌─────────────────┐  ┌─────────────────┐               │    │
│   │   │    산출물 문서    │  │    소프트웨어    │               │    │
│   │   ├─────────────────┤  ├─────────────────┤               │    │
│   │   │ ○ 요구사항 정의서 │  │ ○ 소스 코드     │               │    │
│   │   │ ○ 분석 설계 문서 │  │ ○ 실행 파일     │               │    │
│   │   │ ○ 테스트 결과서 │  │ ○ DB 스크립트   │               │    │
│   │   │ ○ 운영 매뉴얼   │  │ ○ 설정 파일     │               │    │
│   │   │ ○ 사용자 가이드 │  │ ○ 빌드 스크립트 │               │    │
│   │   └─────────────────┘  └─────────────────┘               │    │
│   │           │                         │                      │    │
│   │           └────────────┬────────────┘                      │    │
│   │                        ▼                                     │    │
│   │               ┌─────────────────┐                           │    │
│   │               │    관련 자료     │                           │    │
│   │               ├─────────────────┤                           │    │
│   │               │ ○ 교육 자료     │                           │    │
│   │               │ ○的品质保修証   │                           │    │
│   │               │ ○ 라이선스 자료 │                           │    │
│   │               │ ○ 타 시스템 연계 │                           │    │
│   │               │   설정 문서     │                           │    │
│   │               └─────────────────┘                           │    │
│   │                                                           │    │
│   └───────────────────────────────────────────────────────────┘    │
│                                                                     │
└─────────────────────────────────────────────────────────────────────┘

인도물 점검 절차

[인도물 점검 절차]

┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│  인도 목록  │───▶│  실물 확인  │───▶│  내용 검증  │───▶│  인수 승인  │
│  확인        │    │  (Presence) │    │ (Substance) │    │ (Acceptance)│
└─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘
      │                  │                  │                  │
      ▼                  ▼                  ▼                  ▼
 계약서 기준         항목 수량           요구사항             서면 인수
 인도물 정의         존재 여부           충족 여부            완료 확인
 확인               완전성              품질 적절성          인도 완료

3. 해석

3.1 인도물 목록 확인

인도물 점감의 첫 단계는 계약에서 정한 인도물 목록을 확인하는 것이다.

계약서 검토: 계약서, 사업 수행계획서, 작업技术水平서(SOW) 등을 검토하여 인도물 목록을抽出한다. 인도물에 대한 구체적 정의가 없을 경우, 업계 통상적인 인도물을 기준으로 삼을 수 있다.

인도 조건 확인: 각 인도물에 대한 인도 조건(예: 형식, 매수, 제출 기한 등)을 확인해야 한다. 예를 들어, "테스트 결과서는 3부 인쇄본과 1부 전자판으로 제출"과 같은 조건이 있을 수 있다.

누락 항목 파악: 계약에서 요구하는 인도물과 실제로 인도된 인도물을 대조하여 누락된 항목이 없는지를 파악해야 한다. 누락된 항목이 있으면 즉시 인도하도록要求해야 한다.

3.2 산출물 문서 점검

산출물 문서는 소프트웨어의 功能과 구조를 설명하는重要な 자료로, 다음과 같은 점을 점검해야 한다.

문서 완전성: 각 문서가 해당 단계에서 포함되어야 할 항목(目次, 章構成 등)을 빠짐없이 갖추고 있는지를 확인한다. 예를 들어, 설계 문서에는 시스템 아키텍처, 모듈 설계, 인터페이스 정의, 데이터 모델 등이 포함되어야 한다.

문서 정합성: 문서 간 내용이 서로 일치하는지를 확인한다. 예를 들어, 설계 문서와 코드 간, 설계 문서와 테스트 결과서 간에 불일치가 없어야 한다. 문서 간 정합성이 없으면 유지보수 시 혼란을 야기한다.

문서 최신성: 문서가 최종 버전을 반영하고 있는지, 변경 이력이管理되고 있는지를 확인한다. Outdated된 문서는 오히려误导가 될 수 있다.

3.3 소프트웨어 산출물 점검

소프트웨어 코드와 실행 파일 등은以下の 점을 점검해야 한다.

소스 코드 검토: 코딩 표준 준수, 적절한 주석 작성, 필요한 모듈의 존재 등을 확인한다. 코드가 의미를 파악하기 어려운 수준으로 복잡하게 작성되어 있으면 유지보수에 문제가 된다.

빌드 및 실행 가능성: 제출된 소스 코드가 실제로 빌드되어 실행 가능한지를確認한다. 빌드가 안 되는 코드는 아무런 가치가 없다.

설정 파일 및 스크립트: 빌드 스크립트, 배포 스크립트, 환경 설정 파일 등이 누락되지 않고 적절히 작성되어 있는지를 확인한다. 이러한 부재는 운영 환경 배포를 어렵게 만든다.

데이터베이스 스크립트: 테이블 생성 스크립트, 초기 데이터 로드 스크립트, 인덱스 생성 스크립트 등이 누락되지 않았는지 확인한다.

3.4 관련 자료 점검

인도물에는 소프트웨어 외에도 다양한 관련 자료가 포함되어야 한다.

교육 자료: 사용자 교육용 매뉴얼, 운영자 교육용 자료, 교육 진행 계획 등이 포함되어야 한다. 교육 자료가 없으면 시스템 도입 후 사용자와 운영 담당자가 활용 방법을 파악하기 어렵다.

라이선스 및 보증: 서드파티 소프트웨어 사용에 따른 라이선스 증서, software 대한的品质保修조건 등이 포함되어야 한다. 라이선스 문제가 있으면 법적인 분쟁이 발생할 수 있다.

유지보수 관련 자료: 시스템架构图, 네트워크 구성도, 장애 처리 절차, 비상 연락망 등이 포함되어야 한다. 이러한 자료가 없으면 유지보수팀이 시스템을 효과적으로 관리하기 어렵다.

3.5 인수 절차 및 조건

인도물 점검 후 적절한 인수 절차를 통해 인도 완료를formal하게 확인해야 한다.

점검 결과 기록: 인도물 점검 결과를 기록하여 남겨야 한다. 발견된 문제점과 그것의 처리 방안도 함께記録한다.

인수 조건 충족 확인: 계약에서 정한 인수 조건(예: 모든 Critical/Major 결함의 해결, 모든 테스트 케이스의 통과)이 충족되었는지를 확인해야 한다.

서면 인수: 인수 조건이 충족되면 발주자가 사업자에게 인도물을 인수하는 것을 서면으로确认해야 한다. 서면 인수가 이루어져야 비로소 사업자의 인도 의무가 이행된 것으로 인정된다.

인수 후 주의사항: 인수가 완료된 후에도 일정 기간 내 결함이 발견되면修补義務가 있을 수 있으므로, 계약서의 품질保修조건을 확인해야 한다.

4. 핵심 용어 정리

용어	영문명	설명
인도물	Deliverables	계약 또는 약정에 따라 引渡하는 산출물 전체
산출물 문서	Documentation	소프트웨어의 기능과 구조를 설명하는 문서
인수	Acceptance	인도된 산출물이 요구사항을 충족하여 인계받는 것
품질 보증	Quality Assurance	제품이 指定된 품질 수준을 충족하도록 하는 체계
빌드	Build	소스 코드를 실행 파일로 변환하는 과정
라이선스	License	소프트웨어 사용에 대한 권한 증서

5. analogies 📢

소프트웨어 인도물 점금은 주택 인테리어 완료 후 인수 检查와 같다. 인테리어 공사가 완료되면 homeowner은 계약에서 정한 바에 따라 집의 모든 부분(도배, 장판, 조명, 설비 등)을 检查하고, 이상이 없으면 인수서를 발급한다. 만약 homeowner이 인수 检查를 소홀히 하면,入住 후에 결함(예: 수도꼭지漏水, 전구 미점등)을 발견해도 사업자가 책임지기를 거부할 수 있다. Likewise, 정보화 사업에서도 시스템 인수가 이루어지기 전 모든 인도물(코드, 문서, 교육 자료 등)을 면밀히 检查하고, 요구사항을 충족하는지를 확인해야 한다. 인수 후에는 결함을発見하더라도 계약상求償이 어려울 수 있으므로, 인수 전 入念한 점검이 필수적이다. 감리자는 homeowner의 입장에서 인수 检查가 적절히 이루어지도록支援하고, 이를 통해 발주자의合法权益을보호한다.