산업 소프트웨어 인계 시 공급사가 넘겨야 할 문서는 무엇인가｜발주사 점검 목록

시스템은 도는데 문서가 오지 않으면 무엇이 일어나는가

인계 회의에서 문서는 남은 서류 작업으로 취급되기 쉽습니다. 시스템은 가동 중이고 작업자는 화면 설명을 들었으며, 나머지는 '다음 주에 보내겠다'로 합의합니다. 그 일주일이 분기가 되고, 프로젝트 팀은 해산하며, 태그·테이블·화면 대응을 설명할 사람이 현장 담당에서 빠집니다.

문서 부재의 피해는 검수 당일에는 드러나지 않습니다. 공장이 이후에 거의 반드시 맞닥뜨리는 상황에서 드러납니다. SCADA, MES, 에너지 관리, 라인 연계 어느 쪽이든, 산업 소프트웨어를 유지할 수 있는 범위는 문서를 찾고 읽을 수 있는 범위와 같습니다.

• PLC를 교체해 태그를 다시 매핑해야 하는데, 원래 I/O 점이나 레지스터를 아무도 찾지 못한다
• 생산 리포트를 고쳐야 하는데, 어떤 데이터베이스 테이블을 읽고 어떤 집계 규칙을 쓰는지 적어 두지 않았다
• 원래 공급사 엔지니어가 현장을 떠났고, 공장은 손에 있는 자료로 새 작업자를 교육하지 못한다
• 다음 수행사에 확장을 맡기면 주소·화면·인터페이스를 역추적한 뒤에야 새 일을 시작할 수 있다
• 유지보수 내용을 놓고 이견이 생기는데, 롤링되는 유지보수 항목 목록이나 연간 유지보수 보고서가 없어 실제로 무엇을 했는지 보여 주지 못한다

이 다섯 가지는 가동 이후의 일상이며 드문 사고가 아닙니다. 문서 14종이 있는 이유는 라인 개조, 담당 교체, 이후 연계, 유지보수 확인을 발굴 작업이 아니라 일상 업무로 되돌리기 위해서입니다.

인계 패키지에 들어가야 할 문서 14종은 무엇인가

산업 프로젝트의 자료 일체는 14종입니다. 프로젝트 제안서, 기술협의서, 규격서(사양서), I/O 배분표, 어드레스 배분표, 네트워크 구성도, 화면 설계 설명서, 조작 설명서, 데이터베이스 테이블 설명서, 데이터 인터페이스 규격서, 시험 보고서, 검수 자료, 유지보수 항목 목록, 연간 유지보수 보고서. 파일 이름을 평면으로 나열하면 발주사가 상자 안을 점검하기 어렵습니다. 각 그룹이 답하는 질문으로 묶으면 점검이 됩니다.

아래 표는 인계 회의용입니다. 세 번째 열은 단계 종료 조건이 아니라, 검수서에 서명하기 전에 볼 항목입니다.

이 목록은 착수 전에 기술협의서에 적어 둡니다. 계약 시점에 이름이 없는 문서는 팀이 해산한 뒤에 협의 대상이 되고, 다시 만드는 속도는 느리고 이견도 정리하기 어렵습니다.

발주사는 인계 서명 전에 무엇을 확인해야 하는가

검수서 서명은 공급사에게는 프로젝트 종료입니다. 공장에게는 이제부터 문서만으로 서야 하는 기간의 시작입니다. 아래 질문은 인계 회의에서 항목별로 물을 수 있습니다. 답이 '나중에 보내겠다'이면 그 항목은 아직 인도되지 않은 것입니다.

• 14종이 기술협의서에 항목으로 적혀 있는가, 아니면 계약이 '자료'라고만 쓰고 목록이 없는가
• 이름이 적힌 각 문서는 설치된 I/O, 어드레스, 화면, 인터페이스와 일치하는 준공본인가
• 프로젝트에 참여하지 않은 사람이 조작 설명서를 따라 공급사에 전화하지 않고 한 교대를 마칠 수 있는가
• 시험 보고서에 판정 조건, 방법, 결과, 날짜가 있어 제3자가 합격·불합격을 가릴 수 있는가
• 데이터베이스 테이블 설명서와 데이터 인터페이스 규격서에 테이블, 필드, 방향, 마스터 데이터 책임자가 적혀 있는가
• 유지보수 항목 목록과 연간 유지보수 보고서에 다음 해 작업의 기준이 되는 사용 가능한 서식이 있는가
• 인계 후 편집 가능한 원본은 누가 가지는가 — 공장인가, 공급사가 보관하는 PDF뿐인가

마지막 질문이 가장 자주 건너뛰어집니다. 서명된 PDF는 기록입니다. 편집 가능한 I/O 배분표, 어드레스 배분표, 네트워크 구성도는 라인이 바뀌었을 때 공장이 쓰는 도구입니다. 기록과 도구가 모두 필요하며, 하나가 다른 하나를 대신하지 않습니다.

문서는 어떤 언어, 어떤 형식으로 넘겨야 하는가

작업자가 읽지 못하는 문서는 가동 후에 쓰이지 않습니다. 언어는 나중에 끝낼 번역이 아니라 인계 조건이며, 기술협의서의 각 문서명 옆에 적어야 합니다. 한국 현장에서는 한국어 또는 영어로 규격서와 조작 설명서를 받을지를 계약에 명시하는 것이 실무입니다.

형식 역시 그 문서를 계속 쓸 수 있는지를 가릅니다. 주석이 가득한 스캔본은 기록입니다. 편집 가능한 I/O 배분표, 어드레스 배분표, 네트워크 구성도는 현장 도구입니다. 둘 다 필요합니다.

• 회의와 상시 창구의 업무 언어 — 한국어 대응 창구가 프로젝트를 통째로 담당하는지, 통역이 한 번 들어오는 수준에 그치지 않는지
• 규격서(사양서)와 조작 설명서의 언어 — 쓰는 사람이 읽는 한국어 또는 영어. 표지만 번역되고 본문은 다른 언어인 파일은 인도된 것으로 치지 않는다
• 파일 형식 — 편집 가능한 원본(표, 도면, 문서)과 서명된 PDF 기록. 둘 다 내야 하는 문서를 명시한다
• 개정 관리 — 각 문서에 버전, 날짜, 설계본과 준공본을 구분하는 표시가 있다

언어와 형식을 문서명과 같은 표에 넣습니다. 계약 전에 그 표를 채울 수 있는 공급사는 문서를 산출물로 보고 있으며, 막바지에 모으는 파일로 보지 않습니다.