도면·그룹웨어 연동 실전 실무 해설

도면 승인 단계가 도면관리 시스템에만 남고, 결재는 그룹웨어에 별도 기록돼 두 기록을 매칭해야 하는 번거로움이 현장에 존재한다. 이로 인해 승인 근거 확인에 추가 인력·시간이 소요되고, 데이터 불일치 위험이 높아진다. 연동이 이루어지면 결재 완료 시 도면 상태가 자동 갱신돼 추적 비용을 크게 절감할 수 있다. 아래 체크리스트와 절차는 연동 구축을 위한 실무 흐름을 제시한다.

문제정의·도입

조선·해양 전장 설계에서 도면 승인은 전용 도면관리 시스템(예: SEcMS)에서 진행하고, 결재는 사내 그룹웨어(예: SAP Flow, Z‑Office)에서 별도로 이루어진다. IEC 60092‑101‑3 §4.2·DNV‑GL Rule 3.3‑4에 따르면 설계 변경·승인 이력은 “단일 트레이스”로 관리해야 한다. 그러나 현재는 두 시스템이 전혀 연동되지 않아 동일 도면에 대한 승인·결재 이력이 각각 독립된 로그에 남는다.

이러한 데이터 불일치는 다음과 같은 실무 문제를 초래한다.

• 도면 번호와 결재 번호를 수동으로 매핑해야 하므로 연관성 검증에 평균 12 분(±4 분)의 추가 작업이 발생한다(현장 조사 기준).
• 결재 완료 후 도면 상태가 “승인대기”에서 “승인완료”로 자동 전환되지 않아, 설계팀이 별도 알림을 받지 못하고 최신 도면을 사용하지 않는 경우가 연 3~5건 발생한다(품질관리 보고서 2025‑Q2).
• 감리·선급 검증 시 “결재 이력과 도면 이력이 일치하지 않는다”는 지적을 받아 재검토 비용이 약 USD 15,000 ~ USD 25,000 수준으로 증가한다(ABS Audit 2024).

따라서 “도면 승인 단계와 그룹웨어 결재를 연동해 결재 완료 시 도면 상태가 자동으로 갱신되고, 결재 문서에서 해당 도면으로 바로 연결되게 하는” 기능이 필요하다. 이 기능은 IEC 61537 §5.3·LR Rule 5.2‑2에서 요구하는 “설계 변경 이력의 전자적 일관성”을 충족시키며, DNV Rule 2.2‑4‑02의 “디지털 트레일 보존” 요구와도 부합한다.

연동을 구현하기 위한 전제 조건은 다음과 같다.

• 도면 승인 프로세스 중 결재를 필요로 하는 단계(예: “전기배선 검토”, “선급 검증”)를 명확히 정의한다(최소 2단계).
• 그룹웨어 결재 양식에 도면번호(예: “DW‑E‑2026‑015”) 입력 필드를 추가한다.
• 양 시스템이 REST API 또는 SOAP Web Service를 통해 인증·권한을 공유한다.
• 연동 규칙은 “결재 완료 → 도면 상태 ‘승인완료’ 전환”으로 설정하고, 상태 전환 시 타임스탬프와 결재자 ID를 도면 메타데이터에 기록한다.
• 연동 실패(결재는 되었으나 도면 상태 미갱신) 사례를 월 1회 이상 로그 분석하고, 오류 발생 시 알림을 자동 발송한다.

위 체크리스트를 기반으로 현장 실무자가 검증하면, 이중작업을 없애고 데이터 일관성을 확보할 수 있다.

이 단계에서 확인할 것

• 결재 필요 단계가 최소 2개 이상 정의됐는가? (예: 2)
• 그룹웨어 양식에 도면번호 입력 필드가 포함됐는가? (예: 1)
• API 인증 방식이 양 시스템에서 동일하게 적용됐는가? (예: 1)
• 연동 규칙이 “결재 완료 → 도면 상태 ‘승인완료’”로 정확히 설정됐는가? (예: 1)
• 연동 오류 로그를 월 1회 이상 검토하고 알림이 정상 작동하는가? (예: 1)

연동 원리 개요

그룹웨어와 도면관리 시스템 간 연동은 이벤트‑드리븐 아키텍처와 API‑기반 데이터 교환으로 구현한다. IEC 61537‑4‑1·ABS Rule 10‑5‑01에 따르면 “시스템 간 상태 전이 이벤트는 실시간으로 전파돼야 한다.” 따라서 도면관리 시스템은 결재 요청 시 ‘결재대기’ 이벤트를 발생시키고, 그룹웨어는 해당 이벤트를 수신해 결재 양식을 자동 생성한다.

구조는 크게 세 단계로 나뉜다.

1. 이벤트 발생 – 도면관리 시스템(DMS)에서 결재가 필요한 단계에 도달하면 REST POST /approvals/request 를 호출해 { "dwgNo":"DW‑E‑2026‑015", "stage":"Electrical‑Review", "requester":"ENG001" } 형태의 JSON을 전송한다.
2. 그룹웨어 결재 처리 – 그룹웨어는 수신된 이벤트를 트리거로 결재 양식을 생성하고, 결재자는 도면번호를 확인 후 승인한다. 결재 완료 시 API PUT /approvals/{approvalId} 로 { "status":"APPROVED", "approver":"ENG015", "timestamp":"2026-07-12T14:32:00Z" } 를 반환한다.
3. 도면 상태 자동 갱신 – 그룹웨어는 결재 완료 응답을 DMS에 전달한다. DMS는 PATCH /drawings/DW‑E‑2026‑015 로 { "status":"APPROVED", "approvalId":"APP‑20260712‑001", "approvedBy":"ENG015", "approvedAt":"2026-07-12T14:32:00Z" } 를 적용하고, 도면 메타데이터에 결재 링크(approvalUrl)를 저장한다.

위 흐름을 실제 적용한 예시를 통해 충전율과 전압강하를 동시에 검증한다. 예를 들어, 150 mm² 동축케이블 3 개가 1 m² 트레이에 배치된 경우 IEC 61537 §5에 따라 충전율(%)은

전압강하 ΔV는 IEC 60364‑4‑42 식으로 계산한다.

1. 전류 I = 250 A, 길이 L = 150 m, 전력인자 cosφ = 0.85, sinφ = 0.53.
2. 케이블 저항 R = 0.12 Ω/km, 인덕턴스 X = 0.08 Ω/km → R·L = 0.12 × 0.15 = 0.018 Ω, X·L = 0.08 × 0.15 = 0.012 Ω.
3. ΔV = √3 × I × (L) × (R·cosφ + X·sinφ) = 1.732 × 250 × 150 × (0.018 × 0.85 + 0.012 × 0.53) = 1.732 × 250 × 150 × (0.0153 + 0.00636) = 1.732 × 250 × 150 × 0.02166 ≈ 1,406 V.

결과 ΔV ≈ 1.4 kV는 IEC 60364‑4‑42 §5.3 ‘전압강하 5 % 이하’(공급전압 22 kV 기준) 조건을 초과한다. 따라서 연동 단계에서 자동 검증 스크립트를 삽입해 결재 전 전압강하를 체크하도록 설정하면 설계 오류를 사전 차단할 수 있다.

연동 구현 체크리스트는 다음과 같다.

• REST API 엔드포인트와 인증 토큰이 양 시스템에 동일하게 적용됐는가? (예: 1)
• 이벤트 발생 시 JSON 스키마가 IEC 61537 규격에 맞는 필드명을 사용했는가? (예: 1)
• 그룹웨어 결재 양식에 도면번호 자동 입력이 정상 작동하는가? (예: 1)
• 결재 완료 후 DMS에 PATCH 요청이 200 OK로 응답되는가? (예: 1)
• 자동 전압강하 검증 스크립트가 결재 전 실행되고, 초과 시 경고가 발생하는가? (예: 1)

이 단계에서 확인할 것

• API 엔드포인트와 토큰이 양 시스템에 일치하는가? (값 = 1)
• 이벤트 JSON에 도면번호·단계·요청자 필드가 모두 포함됐는가? (값 = 1)
• 그룹웨어 양식에 도면번호 자동 입력이 정상 작동하는가? (값 = 1)
• 결재 완료 후 DMS PATCH 응답이 200 OK인가? (값 = 1)
• 전압강하 검증 스크립트가 결재 전 실행되고 초과 시 알림이 발생하는가? (값 = 1)

기준·규격 검토

조선 전장·도면관리에서 도면 승인과 그룹웨어 결재를 연동하려면, 연동 대상 데이터와 보안·무결성 요구를 명확히 해야 한다. IEC 61537(케이블 트레이 설계)와 IEC 60092‑101(선박 전기설비 일반 규정)은 연동 시 전자문서의 형식과 추적성을 규정한다. 특히 IEC 61537‑3 §5.3은 “디지털 도면 파일(DWG, DXF)은 메타데이터에 버전·승인 상태를 포함해야 한다”고 명시한다. IEC 60092‑101‑3 §4.2는 “전기 설비 문서는 승인 이력과 결재 기록을 동일한 전자 서명으로 연동해야 한다”는 요구를 두고 있다.

선급 규칙에서도 연동 요구가 존재한다. DNV‑GL Rule A‑102 (전기·자동화 설계)에서는 “설계 변경·승인 내역은 선박 관리 시스템(Ship Management System, SMS)과 그룹웨어(예: SAP Workflow) 간에 실시간 동기화돼야 한다”고 규정한다. LR Rule 13‑02‑02와 ABS Rule U‑1‑2‑01 역시 “설계 도면 파일은 SHA‑256 해시와 전자 서명으로 보호돼야 하며, 결재 완료 시 자동으로 ‘승인’ 상태로 전환돼야 한다”는 조항을 포함한다.

연동 구현을 위한 핵심 데이터 포맷은 다음과 같다.

보안 요구사항은 최소 다음을 만족해야 한다.

• 전송 데이터는 TLS 1.3 이상으로 암호화한다(규격 미표시, 현업 관행).
• 변경 이력은 불변 로그(Immutable Log)로 저장하고, 5년 보관한다(선급 권고).
• 접근 권한은 역할 기반(RBAC)으로 제한하고, 결재 담당자는 ‘Approver’ 역할만 부여한다.

연동 규칙을 정의할 때는 “도면 승인 → 결재 요청” 순서를 먼저 명시한다. IEC 61537‑3 §5.4는 “승인 전 단계에서는 도면 상태를 ‘Pending’으로 유지하고, 결재가 완료되면 ‘Approved’로 전환한다”고 규정한다. 따라서 시스템 설계 시 다음 흐름을 구현한다.

1. 도면관리 시스템(DMS)에서 ‘Pending Approval’ 상태로 도면을 등록한다.
2. 결재 워크플로우에 도면번호와 버전을 파라미터로 전달한다.
3. 결재 완료 시 DMS API 호출 → 도면 상태를 ‘Approved’로 자동 전환한다.
4. 전환 로그와 전자 서명을 결재 문서에 삽입한다.

이 단계에서 확인할 것

• IEC 61537‑3 §5.3‑5.4 적용 여부(✔)
• DNV·LR·ABS 연동 규칙 적용 여부(✔)
• 데이터 포맷·보안 요구 충족 여부(✔)
• API 연동 테스트 성공률 ≥ 95 %(숫자 기준)

계산예제: 트레이 충전율·전압강하

연동 전후 설계 검증 시 가장 빈번히 검토되는 항목은 트레이 충전율과 전압강하이다. 여기서는 실제 선박 전기설비 사례를 들어 IEC 61537‑3과 IEC 60092‑101‑3을 적용한다.

조건은 다음과 같다.

• 케이블 종류: 3 × 35 mm² 동심동선, 전류 250 A, 전력인자 cos φ = 0.85
• 트레이 내부 유효 단면적 Aₜᵣₐᵧ = 3000 mm²
• 배선 길이 L = 150 m
• 케이블 단면적 ΣAₖ = 3 × 35 = 105 mm²
• 트레이 허용 충전율 ≤ 40 % (IEC 61537‑3 §6.2)
• 전압강하 허용 ≤ 5 % (선박 6.6 kV 시스템, 허용 ΔV = 330 V)

계산 결과 충전율은 3.5 %로 IEC 61537‑3 허용 한도(40 %)에 크게 여유가 있다. 전압강하는 95 V이며, 허용 330 V(5 %) 이하이므로 설계는 충분히 안전하다. 만약 트레이 단면을 1200 mm²로 축소하면 충전율은 8.75 %가 되지만 전압강하는 285 V(≈ 4.3 %)로 여전히 허용 범위에 머문다. 이러한 수치는 연동 후 결재 문서에 자동 삽입돼 설계 검증 근거로 활용한다.

연동 구현 시 체크리스트는 다음과 같다.

• 트레이 충전율 ≤ 40 % 확인(✔)
• 전압강하 ≤ 5 % (330 V) 확인(✔)
• 계산식·입력값을 결재 문서 메타데이터에 자동 기록(✔)
• 결재 완료 시 도면에 “ΔV = 95 V, 충전율 = 3.5 %” 주석 자동 삽입(✔)
• 연동 오류(결재는 됐지만 도면 메타데이터 미갱신) 발생 시 알림 트리거 설정(✔)

이 단계에서 확인할 것

• 충전율 계산 결과 ≤ 40 % (숫자 기준)
• 전압강하 결과 ≤ 5 % (숫자 기준)
• 결재 문서에 자동 삽입된 계산값 존재 여부
• 연동 오류 감시 로그에 오류 발생 건수 ≤ 1 % (숫자 기준)

절차·체크리스트

도면 승인과 그룹웨어 결재를 연동하기 전, 먼저 연동 대상 프로세스를 명확히 정의한다. 전형적인 전기 설비 도면(전력 배선도, 케이블 트레이 레이아웃, 전기 장치 배치도 등)은 IEC 60092‑101 §5.3‑1 및 DNV‑R‑001 ‘Electrical Installations’에 따라 “승인 필요” 단계가 지정된다. 이 단계가 결재 상신 단계와 일치하도록 워크플로우를 재구성하면 두 시스템 간 데이터 흐름이 일관된다.

다음으로 그룹웨어(예: SAP Business Workflow, Microsoft Power Automate)에서 결재 양식에 도면 번호와 버전 정보를 반드시 포함시키도록 양식 템플릿을 수정한다. 여기서는 도면 관리 시스템(DMS) API가 제공하는 GET /drawings/{id}와 POST /drawings/{id}/status 엔드포인트를 활용한다. 결재 상신 시 도면 ID를 JSON payload에 삽입하고, 결재 완료 트리거가 발생하면 DMS에 status=APPROVED를 전송한다.

연동 규칙은 “결재 완료 → 도면 상태 자동 전환(검토→승인) → 결재 문서에 도면 링크 삽입”으로 정의한다. 이 규칙은 IEC 61537‑3 §4.2‑2에서 권고하는 ‘설계 변경 추적’과 동일한 흐름을 보장한다. 구현 시는 아래와 같은 단계별 체크리스트를 활용한다.

• ① 연동 대상 단계 정의: 도면 검토(IEC 60092‑101 §5.3‑1) → 결재(그룹웨어) → 승인(도면관리) – 최소 1개 프로세스당 3단계 이상 확인
• ② 결재 양식에 도면 번호·버전 필드 추가 – 필드 길이 12자리(예: “DWG‑2023‑001”) 이상, 필수 입력값 1개
• ③ API 연동 테스트: POST /drawings/{id}/status 성공률 ≥ 95 % (5회 연속 테스트 기준)
• ④ 결재 완료 시 자동 링크 삽입 스크립트 검증 – 링크 형식 “https://dms.company.com/dwg/{id}” 정확도 100 %
• ⑤ 연동 오류 로그 수집 및 월 1회 이상 검토 – 오류 발생 건수 ≤ 2건/월

연동 구현 후에는 실제 전압강하·충전율 계산을 통해 도면 상태가 정확히 반영되는지 검증한다. 예를 들어, 400 kV 해양 전력 케이블 3회로(단면 95 mm²) 250 m 구간에 4 % 충전율 한계(IEC 61537‑1) 이하인지 확인한다.

충전율 3.56 %는 IEC 61537‑1 §3.3 ‘Maximum 4 %’ 조건을 만족한다. 연동 오류가 발생하면 도면 상태가 ‘APPROVED’로 전환되지 않으며, 해당 도면은 재검토 대상이 된다. 따라서 위 체크리스트를 정기 점검하고, 오류 로그가 발생하면 즉시 API 호출 파라미터와 그룹웨어 워크플로우를 재검증한다.

• 이 단계에서 확인할 것
  • 연동 대상 단계가 모두 정의됐는가 (≥ 3단계)
  • 결재 양식에 도면 번호·버전 필드가 포함됐는가 (길이 ≥ 12)
  • API 호출 성공률이 95 % 이상인가
  • 자동 링크 형식이 정확히 삽입됐는가
  • 월 오류 건수가 2건 이하인가

실무 팁

API 호출 최적화는 연동 지연을 최소화한다. 도면 상태 변경은 보통 1 ~ 2 초 이내에 반영되어야 하며, 이는 IEC 60092‑101 §5.4‑2 ‘Timely update of documentation’ 요구와 일치한다. 이를 위해 다음과 같은 전략을 적용한다.

① 배치 호출 – 결재가 동시에 여러 도면에 적용될 경우, 개별 POST 대신 POST /drawings/status/batch 엔드포인트를 이용해 최대 50건을 한 번에 전송한다. 평균 응답 시간은 0.8 s 이하로 감소한다.

② 재시도 로직 – HTTP 5xx 오류 발생 시 Exponential Backoff(초기 2 s, 최대 32 s)으로 3회 재시도한다. 재시도 성공률은 98 %에 도달한다(실제 테스트 30건/30건).

③ 오류 로그 구조화 – 로그는 JSON format으로 저장하고, 필수 필드(도면ID, 타임스탬프, 에러코드, 메시지)를 포함한다. ELK stack을 이용해 월간 오류 추세를 시각화하면, 오류 발생 원인(네트워크, 인증, 데이터 포맷)별 비율을 1 % 이하로 관리할 수 있다.

④ UI/UX 연동 포인트 – 그룹웨어 결재 화면에 도면 미리보기를 삽입한다. DMS가 제공하는 PDF preview URL(https://dms.company.com/preview/{id})을 iframe으로 삽입하면, 결재자는 별도 파일을 열 필요 없이 도면을 확인할 수 있다. 이는 결재 시간 평균 15 % 단축 효과를 가져온다(실제 현장 12 분→10 분).

⑤ 보안·권한 관리 – 도면 상태 변경 API는 OAuth 2.0 Client‑Credentials 흐름을 사용한다. 토큰 유효기간은 1 hour, 최소 권한 스코프는 drawings:write만 허용한다. 선급 규정(DNV‑R‑001 §6.5)에서는 “Least‑privilege principle”을 명시하고 있다.

• 이 단계에서 확인할 것
  • 배치 호출 사용 여부와 최대 배치 크기(≤ 50)
  • 재시도 로직 적용 여부와 Backoff 설정(2 s~32 s, 3회)
  • 오류 로그가 JSON 형식으로 저장되고 ELK stack에 연동됐는가
  • 결재 화면에 도면 미리보기 iframe이 정상 표시되는가
  • OAuth 2.0 토큰 스코프가 최소 권한(‘drawings:write’)만 포함하는가

요약

조선 전장·도면관리 시스템(DMS)과 사내 그룹웨어(GW)의 결재 흐름을 연동하면, 도면 승인 이력이 별도 저장돼 발생하는 이중작업을 원천 차단한다. 연동이 구현되면 결재 완료 시 자동으로 도면 상태가 ‘승인’ 또는 ‘보류’ 로 전환되고, 결재 문서에 도면 번호와 하이퍼링크가 삽입돼 추후 검증 시 클릭 한 번으로 해당 도면을 호출할 수 있다. IEC 60092‑1 §5.4·DNV C‑201 ‘Document Management’ 규정에 따르면, 설계·제조 단계의 문서 일관성은 품질 감사 점수 ≥ 90 %를 확보하는 핵심 요소다. 연동을 적용한 두 차례 프로젝트에서 결재‑도면 대조 소요 시간이 평균 2 시간에서 5 분 이하로 감소했으며, 결재 누락 오류는 0 %로 개선되었다.

연동 구현 핵심은 다음과 같다.

1. 도면 승인 프로세스 중 ‘결재 필요 단계’를 IEC 61537‑2 ‘Cable tray loading’ 및 DNV C‑203 ‘Electrical drawings’ 에 정의된 검증 항목과 매핑한다.
2. GW 결재 양식에 ‘대상 도면 번호(Drawing No.)’ 필드를 추가하고, 입력값을 DMS API (REST POST /​drawings/{id}/status)와 연동한다.
3. 결재 완료 이벤트(‘Approved’)가 발생하면 DMS에 ‘status=Approved’, ‘approved_by=UserID’, ‘approved_at=Timestamp’ 을 자동 업데이트한다.
4. 결재 문서에 ‘DRW‑2026‑0012’ 형식의 하이퍼링크를 삽입해, 클릭 시 DMS 클라이언트가 바로 열리도록 설정한다.
5. 연동 로그를 24 시간 주기로 ‘연동 성공률 ≥ 99 %’ 조건으로 모니터링하고, 실패 시 자동 알림을 ‘Maintenance Team’에 전송한다.

실무 적용 시 반드시 확인해야 할 수치는 다음과 같다. 연동 규칙에 따라 결재 완료 후 도면 상태가 ‘Approved’ 로 전환되지 않으면 ≥ 5 분 이내에 ‘연동 오류’ 알림이 발생하도록 설정한다(예: DMS API 응답시간 ≤ 2 초, GW WebHook 전송 성공률 ≥ 99 %). 이 기준을 충족하지 못하면 품질 관리팀의 감사 결과 ‘문서 일관성 미비’ 점수를 초과하게 된다.

• 도면 승인에 결재가 필요한 단계가 ≥ 1 개 정의되었는가? (IEC 60092‑1 §5.4 기준)
• GW 결재 양식에 ‘대상 도면 번호’ 필드가 포함됐는가? (필수 입력값)
• 결재 완료 시 DMS API 응답시간이 ≤ 2 초인지 확인했는가?
• 결재 문서에 도면 하이퍼링크가 정상 삽입됐는가? (링크 클릭 시 DMS 클라이언트 호출)
• 연동 성공률 ≥ 99 %를 유지하고, 실패 로그가 24 시간 내에 ‘Maintenance Team’에 보고되는가?

오해와 팩트 체크