구조 — Process GPT 백엔드 위의 Lite

Process GPT Lite는 화면(Vue)과 작은 중계 서버로 이루어져 있고, 실제 일은 손대지 않은 Process GPT 백엔드가 합니다. 이 장에서는 구성 요소를 한 장의 그림으로 보고, 메시지 하나와 문서 하나가 어디를 지나가는지, 어떤 모델이 무엇을 판단하는지 살펴봅니다.

얇은 화면, 그대로 쓰는 백엔드#

앞 장의 작업실에서 에이전트의 작업 폴더를 직접 열어 보았습니다. 이 장에서는 한 걸음 더 물러나, 그 폴더와 채팅·편집기가 서버 안에서 어떻게 이어져 있는지 봅니다. 사내에 설치·운영하는 담당자를 위한 장이라 구성 요소 이름과 포트가 그대로 나옵니다.

지금까지 쓴 기능은 대부분 Lite가 새로 만든 것이 아닙니다. 에이전트 실행, 스킬, 프로세스 엔진, 문서 생성, 저장소는 오픈소스 Process GPT의 서비스를 고치지 않고 부릅니다. Lite가 직접 가진 것은 두 가지입니다.

그래서 Process GPT를 이미 운영하고 있다면 Lite는 그 위에 화면을 하나 더 얹는 셈이고, Process GPT가 좋아지면 Lite도 함께 좋아집니다.

구성도#

브라우저 / Android 앱 (화면 :5180)
  │  /api  /office  /craft
  ▼
Lite 중계 서버 (:8787)
  ├─ 채팅 ───▶ context-router (:8895) ── 어느 대화의 후속?
  │               │      └─▶ 판단 서버 (:8896) 작은 모델·임베딩
  │               ▼
  │            deepagents (:8888) ── 에이전트·스킬 ─▶ 샌드박스
  │               │ MCP 도구
  │               ├─▶ office-mcp (:1192)   문서 만들기
  │               ├─▶ office-host (:5390)  편집기·라이브 편집
  │               ├─▶ mcp-hub (:8500)      커넥터 등록
  │               └─▶ Lite /mcp/*          커넥터·폴더·패널 앱
  │                                        ArtCraft CLI (사용자별)
  ├─ 프로세스 ─▶ completion (:8099) + polling-service
  ├─ 작업실 ───▶ cli-agent (:8890)  Claude Code · Codex
  ├─ 마이닝 ───▶ process-miner (:8014)
  ├─ 개선 분석   (중계 서버 안) 리드타임·병목·크리티컬 패스 계산
  ├─ 저장 ─────▶ Supabase  Postgres · 로그인 · 파일 저장소
  └─ 예약 ◀──── pg_cron ─▶ pg_net ─▶ /api/cron/fire

메시지 하나가 지나가는 길#

채팅에 달빛커피 2호점 예산표를 엑셀로 만들어 줘라고 보내면:

1. 화면 → 중계 서버: 메시지가 저장되고, 응답은 스트림(SSE — 서버가 글자를 조금씩 밀어 보내는 방식)으로 돌아옵니다.
2. 지름길 판단: 중계 서버가 먼저 규칙으로 갈 곳을 봅니다. 스킬 만들기, 패널, 공유 폴더, ArtCraft 앱, 문서 작성 요청은 바로 에이전트로 보냅니다. 그 밖의 말은 작은 모델이 “브라우저 작업인가, 예약인가, 팀원에게 넘기는가, 아니면 에이전트에게 맡길 일인가”를 고릅니다.
3. 대화 고르기: 메인 채팅이면 context-router를 거칩니다. 라우터는 최근 대화 후보를 6개 이하로 좁힌 뒤 판단 서버에 “어느 대화의 후속인가, 새 주제인가”를 묻습니다. 확신이 낮으면 다음 방법(언어 모델의 확률 → JSON 답)으로 넘깁니다.
4. 에이전트 실행: deepagents가 스킬과 MCP 도구를 써서 일합니다. 엑셀이면 샌드박스에서 코드를 돌려 파일을 만듭니다.
5. 카드: 중계 서버가 이번 실행에서 나온 문서를 찾아 파일 저장소에 올리고 파일 카드로 대화에 붙입니다. 답 위에는 어느 대화로 갔는지 알려 주는 “↳ …” 줄이 붙습니다.

도면이나 스킬처럼 긴 작업은 몇 분씩 걸려도 정상입니다. 다만 에이전트가 15분 동안 한 글자도 보내지 않으면(PRO_STREAM_IDLE_MS) 기다리기를 멈추고 다시 보내 달라고 알립니다.

문서 하나가 열리는 길#

파일 카드를 누르면:

1. 화면이 같은 출처의 /office/<편집기>/?src=…로 이음오피스 편집기를 띄웁니다. 엑셀은 sheets, 한글은 hwp, 워드는 docs 편집기가 엽니다.
2. 편집기가 준비되면 화면이 중계 서버에 라이브 연결(일회용 티켓으로 여는 웹소켓)을 열고 “이 사람이 이 문서를 열었다”고 알립니다. 머리줄에 「대화와 연결됨」이 뜹니다.
3. 그다음 채팅 메시지에는 열린 문서를 고치는 도구(office_live_*)가 함께 실립니다. 이 도구는 문서가 열려 있는 동안과 그 뒤 잠시(열린 채 보낸 마지막 메시지부터 30분)만 보입니다. 에이전트가 한 번에 쓸 수 있는 도구 수에 한도(110개)가 있기 때문입니다.
4. 에이전트가 도구를 부르면 중계 서버가 그 사용자의 로그인 토큰을 붙여 office-host로 넘기고, office-host는 그 사람의 화면에 열린 편집기를 찾아 그 자리에서 고칩니다. 사람은 고쳐지는 모습을 봅니다.
5. 고친 뒤에는 검수가 돕니다. 고치기 전과 후를 비교해(글 길이, 표·행, 수식, 그림의 선) 빠진 것이 없는지 보고 짧은 메모를 남깁니다(9장).
6. 사람이 저장하면 편집본이 원본 옆에 올라가고 카드가 편집본을 가리킵니다.

ArtCraft 앱도 같은 모양입니다. 다만 앱의 CLI가 중계 서버가 연 로컬 포트로 붙고, 요청이 화면 속 앱으로 전달됩니다. 그 포트에는 중계 서버가 띄운 그 CLI 프로세스만 붙을 수 있습니다.

어떤 모델을 무엇에 부르나#

모든 일에 큰 모델을 부르면 느리고 비쌉니다. Lite는 일의 성격에 따라 세 층을 나눠 씁니다.

모델 주소와 키는 OpenAI 호환이면 무엇이든 됩니다(PRO_LLM_BASE_URL, PRO_LLM_API_KEY). 사내 모델로 바꿔도 화면과 흐름은 같습니다.

다음 장에서는 이 구성을 사내에서 운영할 때 챙길 것 — 팀원과 역할, 키가 있는 곳, 보관함 암호화, 백업과 업그레이드 — 을 차례로 봅니다(25장).