선박 운항 시스템 운영 플랫폼

1. 고객사 소개

• 분야: 조선·해양 (선박 운항 시스템)
• 대상 사용자: 선박 시스템을 육상에서 원격 점검·조치하는 운영 담당자
• 과제: 개인 장비에 설치된 도구로 수행하던 작업을 사내망 웹 플랫폼으로 이전

NDA 과제로 발주처명과 시스템 명칭, 내부 운영 절차와 보안 구성은 공개하지 않습니다. 당사는 웹 플랫폼 개발을 담당했습니다.

2. 도입 배경

선박에 설치된 시스템은 육상에서 원격으로 점검하고 조치합니다. 이 작업은 오랫동안 담당자의 노트북에 설치된 도구로 이루어졌습니다. 도구가 개인 장비에 있으면 세 가지 문제가 따라옵니다.

개인 장비에 도구가 있을 때 생기는 일

첫째, 작업 기록이 개인에게 흩어집니다. 누가 언제 어떤 조치를 했는지 확인하려면 담당자에게 물어봐야 합니다. 둘째, 절차가 사람마다 달라집니다. 같은 점검이라도 담당자에 따라 순서와 범위가 조금씩 다르면, 문제가 생겼을 때 원인을 좁히기 어렵습니다. 셋째, 담당자가 자리에 없으면 작업 자체가 멈춥니다.

웹 플랫폼으로 옮기기

2026년 3월부터 5월까지 이 작업을 사내망 웹 플랫폼으로 옮겼습니다. 담당자가 각자의 도구로 하던 작업을 하나의 화면에서 수행하고, 실행 결과가 자동으로 기록됩니다. 당사는 웹 플랫폼 개발을 담당했습니다.

목표는 작업을 자동화하는 것이 아니라 표준화하는 것이었습니다. 같은 작업이 같은 절차로 수행되고, 그 기록이 남는 상태를 만드는 것입니다.

한 줄 요약 목표는 작업을 자동화하는 것이 아니라 표준화하는 것이었습니다.

3. 활용 기능

기존 데스크톱 도구의 기능을 웹 플랫폼으로 옮기고, 운영에 필요한 관리 기능을 더했습니다.

작업 실행과 결과 확인을 분리했습니다. 원격 작업은 시간이 오래 걸리고 중간에 실패할 수 있습니다. 실행 요청을 받는 부분과 실제로 수행하는 부분을 나눠, 작업이 오래 걸려도 화면이 멈추지 않고 결과는 완료 시점에 반영됩니다.

모든 실행에 기록을 남깁니다. 누가 어떤 작업을 어느 대상에 수행했고 결과가 어땠는지가 저장됩니다. 문제가 발생했을 때 확인할 근거가 생기고, 작업 이력 자체가 운영 자산이 됩니다.

권한을 역할 단위로 관리합니다. 사용자마다 수행할 수 있는 작업과 접근할 수 있는 대상이 다릅니다. 화면을 감추는 방식이 아니라 실행 단계에서 권한을 확인하도록 구성했습니다.

주요 기능

작업 목록 관리

수행 가능한 작업을 목록으로 관리합니다. 담당자가 개별 스크립트를 찾아 쓰는 대신, 등록된 목록에서 골라 실행합니다. 절차가 사람에 따라 달라지지 않도록 하는 장치입니다.

원격 실행

선택한 작업을 지정한 대상에 원격으로 수행합니다. 실행 요청과 수행을 분리해, 작업이 오래 걸려도 화면이 대기 상태로 묶이지 않습니다.

실행 이력

모든 실행을 기록으로 남깁니다. 수행자, 대상, 시각, 결과가 저장되어 이후에 조회할 수 있습니다.

연결 상태 점검

대상 시스템과의 연결을 사전에 확인합니다. 작업을 시작한 뒤에 연결 문제로 실패하면 원인 파악이 늦어지므로, 실행 전에 확인하는 절차를 따로 두었습니다.

권한 관리

역할에 따라 수행 가능한 작업과 접근 대상을 구분합니다. 운영 도구에서 권한 구분은 사고 방지의 기본 조건입니다.

감사 기록

권한 변경이나 설정 수정처럼 시스템 자체에 영향을 주는 동작도 기록합니다. 무엇이 언제 바뀌었는지 확인할 수 있어야 운영 책임을 다룰 수 있습니다.

4. 성과

담당자 개인 장비에 있던 운영 도구를 사내망 웹 플랫폼으로 옮겼습니다. 같은 작업이 같은 절차로 수행되고, 수행 내역이 기록으로 남는 상태가 되었습니다.

작업 실행과 결과 확인을 분리하면서, 오래 걸리는 원격 작업 중에도 화면이 멈추지 않고 실패한 작업을 따로 확인할 수 있게 되었습니다.

권한을 역할 단위로 나누고 감사 기록을 남기면서, 누가 무엇을 할 수 있는지와 실제로 무엇이 수행되었는지를 함께 관리하게 되었습니다.

2026년 3월부터 5월까지 약 3개월간 개발했습니다.

5. 기술 구성

Web — Next.js와 TypeScript 기반의 운영 포털입니다. 사내망에서 사용하는 도구이므로 외부 의존성을 최소화했습니다.

작업 처리 — 실행 요청을 큐에 넣고 별도 프로세스가 수행하는 구조입니다. 오래 걸리는 작업이 화면 응답을 붙잡지 않고, 실패한 작업의 상태를 추적할 수 있습니다.

데이터 — PostgreSQL과 Prisma ORM을 사용합니다. 실행 이력과 감사 기록이 데이터로 남습니다.

구성 — 모노레포로 구성해 웹, 작업 처리, 도메인 규칙, 실행 엔진, 기록 유틸리티를 패키지로 나눴습니다. 웹과 작업 처리 프로세스가 같은 도메인 규칙을 공유하므로, 어느 쪽에서 실행하든 같은 기준이 적용됩니다.

배포 — 컨테이너 기반으로 사내망 환경에 배포합니다.

설계 기준 — 이 플랫폼에서 가장 중요한 것은 기록입니다. 작업이 빨라지는 것보다 무엇이 수행되었는지 남는 것이 우선입니다. 실행 경로를 하나로 모으고 모든 실행에 기록을 남기도록 한 것은 이 기준에서 나온 결정입니다.

6. 프로젝트 정보

항목	내용
사업명	선박 운항 시스템 안정화 (운영 플랫폼 구축)
담당 범위	웹 플랫폼 개발
적용 기술	Next.js, TypeScript, Prisma, PostgreSQL, 작업 큐, 컨테이너 배포