멀티 에이전트 기반 액체화물 하역 스케줄링 및 안전 관제 시스템 — 세이프버스(SafeBerth)
울산항 온산 액체화물 부두를 대상으로, 입항 선박에 대해 "이 선석에 접안·하역해도 되는가"를 근거와 함께 판정하는 관제 지원 시스템. 기상·스케줄링·안전관제 에이전트와 종합 오케스트레이터, GraphRAG 챗봇이 순차 판단하고, 최종 승인은 관제사가 수행한다(Human-in-the-loop).
개발은 기능별 분리 저장소 3개의 dev 브랜치에서 진행되며, 이 저장소는 그 스냅샷 미러다.
| 폴더 | 원본 저장소 (정본) | 내용 |
|---|---|---|
data_pipeline/ |
SmartPortMAS/data-pipeline | 공공데이터 14개 API 수집기·전처리·PostgreSQL/Neo4j 적재·mart 계층 |
backend/ |
SmartPortMAS/backend | FastAPI · 에이전트 4종(기상/스케줄링/안전/종합) · 선석 배정 자동화(승인 게이트) · GraphRAG |
frontend/ |
SmartPortMAS/frontend | React 관제 대시보드 · 선석 배정현황 · 3D 관제 · 협상 로그 콘솔 |
최신 코드는 각 분리 저장소의 dev 브랜치를 참조. 이 미러는 보고서 제출 시점 기준으로 동기화한다.
- 데이터: 공공데이터 6기관 14개 API 상시 수집(AWS EC2 매시 → S3 원본 보관), PostgreSQL 16 + pgvector, Neo4j 5.26
- 판정: 부두그룹별 기상 임계 4단계 → 선석 후보 다단계 게이트(카테고리·흘수·DWT·슬롯)+폴백 → 안전 3축 규칙엔진(MSDS 혼재금지·IMDG 격리·산적화학물질 호환성그룹) 하한 + LLM 설명 → 종합 순차 게이트 → 관제사 승인으로 배정 확정, 이탈 감지 시 자동 해제
- 원칙: fail-safe(모르면 판단 보류) · 규칙이 결정하고 LLM은 설명 · 모든 판정에 근거·표본수 표기
- 검증: GraphRAG 80문항 회귀셋 98.8% 근거 확보 · 계류삭 장력 근사식-PhysX 교차검증 오차 6.7% · 데이터 컨트랙트 SQL 검사 14항목
각 하위 폴더의 README/실행 문서를 참조 (docker compose로 PostgreSQL·Neo4j 기동 후
data_pipeline 적재 → backend(8001) → frontend(3000) 순).