EG228/Web · A04

시스템 · 서비스 구성

주소가 셋이다 — 포털(시험 현황) · 장비 웹(실기를 직접 본다) · AI 서버(별도 주소 · 유료). AI 서버는 Claude 에 일을 맡기고, 그 과정을 전부 모아 나중에 스스로 하기 위한 자산으로 쌓는다.

범위 서버 구성 · 과금 · 데이터 축적 선행 A03 에이전트 아키텍처 작성 2026-09-02
01

전체 구성

주소 셋

사용자는 포털에 붙는다. 장비를 직접 보고 싶으면 포털이 중계하고, AI 를 쓰고 싶으면 별도 주소로 넘어간다. 장비는 어떤 경우에도 인터넷에 직접 노출되지 않는다.

사용자 — 브라우저 한 번 로그인해서 셋을 다 쓴다 포털 웹 서버 onbridge.aigate.kr 시험 현황 · 사용자 · 기관 · 문서 🔴 장비 웹으로 가는 유일한 문 (리버스 프록시) AI 서버 ai.aigate.kr — 별도 주소 · 유료 로그인 검증 · 도구 실행 · 과금 계량 🔴 대화·도구호출·결과를 전부 적재 Claude (외부 · 인터넷) 판단하고 도구를 고른다 과금 원가가 발생하는 유일한 지점 현장 — 폐쇄망 미니PC 웹시나리오 · 이력 · 8대 집약 EG228 보드 웹 ×N보드 자체 화면 (W01) mosquitto · cycler_main · CAN — 🔴 안전 최종 관문 ① 현황 · 문서 ② AI 요청 ③ 장비 웹 중계 /device/<id>/… ④ 요청 ⑤ 도구 호출 ⑥ 도구를 대신 실행 🔴 Claude 는 장비에 직접 붙지 않는다
주소 셋 + 외부 하나. ⑥이 요점이다 — Claude 가 "장비를 조작한다"는 것은 도구를 고른다는 뜻이고, 실제 실행은 AI 서버가 대신 한다. 그래야 승인·과금·감사가 한 곳에 남는다.
서버주소맡는 일없으면
포털 웹onbridge.aigate.kr시험 현황 · 사용자·기관 · 문서 · 장비 웹 중계아무것도 못 본다
장비 웹폐쇄망 내부 — 포털을 통해서만실기 화면 · 채널 상태 · 장비 설정현장에 가야 한다
AI 서버ai.aigate.kr로그인 검증 · Claude 중계 · 도구 실행 · 과금 · 적재🔴 나머지는 그대로 돈다
Claude외부 API판단 · 도구 선택 · 문장 생성AI 서버가 자체 모델로 대체 (§05)
🔴 왜 AI 를 별도 주소로 두는가

세 가지가 한꺼번에 해결된다. ①과금 — 유료 경계가 주소로 갈려 무료 기능과 섞이지 않는다. ②장애 격리 — AI 서버가 죽어도 포털과 장비는 돈다. ③데이터 경계 — 외부 모델로 나가는 데이터가 이 서버를 반드시 지나므로, 무엇이 나갔는지 한 곳에서 셀 수 있다.

02

장비 웹을 직접 보는 경로

중계

"장비 돌아가는 것을 직접 본다"를 위해 장비를 인터넷에 열지 않는다. 포털이 리버스 프록시로 중계한다.

ⓐ 포트포워딩 (장비 직접 노출)ⓑ 포털이 중계 ← 채택
주소장비마다 다른 포트onbridge.aigate.kr/device/unist-01/
인증장비마다 따로포털 세션 하나
감사남지 않는다누가 어느 장비를 열었는지 남는다
장비 증설공유기 규칙을 매번 추가장비 목록에 한 줄
위험🔴 보드가 인터넷에 노출된다포털만 노출
전제

보드 웹에는 인증이 없다(벤더 출하 상태). ⓐ 로 열면 그대로 뚫린다. ⓑ 는 포털이 인증을 대신 걸어 주므로 보드 쪽 작업 없이도 성립한다 — 이것이 채택 이유의 절반이다.

03

요청 한 건이 흐르는 길

순서
사용자 AI 서버 Claude 장비 ① "3번 채널 상태 보고 정지할지 판단해줘" 로그인 검증 · 잔여 한도 확인 ② 근거를 붙여 요청 현재 계측 · 최근 이력 · 문서 발췌 ③ 도구 호출 결정 "stop(ch=3)" 을 부르겠다 🔴 승인 게이트 정지=통과 · 기동=사람 승인 ④ AI 서버가 대신 실행 ⑤ 결과 ⑥ 답변 + 근거 + 사용량 ⑦ 전부 적재 — 요청 · 도구호출 · 결과 · 승인 여부 · 토큰 수 과금의 근거이자 §05 자립의 학습 자산
③과 ④ 사이에 게이트가 있다. Claude 는 "무엇을 하겠다"까지만 정하고, 실행 여부는 AI 서버가 판정한다. ⑦이 이 설계의 장기 자산이다.
04

과금

유료

원가는 토큰으로 발생하고, 청구는 패킷으로 한다. 둘의 환산을 어디서 하는지가 과금 설계의 전부다.

요청 1건 질문 · 분석 · 리포트 · 제어 제안 계량 — AI 서버 입력 토큰 · 출력 토큰 도구 호출 횟수 제어 실행 횟수 🔴 요청마다 빠짐없이 원가 — 토큰Claude 청구서 청구 — 패킷고객이 이해하는 단위 환산율 기관별 정산 한도 · 잔량 · 청구서 한도 소진 시 차단
원가와 청구를 분리한다. 토큰은 모델을 바꾸면 값이 달라지지만 패킷 단가는 고객과의 약속이라 쉽게 못 바꾼다. 사이에 환산율을 두면 §05 에서 자체 모델로 갈아탈 때 고객 가격을 안 건드리고 원가만 내려간다.
항목규정
과금 단위패킷 — 요청 1건 + 그에 딸린 도구 호출까지를 한 묶음으로 센다
무료 구간읽기·조회는 포털 기능이므로 과금하지 않는다. 🔴 AI 서버를 거치는 것만 센다
제어 실행별도 계량. 통전 조작은 건수가 적고 값이 크다
한도기관별 월 한도. 소진 시 🔴 AI 만 멈추고 장비·포털은 계속
표시사용자가 답변마다 소모량을 본다. 나중에 청구서로 놀라지 않게
기록정산 근거는 되돌릴 수 없게 append-only
⚠ 먼저 정할 것

패킷 1개를 무엇으로 정의하나. 질문 한 번인가, 대화 한 세션인가, 리포트 한 장인가. 이것이 안 정해지면 계량 코드를 짤 수 없고, 나중에 바꾸면 과거 청구와 어긋난다.

05

자립 경로 — 서버가 Claude 역할을 넘겨받는다

장기

지금 쌓는 요청·도구호출·결과·승인 여부가 그대로 학습·검색 자산이 된다. 다만 처음부터 그 형태로 쌓아야 한다 — 나중에 형식을 바꾸면 이전 데이터를 못 쓴다.

1단계 — 전량 Claude 모든 요청이 외부로 나간다 데이터를 형식 맞춰 쌓는 것이 이 단계의 진짜 목적이다 🔴 로그 스키마를 여기서 확정 2단계 — 갈라 보낸다 정형 질문 · 요약 · 분류는 자체 판단·제어는 계속 Claude 두 답을 대조해 품질을 잰다 원가가 처음 내려가는 지점 3단계 — 자체가 주력 어려운 판단만 외부로 폐쇄망 납품이 가능해진다 — 데이터가 밖으로 안 나간다 청구 단가는 그대로 · 원가만 하락 Claude 자체 모델 — 막대는 처리 비중
1단계에서 지는 부담이 3단계의 자산이 된다. 갈아타는 시점을 정하는 것은 기술이 아니라 대조 성적이다 — 같은 요청에 두 답을 내고 사람이 고른 비율을 본다.
🔴 정정 (2026-09-02) — 자체 모델보다 먼저 할 것이 있다

원가를 내리는 첫 수단은 자체 모델이 아니다. GPU 도 학습도 없이 즉시 되는 것이 넷 있다 — ①모델 등급 분리(정형 작업을 Haiku 로 내리면 1/5 가격) · ②프롬프트 캐싱 · ③배치(급하지 않은 것은 절반) · ④effort 조절.

따라서 2단계는 「자체 모델」이 아니라 「원가 최적화」다. 자체 모델과 GPU 는 그 다음 — 고정비 0 으로 얻을 것을 다 얻고 나서 고정비를 진다. → A07 §04

적재 항목왜 필요한가
요청 원문 · 붙인 근거같은 입력을 자체 모델에 다시 먹여 비교한다
도구 호출 순서와 인자🔴 가장 값진 데이터. "어떤 상황에 무엇을 불렀나"가 곧 업무 지식이다
도구 결과근거 없는 답을 걸러내는 기준
승인/거절 · 사람이 고친 내용사람의 판정이 정답 라벨이 된다
최종 성패 (시험이 잘 끝났나)제안이 옳았는지를 나중에 알 수 있는 유일한 신호
토큰 수 · 지연과금 근거이자 자체 모델과의 비용 비교 기준
06

로그인 — 주소가 셋인데 계정은 하나

인증
#규정
1계정은 포털이 갖는다. AI 서버는 계정을 따로 두지 않는다
2포털이 서명한 토큰을 발급하고 AI 서버가 검증한다. 사용자·기관·권한·한도가 토큰에 실린다
3🔴 토큰은 짧게(분 단위) 두고 갱신한다. 유료 서비스라 탈취 시 비용이 샌다
4AI 서버의 도구 실행은 그 사용자의 권한을 넘지 못한다. 🔴 AI 를 쓴다고 권한이 늘지 않는다
5감사 로그에 사람 + agent 를 함께 남긴다 — "누구의 요청으로 AI 가 무엇을 했나"
🔴 4번이 가장 흔한 구멍

AI 서버가 장비를 조작하려면 강한 권한이 필요하다. 그것을 서버 고정 계정으로 두면 권한 없는 사용자가 AI 를 통해 우회하게 된다. 요청한 사람의 권한으로 실행해야 한다.

07

정해지지 않은 것

결정 대기
#질문왜 지금
1🔴 패킷 1개의 정의계량 코드와 단가표가 여기에 달렸다. 나중에 바꾸면 과거 청구와 어긋난다
2🔴 시험 데이터를 외부 모델에 보내도 되는가고객(UNIST·KAIST) 데이터다. 계약에 걸리면 구조가 바뀐다 — 3단계를 앞당겨야 한다
3AI 서버를 어디에 두나 — 사내 / 클라우드장비 폐쇄망과 어떻게 잇는지가 따라 정해진다
4장비 웹 중계를 전 장비에 줄 것인가보드 웹에 인증이 없어 중계 범위가 곧 노출 범위다
5한도 소진 시 정지 제안도 막을 것인가안전 기능을 돈으로 막으면 사고가 난다. 정지는 무료로 두는 쪽을 권한다

근거 — A03 에이전트 아키텍처(승인 게이트 · 비대칭 권한) · A01 메뉴 트리 · W01 보드 웹 서버 · 08-웹서버구성(보드 웹 인증 부재) · 04-계정·그룹·권한 모델(기관 경계)
관련 — A01 · A02 · A03