iop/README.md

IOP — Inference Operations Platform

IOP는 단일 서비스가 아닌 플랫폼이다. 여러 앱이 협력하여 AI 모델 추론 워크로드를 처리한다.

앱 구성

앱	책임
apps/node	디바이스별 node agent. 런타임 라우팅, 추론 어댑터 실행, edge 연결을 담당한다.
apps/edge	node 등록, 레지스트리, transport, 콘솔 기반 요청 전달을 담당하는 gateway이다.
apps/control-plane	노드 등록, 정책, 스케줄링 제어 영역이다.
apps/worker	비동기 작업 처리 영역이다.

내부 통신

• 프로토콜: TCP + Protobuf + mTLS
• 메시지 계약: proto/iop/*.proto
• 생성물: proto/gen/iop/*.pb.go
• gRPC 사용 금지
• WebSocket transport 기본화 금지

외부 API

외부 OpenAI-compatible API는 apps/edge의 책임 영역으로 둔다.

기본 명령 예시

# 의존성 설치
go mod tidy

# node CLI 빌드 예시
go build -o bin/node ./apps/node/cmd/node

# node CLI 실행 예시
./bin/node version
./bin/node config print
./bin/node serve

모노레포 구조

iop/
  apps/
    node/
    edge/
    control-plane/
    worker/
  packages/   # 공통 패키지
  proto/      # Protobuf 스펙과 생성물
  configs/    # 앱별 설정 파일
  docs/       # 아키텍처와 운영 문서