project.crowny.org 서비스 레지스트리 v3.2
날짜: 2026-04-26
개요
project.crowny.org에 서비스 레지스트리 기능을 추가. 54개 crowny.org 서비스를 통합 관리하고, 클로드 세션이 중단 후 재개할 때 작업 맥락을 자동 복원하는 시스템.
문제
- 클로드 세션이 중단되면 작업 맥락이 사라짐
- 57개 서비스의 작업 상태를 추적하는 중앙 시스템 없음
- 게이트웨이(gateway.yaml)와 작업 상태가 분리됨
작업 내역
1. 서비스 레지스트리 백엔드 (server.js)
- registry 셀DB 테이블: 54개 서비스 자동 등록 (gateway.yaml에서 파싱)
- work_log 셀DB 테이블: 서비스별 작업 상태 추적 (제목/설명/진행률/다음할일/파일/세션ID)
- API 9종: registry, overview, sync, context, domain CRUD, work CRUD, health
- 자동 상태 감지: 서버 시작 시 디렉토리 존재 여부 → developed/planned/active 자동 판별
- 14개 카테고리: core, infra, docs, creative, finance, commerce, life, culture, community, platform, security, hardware, social, other
2. 핵심 API: /api/registry/context/:domain
- 클로드 세션 시작 시 이 API 하나로 모든 맥락 복원
- 서비스 메타데이터 + 진행 중 작업 + 완료 히스토리 + CLAUDE.md 요약 + resumeHint
resumeHint: "이어서 작업: 서비스 레지스트리 v3.2 구축 (60%) — 다음: 프론트엔드 대시보드 탭 추가"
3. 프론트엔드 (app.js + index.html)
- 사이드바에 "서비스 레지스트리" 버튼 + 배지
- 레지스트리 뷰: 54개 서비스 카드 그리드 (카테고리 필터, 상태 필터, 검색)
- 서비스 상세 뷰: 작업 히스토리, 진행률 바, 작업 등록/업데이트/완료
- 대시보드 뷰: KPI 4개 카드 + 카테고리별 칩 + 최근 작업 리스트
4. CLI 스크립트 (crowny-registry.sh)
~/.claude/scripts/crowny-registry.sh — 클로드 세션에서 레지스트리 조작
- context, work, update, done, overview, health, list 서브커맨드
5. 한선씨 동반
서비스레지스트리.한선 — 레지스트리 API 호출 함수 10개 (컴파일 성공)
6. CellDB 버그 수정
db.update(name, key, val, patch) 시그니처 불일치 버그 발견 → 전체 수정
- 함수 기반 호출 → 올바른 key/val 기반 호출로 교체
관련 파일 경로
/Users/ef/crowny-project/server.js — registry + work_log 테이블, API 9종
/Users/ef/crowny-project/public/js/app.js — 레지스트리 프론트엔드 모듈
/Users/ef/crowny-project/public/index.html — registryView div + 사이드바 버튼
/Users/ef/crowny-project/서비스레지스트리.한선 — 한선씨 동반
/Users/ef/.claude/scripts/crowny-registry.sh — CLI 스크립트
/Users/ef/crowny-project/CLAUDE.md — API 문서 업데이트
사용법
클로드 세션 시작 프로토콜 (추가)
bash# 기존
cat ~/.claude/knowledge/PLAN.md
cat ~/.claude/knowledge/LIVE_STATUS.md
# 추가: 작업 대상 서비스의 맥락 복원
~/.claude/scripts/crowny-registry.sh context <대상서비스>.crowny.org
작업 시작/종료
bash# 시작: 작업 등록
~/.claude/scripts/crowny-registry.sh work market.crowny.org "결제 로직 구현" 0 "포네 연동"
# 종료: 완료 처리
~/.claude/scripts/crowny-registry.sh done market.crowny.org <work_id> "요약"
잔여 이슈
- 프론트엔드 브라우저 실제 테스트 (로그인 후 사이드바 버튼)
- 세션 시작 프로토콜 자동화 (훅 연동)
- 서비스별 DB 정보(db_type, db_path) 자동 감지