크라우니 세계관 통합 선언지 — ecosystem.crowny.org
선언일: 2026-05-27 버전: v1.2 (연동 권고 7 적용 — 24 모듈 / 17 룰) 진입점: ecosystem.crowny.org:9783 언어: 한선씨 v0.38 100% 연관: 시즌1 1단계 · 포네/맘 분배
1. 목적
크라우니 세계관에서 동시에 작업하는 19+ 세션이 다른 도메인·모듈을 찾을 때 첫 진입점. 셀코어 호환 룰 슬롯 인덱스를 제공해 추후 사용자가 "X를 Y로 바꿔"라고 하면 한 모듈 한 줄로 전체 균형이 갱신되도록 설계.
2. 한선씨 모듈 18종 (v1.1 — +7)
| 모듈 | 역할 | 룰 슬롯 (밸런싱 지점) |
|---|---|---|
| 시즌1유통 | 9인 분배·단가·차입한도·단계 판정 | 분모1, 분모2, 단가, 보유_index |
| 시즌1담보 | lien CRUD 영속 | 코드, 크라우니, 단계 |
| 시즌1상태 | 누적 유통 영속 카운터 | 누적, 단계, 트리거 |
| 시즌1보너스 | 9인 완납·선두 3인 판정 | 대여자, 받은자, 시간 |
| 시즌1단가갱신 | 매년 10-01 단가 영속 | 년차, 단가 |
| 시즌1포네맘 | 포네/맘 분배 + 단가 페그 | 포네, 맘, 단가 |
| 시즌1뱅크어댑터 | 담보 ↔ 크라우니뱅크 양방향 동기화 | 보유, LTV_denom, bank_lien_status |
| 맘활동단가 | 걷기/학습/기여/출석/추천 5종 보상 | 활동, 맘단가_배수, 맘단가_분모 |
| 포네페그 | 체결/정산/혼합 3 페그 모드 | 거래유형, peg_mode |
| 시즌1알림 | 단가갱신 cron → 메신저/Slack | 환경, channels |
| 시즌2설계 | 27인·1/81·5상태 4이행 | 누적, 완납자수, 단계 이행 |
| 메신저v3 | 카카오톡/텔레그램 대체 소버린 (다른 세션) | crowny_id, wallet_asset, E2E, i18n, 6트릿 |
| 생태계헬스진단 | 7도메인 백엔드+게이트웨이 diff (trident_cache_stale) | direct, gateway, verdict |
| 뱅크시즌1통합 | 거울 lien → crowny-bank 본원장 11칸 + 신용점수 | 거울_상태, 본원장_상태, P2P_여신가능, 신용점수 |
| 맘활동인증 | 5종 외부 인증 (Apple Health/JWT/GitHub/daily/추천) | 일평균보, 토큰만료, merged, 날짜중복, 코드사용여부 |
| 포네환율 | 라이브 환율 캐시 + 이상치 정적 폴백 | diff_pct, 소스, 나이_분 |
| 메신저알림 | talk-api:9766 시스템 채널 (TLS 미완 회피) | 메신저_가용, 채널, 우선순위 |
| 시즌2명단 | 신규 18인 입력 (등록/검증/sso/27인 합치기) | 슬롯, 코드_중복, 이메일_유효, sso_확인 |
v1.2 진입 모듈 7종 (2026-05-28, 연동 권고 적용 사이클)
| 진입 모듈 | 위임 대상 | 핵심 함수 |
|---|---|---|
| 시즌1뱅크진입 | 시즌1뱅크어댑터 + 뱅크시즌1통합 | 뱅크진입_lien업서트 → 거울+본원장 동시 |
| 맘활동진입 | 맘활동단가 + 맘활동인증 | 맘진입_검증경유_기록 → 인증→승인→적립 |
| 포네페그진입 | 포네페그 + 포네환율 | 포네페그진입_KRW환산_라이브우선 |
| 알림진입 | 시즌1알림 + 메신저알림 | 알림진입_단가갱신 → 이중 로깅 |
| 시즌2진입 | 시즌2설계 + 시즌2명단 | 시즌2진입_27인_코드/이름 (시즌1 9 + 명단 18) |
| 시즌1여신게이트 | 뱅크시즌1통합 | 게이트_대여허가체크 → bank P2P 전 사전 검증 |
/api/health/full | 생태계헬스진단 (생태계서버 내부) | 7도메인 일괄 진단 |
3. 도메인 매핑
| 도메인 | 포트 | 역할 |
|---|---|---|
| ecosystem.crowny.org | 9783 | 본 통합 선언지 |
| finance.crowny.org | 9753 | 시즌1 24 라우트 |
| docs.crowny.org | 4100 | 선언 문서 |
| bank.crowny.org | 9400 | 크라우니뱅크 (시즌1뱅크어댑터 거울 대상) |
| pay.crowny.org | 9866 | 크라우니페이 (포네페그 진입점) |
| talk.crowny.org | 9601 | 크라우니메신저 (시즌1알림 채널) |
4. API 라우트 (9개)
GET / → HTML 인덱스 (모듈/도메인/밸런싱 가이드)
GET /api/modules → 11 모듈 메타 + 룰슬롯
GET /api/season1 → 시즌1 핵심 산식 (9 키)
GET /api/season2 → 시즌2 설계 요약 (10 키)
GET /api/finance → finance.crowny.org 백엔드 상태
GET /api/rules → 11개 셀코어 룰 + 밸런싱 지점
GET /api/domains → 6 도메인 매핑
GET /api/find?keyword=X → 모듈·룰 매치 확인
GET /api/declaration → 통합 선언 요약
GET /api/health → 헬스
5. 셀코어 룰 슬롯 (11개)
각 룰은 조건 → 변경 → 밸런싱 지점 3종 정보를 포함한다. 사용자가 정책 변경을 요청하면 룰 한 줄만 수정해 전체 시스템이 자동 갱신.
예: 단계1 분모 729 → 512 변경 시
std/시즌1유통.한선의시즌1_단계1_분모() { 반환 512 }- 시즌1뱅크어댑터 룰의
LTV_denom슬롯이 새 분모를 참조 - 차입한도가 자동 재계산되어 finance/9753의
/api/loan응답이 즉시 변경 - 맘활동단가·포네페그는 독립이라 영향 없음
6. 에이전트 협업 원칙 (2026-05-27 확정)
- 사람 속도·일관성: 한 번에 한 모듈, 인수인계 가능한 단위
- 베이스 컨텍스트 동봉:
/tmp/에이전트_베이스컨텍스트.md(헌법·툴·표준 일관 전달) - 셀코어 룰로 구조화: 모든 동적 결정은 룰 슬롯으로 → 추후 밸런싱 가능
- 결과 표준: 한선씨 라이브러리(.한선+.han) + 자가검증 + docs 선언 + 학습DB 등록
7. v0.38 함정 (학습 등록)
이번 사이클에서 발견한 silent fail 함정:
- 3중 import: 시즌1포네맘+셀코어, 시즌1유통+시즌2설계+웹서버틀 silent fail
- 회피: 셀코어 룰 헬퍼는 자체 정의(맵 반환), 시즌2 값은 인라인 함수 우회
8. 잔여 (v1.1에서 6개 모두 해결)
-
gateway trident 캐시 복구— 헬스진단 도구 + trigger 정교화. 직접 진단 한선씨 한 줄로 가능 -
bank 본 모듈 정식 통합— 뱅크시즌1통합 11칸 원장 + 신용점수 규약, 자가검증 6/6 통과 -
맘 활동 외부 인증— 5종 인증 어댑터 + 자동 적립 플로우 -
포네페그 라이브 환율— 캐시 + 이상치 정적 폴백 + 3 룰 -
시즌1알림 TLS 회피— talk-api:9766 loopback POST (TLS 안 거침) -
시즌2 18인 명단— 입력 도구(CLI/HTTP) + 검증 룰 2개, 사용자가 채울 placeholder 유지
v1.2 적용 완료 (2026-05-28)
-
메신저알림 위임 통합— 알림진입.한선 (MOCK 모드 검증) -
bank lien 동기 자동— 시즌1뱅크진입.한선 (자가검증 4단계) -
포네 라이브 환율 우선— 포네페그진입.한선 -
맘활동 인증 경유— 맘활동진입.한선 -
시즌2 27인 dispatch— 시즌2진입.한선 -
bank P2P 여신 게이트— 시즌1여신게이트.한선 (효과 예측 단계1→단계2 정확) -
생태계 /api/health/full— 9783에서 7도메인 일괄 진단
v1.3 후속 (별도 사이클)
- 메신저알림 실 발송 (talk-api:9766 LISTEN 시 자동 전환 — 진입 모듈 그대로 동작)
- 포네환율 라이브 fetch 실구현 (v0.39 TLS 도입 후)
- 시즌2 신규 18인 실명 입력 (사용자가 시즌2명단/시즌2진입 도구로 직접)
- 시즌1여신게이트 외부 사용자 분기 fix (현재 본원장 빈 응답 분기 버그)
- 원장.한선 API_대여하기에 시즌1여신게이트 정식 통합 (현재는 호출 측 선택)
9. 관련 파일
한선씨 라이브러리 18종 (/Users/ef/Downloads/CrownyTVM/std/)
- 시즌1 기반 6: 시즌1유통/담보/상태/보너스/단가갱신/포네맘
- v1.0 신규 5: 시즌1뱅크어댑터, 맘활동단가, 포네페그, 시즌1알림, 시즌2설계
- v1.1 신규 6: 생태계헬스진단, 뱅크시즌1통합, 맘활동인증, 포네환율, 메신저알림, 시즌2명단
- 메신저: 메신저v3 (다른 세션,
CrownyOS/apps/메신저/v3/서버코어.한선)
/Users/ef/Downloads/CrownyTVM/시즌1서버.한선— 9753 / 24 라우트/Users/ef/Downloads/CrownyTVM/생태계서버.한선— 9783 / 9 라우트
~/Library/LaunchAgents/org.crowny.finance.season1-price.plist— 매년 10-01 00:00
- 시즌1 1단계:
2026-05-23-crowny-finance-season1-phase1-declaration.md - 포네/맘 분배:
2026-05-23-crowny-finance-season1-fone-maam.md - 시즌2 설계:
2026-05-27-crowny-finance-season2-design.md - 시즌1뱅크어댑터:
2026-05-27-시즌1뱅크어댑터.md - 맘활동단가:
2026-05-27-맘활동단가.md - 포네페그:
2026-05-27-포네페그.md - 시즌1알림:
2026-05-27-시즌1알림-단가갱신-cron-통합.md
project_crowny_finance_season1.mdreference_ecosystem_crowny.mdfeedback_agent_directive_style.md