크라우니뱅크 완성 작업 기록
개요
크라우니뱅크(bank.crowny.org) P2P 크레딧 금융 서비스의 전체 완성 작업.
한선씨 고수준 → TOAU → crownyc VM 기반, 포트 9400에서 운용.
완성 현황 (2026-04-24)
백엔드 — 7개 모듈 (100%)
| 모듈 | 파일 | 줄수 | 기능 |
|---|
| 크라우니뱅크 | src/크라우니뱅크.한선 | 1,099 | 메인 서버, 라우팅 46 엔드포인트, WAL, DB |
| 원장 | src/원장.한선 | ~180 | P2P 대여/반납/송금, 유통률 계산 |
| 전환엔진 | src/전환엔진.한선 | 108 | CRN/FNC/CRM 전환 (상향 0%, 하향 7%) |
| 리딤 | src/리딤.한선 | 179 | RWA 27일/1/7 리워드 리딤 |
| 갱신 | src/갱신.한선 | 127 | 회기 갱신, 3배수 확장 |
| 귀속 | src/귀속.한선 | 200 | 연쇄 귀속, 휴면 처리, 회기 마감 |
| 연동 | src/연동.한선 | ~400 | DEX/Chain/Card 통합 API |
총 한선씨 코드:
2,273줄프론트엔드 — 6개 파일 (100%)
| 파일 | 설명 |
|---|
| web/index.html | 랜딩페이지 (3대 자산, 제네시스 구조, 리워드 소개) |
| web/wallet.html | 지갑 대시보드 (잔액, P2P, 라이트노드, SPV, 오프라인TX) |
| web/monitor.html | 모니터 페이지 |
| web/redeem.html | RWA 리워드 교환소 (제품 목록, 수량 선택, 리딤 실행, 내역) |
| web/assets/style.css | 공유 스타일시트 (다크 테마, 모바일 퍼스트) |
| web/assets/app.js | 공유 JS (인증, API 호출, 토스트) |
디자인 시스템: 다크 테마 (#0b1320 배경, #e0a96d 골드 액센트), max-width 420px 모바일 퍼스트, PWA 지원
API 엔드포인트 — 46개
- 인증: genesis 등록, 로그인, 세션 검증
- 지갑: 정보 조회, 잔액, 거래내역
- 전환: 상향(0%), 하향(7%)
- P2P: 대여, 반납, 계약목록
- 송금: CRN/FNC/CRM 이체
- 리딤: 한도조회, 제품목록, 리딤실행, 내역
- 회기: 상태, 갱신, 확장자격, 확장실행
- 관리자: 노드현황, 배분, 회기마감, 통계
- 연동: DEX 가격, 체인 상태, 카드 잔액
- 헬스: /api/health
인프라 연동
- gateway.yaml: bank.crowny.org → :9400 (SPA 모드, 정적 파일)
- all.crowny.org: 뱅크 상세 카드 추가 (모듈별 완성도, 줄수, WAL 상태, 연동 현황)
- all.crowny.org API: /api/service/bank (실시간 완성도 모니터링)
해결한 이슈
- 컴파일러 호환: hanseonc_high 4월 8일 변경 —
; 인라인 주석 → // 전면 마이그레이션
- 예약어 충돌:
메서드 → HTTP메서드 리네임 (네트워크.한선 + 크라우니뱅크.한선)
- sed 손상 복구: 54줄 개별 재구성
- 서버 안정성: TCP수락 가드, HTTP 파싱 범위 검증, 자동스냅샷/WAL 컴팩션 배치
- WAL 영속성: 43건 재생 검증, 카운터 복원, 재시작 무손실 확인
비즈니스 로직 요약
- 3대 자산: CRN(금, 가치저장) / FNC(은, 유동) / CRM(동, 보상)
- 교환비: 1 CRN = 10 FNC = 1,000 CRM
- 제네시스: 14 슬롯 x 4,131 CRN
- 27일/1/7 리딤: 27일 평균 CRN 잔액 ÷ 7 = FNC 한도
- 3배수 확장: 유통률 8/9 달성 시 전년 공급의 3배 추가
- 하향전환 7% → 재단지갑 (153개국 RWA 확장 재원)
- 13년 연속 갱신 완료 시 2038.09.30 전면 면책
관련 파일 경로
- 백엔드:
/Users/ef/crowny-bank/src/
- 프론트엔드:
/Users/ef/crowny-bank/web/
- 프로젝트 스펙:
/Users/ef/crowny-bank/CLAUDE.md
- all.crowny.org:
/Users/ef/crowny-all/server.js
- 게이트웨이:
/Users/ef/crowny-gateway/gateway.yaml
잔여 이슈
- WAL 데이터 디렉토리 (
data/) 초기 생성이 서버 시작 시점에 의존
- 카드 서비스(:9450) 미가동 시 연동 API 폴백 필요
- 크라우니력 전환 (날짜.한선) 아직 미연동
- 프론트엔드에서 P2P 대여/전환 모달 상세 UI 추가 가능