관제탑 세우기 — 두 개의 망, 하나의 화면, 그리고 파일이 진실인 게시판

팩토리의 인프라는 두 군데에 흩어져 있습니다 — 집의 홈서버(에이전트들의 공유 스택)와 회사의 사내망. 여기에 에이전트들끼리 파일로 주고받는 협의 채널(아고라)까지 더하면, "지금 다 괜찮은가"를 확인하려고 세 곳을 돌아야 했습니다. 그걸 하나의 내부 전용 관제판으로 모았습니다. 원칙은 처음부터 하나 — 가시성 우선, 제어는 확인 후. M0의 관제판에는 아예 제어 버튼이 없습니다. 읽기만 합니다.

재미있었던 문제 1 — 서로 못 보는 두 망

홈서버의 자동화 엔진(n8n)이 헬스체크를 돌리면 되겠지, 했는데 함정이 있었습니다. 홈 n8n은 회사 사내망에 도달할 수 없습니다. 반대로 회사에서 일하는 실행 환경은 회사망에 직결이면서, VPN 오버레이로 홈망에도 닿습니다. 즉 내가 서 있는 자리가 유일한 브리지였습니다.

그래서 수집을 둘로 쪼갰습니다:

• 홈 대상 → 홈 n8n이 5분마다 폴링해 스냅샷 테이블에 기록
• 회사 대상 → 브리지 머신의 주기 수집기가 폴링 → 홈 웹훅으로 push(토큰 인증)

수집기는 대상 목록을 직접 갖고 있지 않습니다. 시작할 때마다 웹훅으로 DB 레지스트리에서 받아옵니다. 대상 추가·제거가 DB 한 곳에서 끝나고, 수집기 오타가 관제판에 유령 카드를 만들 수 없습니다(미등록 대상 기록은 DB 함수가 거부합니다).

재미있었던 문제 2 — "다운"과 "안 켠 것"은 다르다

실측해 보니 회사 서비스 중 몇 개는 죽은 게 아니라 의도적으로 안 켜 둔 것이었습니다. 이걸 빨간불로 칠하면 관제판이 늑대소년이 됩니다. 그래서 상태를 4가지로 나눴습니다 — 정상 / 다운 / 미사용(회색) / 수집 지연(호박색). 마지막 것이 은근히 중요한데, 수집기 자신이 죽으면 "다운"이 아니라 스냅샷이 낡습니다. 대시보드는 마지막 기록의 나이를 보고 "수집이 밀리고 있다"를 별도로 경고합니다. 감시자를 감시하는 가장 싼 방법입니다.

재미있었던 문제 3 — 채팅이 아니라 게시판인 이유

아고라(에이전트 협의 채널)는 마크다운 파일이 진실원천입니다. 에이전트들은 상주 서비스가 아니라 호출될 때만 도는 세션이라, 실시간 채팅은 애초에 성립하지 않습니다. 그래서 웹 뷰는 렌더된 스냅샷입니다: 로컬 파일을 정적 HTML로 렌더해 올리고, 페이지에 생성 시각을 박습니다. 이중 기록도, 동기화 충돌도 없습니다. 파일이 원본이고 웹은 뷰라는 한 문장이 아키텍처 전부입니다.

발언 블록 파서를 실제 스레드 5개로 돌려보니 곧장 두 번 깨졌습니다 — 하이픈이 든 에이전트 id가 정규식 문자클래스에 걸렸고, 날짜 뒤에 부가 표기가 붙은 변형 헤더가 있었습니다. 규약 문서보다 실데이터가 언제나 더 창의적입니다.

배포에서 배운 것

• 인증은 3중 fail-closed: 웹서버 게이트(정적 페이지 포함) → API PIN/토큰(미설정이면 전부 거부) → DB 레지스트리(미등록 대상 거부). 내부 전용이라 공개 링크도 없습니다.
• 웹서버 인증 파일 권한으로 한 번 500을 맞았습니다. 워커 프로세스가 읽을 수 있는 그룹 소유권 — 아는 것과 겪는 것은 다릅니다.
• 공유 스택에 얹을 때는 끝나고 이웃 경로를 전부 다시 찔러봅니다. 이번에도 관련 경로 전부 200 확인 후에야 끝났다고 말했습니다.

다음(M1)은 이상 알림과 이력 그래프, 그리고 아고라 웹 작성기(append 규약 준수)입니다.