← 미리디 아카이브

Eregion 시스템 구성도 2026-08-26

Eregion 전체 아키텍처

MORDOR 안에서 RLSC를 추출·검수·서빙하는 도구 한 벌. 누가 쓰고, 무엇 위에서 돌고, 어떤 저장소를 거쳐 미리캔버스 실서비스로 넘어가는지를 한 장에 폈다.

aippt-prisonbreak (MORDOR) EC2 · Next.js · PM2 내부망 10.122.9.74 (VPN)
§1

이용자 (Consumers)

웹 UI를 직접 여는 쪽과, API·서비스를 경유해 결과만 받아 가는 쪽으로 나뉜다. 앞의 둘은 Eregion을 도구로 쓰고, 뒤의 둘은 Eregion이 만든 데이터를 소비한다.

MORDOR 스쿼드
RLSC 추출·검수·운영 · 웹 UI 직접
Labeller
린터 검수·라벨링 · 웹 UI
AIR 스쿼드
내용시각화 · API/서비스 경유
APT (AIP)
AI 프레젠테이션 · API 경유
§2

애플리케이션 — EC2 위의 Next.js와 워커

한 대의 EC2에서 웹 앱과 워커가 함께 PM2로 돈다. 워커는 pg-boss 큐를 소비하며, 웹에서 건 작업이 여기로 흘러 들어간다.

Next.js 앱 · :3000
웹 UI + API Route Handlers (Turbopack)
docs-server · :3001
기술 문서 사이트
Workers · PM2 (pg-boss 큐 소비)
agentic-rlsc-generation extract-design-object thumbnail-generator linter visual-unit label · rlsc · 등
배포production 머지 시 GitHub Actions가 EC2로 자동배포하고 PM2가 프로세스를 관리한다.
§3

데이터 · 인프라

앱과 워커가 read / write 하는 저장소 셋. 파이프라인 산출물은 전부 Supabase에 남는다.

Eregion Supabase
Postgres 17 · Private ALB :54321
layouts · design_objects · rlsc_results
linter_results · labelled_rlscs · components
AWS S3
썸네일 이미지 · design_objects 저장
pg-boss
Job Queue · Postgres 기반
§4

핵심 파이프라인 — RLSC 생성

워커가 실행하는 여섯 단계. 원본 시트 한 장(Template)이 재사용 가능한 Design Object가 될 때까지의 전 구간이다. 가운데 두 단계가 LLM 추론이고, 나머지는 결정적 변환·검증이다.

Template
Full Sheet
ALSC
좌표 정규화
RLSC
계층구조 · LLM
Role 할당
의미역할 · LLM
Linter
규칙검증 v1.22+
DO 추출
Design Object
여기서 나온 유효 컴포넌트 데이터가 미리캔버스 BE로 넘어간다. 단계별 상세는 RLSC 생성 여정.
§5

다운스트림 — 미리캔버스 실서비스

Eregion이 만든 컴포넌트가 실제로 쓰이는 곳. 내용시각화와 AIP가 이 경로로 소비한다.

Miricanvas API
운식 BE · api.miricanvas.com
Miricanvas PostgreSQL
운식 관리 · 직접접근 불가
Recall Search V2
hybrid · embedding 검색
Staging6 / Production
실서비스 · /v2/design2
맨 끝에서 APT (AIP)로 API·서비스 경유 연결된다 — §1의 소비자 중 하나로 되돌아온다.
§6

AI · 관측 · 벡터

앱과 워커가 바깥으로 호출하는 것들.

OpenAI · Vertex AI
RLSC / Role / Summary 생성
Langfuse
LLM 호출·비용 추적
graphormer
벡터 유사도 · Python :8000
§7

개발 & 배포

GitHub
aippt-prisonbreak
GitHub Actions
CI · 배포
EC2
PM2 자동배포

로컬에서 띄우기

OrbStack(Docker) → supabase start → pnpm dev :3000 / docs:dev :3001

브랜치는 feature/MOR-XXX → main → production. production 머지가 곧 배포이고 버전이 함께 bump된다.