게이트웨이 2026-06-10 5KB 읽기 5분

원크라우니 gateway 등록 핸드오프 (Wave4 T3 배포운영화)

개요

원크라우니 통합 정체성 백엔드를 "진짜 돌아가는 서비스"로 격상하기 위한 gateway 세션용 요청 문서다. 백엔드 세션(본 작업)은 LISTEN까지만 책임지며 gateway.yaml을 직접 편집하지 않는다. 아래 항목을 gateway 세션이 ~/.claude/scripts/crowny-ports.sh set ... (= gateway.yaml SSOT)로 등록해 주기를 요청한다.

작성: 2026-06-10 / 백엔드 세션(원크라우니 T3-배포운영화)

요청 라우팅 항목

도메인(요청)	백엔드 포트	서비스 본체	헬스
one.crowny.org	9420	원크라우니 통합 API (`/Users/ef/crowny-app/원크라우니API.한선`)	`GET /api/health`
one.crowny.org (예약)	9421	원크라우니 웹 UI 서버 (예정 — 현재 미구현)	`GET /health`

도메인은 one.crowny.org 를 요청한다. (사유: app.crowny.org 는 이미 :9820 crowny-app 앱 생태계가 점유 — 충돌 회피. 원크라우니 = 통합 정체성/온보딩 단일 진입점이라 별도 one.* 서브도메인이 의미상 적합.)

포트 충돌 체크 결과 (crowny-ports.sh check)

작업 세션에서 실측한 결과:

$ crowny-ports.sh check 9420
[사용가능] 포트 9420는 gateway.yaml에 미등록
[주의] 프로세스 실행 중: PID=... (crownyc)   ← keepalive가 띄운 라이브 API(정상)

$ crowny-ports.sh check 9421
[사용가능] 포트 9421는 gateway.yaml에 미등록

$ crowny-ports.sh get one.crowny.org
[미등록] 'one.crowny.org' 서비스를 찾을 수 없습니다   ← 새 도메인 등록 가능

$ crowny-ports.sh free 9420 9430
9420 9421 9422 ... 9430 (11개 사용 가능)

9420 / 9421 모두 gateway.yaml 미등록 → 신규 등록 안전.
9420의 "프로세스 실행 중"은 keepalive가 띄운 라이브 API 본체이며 충돌이 아니다.
one.crowny.org 도 미등록 → 새 도메인으로 점유 가능.

gateway 세션이 실행할 등록 명령 (제안)

bash# 1) API 백엔드 등록 (현재 라이브)
~/.claude/scripts/crowny-ports.sh set one.crowny.org 9420
#    → gateway.yaml + PORTS.md 갱신 + 브로드캐스트

# 2) (웹 UI 서버 구현 후) 보조 포트 등록 — 현재는 보류
# ~/.claude/scripts/crowny-ports.sh set one-web.crowny.org 9421

라우팅은 one.crowny.org → 127.0.0.1:9420 (API). 웹 UI 서버(:9421)는 원크라우니웹.한선 구현 완료 후 별도 항목으로 추가 요청 예정.

상시구동 / 운영 보증 (백엔드 세션 책임 범위 — 완료)

상시구동: /Users/ef/crowny-app/원크라우니-keepalive.sh

once = 1회 점검(CI/자가검증), 인자 없음 = 15초 간격 감시 루프.

죽으면 재컴파일(CROWNY_STD=libs hanseonc_high) 후 백그라운드 재기동.

헬스(/api/health) 또는 포트 LISTEN(lsof)로 생존 판정 → 중복 기동 없음(idempotent).

실측: once 1회차 → :9420 부팅 + {"status":"ok",...} 응답 + LISTEN 확인.

2회차 → 재시작 없음(이미 살아있음). 원크라우니웹.한선 미존재 → 조용히 skip.

상시 기동 예시: nohup /Users/ef/crowny-app/원크라우니-keepalive.sh > /tmp/onecrowny-keepalive.log 2>&1 &

영속화 검증: /Users/ef/crowny-app/원크라우니_운영.한선

셀DB 디스크 라운드트립(저장 → 메모리 비움 → 재로드 → 회원 복원).

데이터 디렉토리: /Users/ef/crowny-app/data/onecrowny/{사용자,인증,권한}.celdb.

실측 결과: 티 — 영속화 라운드트립 전체 통과 (회원 3명 복원, 아이디 일치).

잔여 이슈

원크라우니웹.한선(:9421) 미구현 — keepalive/핸드오프에 자리만 예약. 구현 후 gateway 보조 항목 추가 요청.
gateway 세션이 one.crowny.org 등록 후, 게이트웨이 trident/health 캐시 복구는 gateway 세션 담당(백엔드 책임 외).
인증.celdb 는 현재 ID불러오기에서 미복원(스키마 라이브러리 설계상 사용자/권한만 복원) — 세션 토큰은 휘발성 설계라 의도적. 영구 세션 필요 시 스키마 라이브러리 확장 별도 작업.

← 이전원크라우니 Wave6 T4 — gateway 핸드오프 + 고수준 컴파일러 인자손상 버그 리포트2026-06-10-원크라우니-gateway등록+컴파일러버그 다음 →원크라우니 Wave3 — C-네이티브crowny브릿지2026-06-10-원크라우니-wave3-C네이티브crowny브릿지