동광기연 발주 업무 자동화 시스템 (정부과제)

<aside> 🧰

기술 스택

데이터 파이프라인 — Python · FastAPI · SQLAlchemy · Alembic · PostgreSQL(JSONB) · MSSQL · Medallion 아키텍처 · KS X 9101 표준
현장 Agent — C# · .NET 8 · WinForms · Worker Service · Npgsql · EPPlus · SSH.NET
모바일 — Flutter · Dart · ML Kit OCR · Riverpod · sqflite · Clean Architecture
웹 / 3D — React 19 · TypeScript · Three.js · React Three Fiber · TanStack Query · MUI · zod · Spring Boot(릴레이)
인프라 — Naver Cloud Platform · Ubuntu · Docker Compose · nginx · Let's Encrypt · GitLab </aside>

<aside> 🎯

한 줄 요약 — 중소 자동차 부품 제조사(동광기연)의 자재창고 입출고 · 발주 업무를 자동화하는 정부과제. 수기 엑셀과 메신저로 돌아가던 업무를 MES 데이터 자동 수집 → 표준 데이터허브 → 현장 스캔 입력 → 3D 창고 모니터링 → 발주 알림으로 전환했다. 데이터허브 · 현장 Agent · 스캔앱 · 모니터링 · 운영 인프라 5개 하위 프로젝트를 기획부터 배포까지 단독 수행.

</aside>

문제

자재 수불 · 과부족 계산이 수작업 엑셀(CONSOL)에 묶여 있어 담당자 한 명의 시간과 경험에 의존했다.
MES에는 입고와 생산실적만 있고 자재 출고 기록이 없어 실제 재고를 시스템에서 알 수 없었다.
창고 위치 관리가 수기 · 경험 기반이라 "지금 뭘 발주해야 하는지"를 즉시 답할 수 없었다.

시스템 구성

graph LR
    MES[("MES<br>MSSQL")] -->|5분 폴링| AG["자재창고 Agent<br>WinForms 중계기"]
    XLS["엑셀<br>재고대장·BOM·소요계획"] -->|폴더 감시| AG
    AG -->|COPY / REST| HUB["제조데이터허브<br>FastAPI + PostgreSQL<br>Bronze → Silver → KPI API"]
    APP["출고 스캔앱<br>Flutter · OCR"] -->|출고 실측| HUB
    HUB -->|수불 · 과부족 KPI| MON["3D 창고 모니터링<br>React · Three.js"]
    MON -->|발주 알림 · 보정| USER["현장 관리자"]
    INFRA["전용 운영 인프라<br>NCP · Docker · HTTPS"] -.-> HUB & MON

담당 역할

영역	수행 내용
기획 · 설계	현장 방문 · 요구 분석, 데이터 흐름 설계, KPI 계산식 정의(고객 엑셀 역산), 화면 기획
백엔드 · 데이터	Medallion 파이프라인, 고객사 어댑터, 표준 테이블 설계, KPI REST API, 대량 적재 12배 최적화
현장 프로그램	Windows 서비스 + 트레이 앱 중계기 (MES 증분 폴링 · 엑셀 적재 · SFTP 백업)
모바일	OCR 출고 스캔앱 (오프라인 우선 · 멱등 재전송 · 자유형식 품번 매칭)
프론트 · 3D	디지털 트윈 운영 캔버스 위 KPI 패널 · 알림 · 창고/랙 드릴다운 · 대시보드 · 관리자 보정 화면 + 서버 릴레이
인프라	클라우드 VM · 방화벽 · Docker Compose · 리버스 프록시 · HTTPS 자동 갱신 · 데이터 이관

성과

자재 출고를 스캔 실측으로 확보해 "생산실적 × BOM 추정"을 대체. 수불 KPI가 고객 정답 시트와 불일치 0으로 검증.
발주 판정(가용재고 − 소요 × 품목별 계수)을 API로 자동화하고, 현장 관리자가 3D 화면에서 부족 품목 · 부족 예상일을 바로 확인.
고객사별 로직을 어댑터로 격리해 다른 고객사 확장 시 허브 코드 무변경.
공용 개발 서버와 분리된 고객사 전용 운영 환경을 구축해 실사용 검증 완료.

하위 프로젝트 상세

MES·DB 제조데이터허브 — Medallion 파이프라인 · KPI API

자재창고 Agent 프로그램 — MES 폴링 · 엑셀 적재 중계기 [WinForms]