CrownyDoc 문서함 견적서 제안서 도면 + 새 문서 문서편집기 프로젝트문서 기술백서
← 목록
기타 2026-06-22 8KB 읽기 9분

THE IRUM 화이트라벨 온보딩 & 포털 완성

완료 날짜: 2026-06-22 상태: 완성 ✓ 세션 ID: 4c7b1383 (general)

개요

academy.crowny.org 멀티테넌시 플랫폼의 화이트라벨 온보딩 시스템 및 관리자 포털 완성.

신규 가맹학원이 자신만의 브랜드로 academy.crowny.org를 운영할 수 있도록 하는 완전한 세트.

산출물

1. 테넌트 레지스트리 시드

경로: /Users/ef/crowny-academy/데이터/_테넌트/theirum.json 크기: 1,462 bytes 검증: ✓ JSON 형식/스키마 준수

내용:

  • academyId: "theirum"
  • name: "THE IRUM 더이룸"
  • 브랜드색상: navy#0f172a + amber#f59e0b
  • geminiLinks: 6개 (국어/EBS/영어/수학 진단 플레이스홀더)
  • netlifyApps: 3개 (MBTI/초등/중등 진단)
  • sns: 3개 채널 (네이버블로그/플레이스/인스타)

2. 온보딩 페이지

경로: /Users/ef/crowny-academy/public/theirum/onboard.html 크기: 23.3 KB 타입: HTML5 SPA

기능:

  • 기본정보탭: 학원ID/이름/도메인/로고
  • 브랜드탭: 3색 선택 + 미리보기
  • 공식채널탭: Gemini 6개/Netlify 3개/SNS 3개
  • POST /api/tenant 통합
  • 유효성 검증 (academyId: /^[a-z0-9_-]{1,64}$/i)
  • 색상동기화 + 로고미리보기
  • 반응형 디자인 (모바일)
UI: 크라우니 베이지/골드 토큰 (플랫폼 셸)

3. 관리자 포털

경로: /Users/ef/crowny-academy/public/theirum/index.html 크기: 21.8 KB 타입: HTML5 SPA

5개 탭:

  1. 대시보드: 통계 + Chart.js 바차트 + 최근리포트
  2. 채점 업로드: 드래그드롭 + 이미지/PDF + 자동채점
  3. 진단 결과: 학생별 5역량 + 레이더차트
  4. 리포트 관리: 주간/월간 + 공유링크
  5. 설정: 테넌트정보 + 브랜드색상실시간변경
특징:
  • /api/tenant/current 자동로드
  • 테넌트별 브랜드색상 동적 주입
  • 사이드바 네비게이션
  • 반응형 레이아웃

4. 화이트라벨 헬퍼

경로: /Users/ef/crowny-academy/public/theirum/theirum.js 크기: 4.6 KB 타입: JavaScript IIFE Module

기능:

  • Theirum.init(): /api/tenant/current 로드 + CSS변수주입
  • Theirum.getTenant(): 현재 테넌트정보 반환
  • Theirum.getColor(name): 색상조회
  • Theirum.renderGeminiLinks(id): 동적링크렌더
  • Theirum.renderNetlifyApps(id): 동적앱렌더
  • Theirum.renderSNSLinks(id): 동적SNS렌더
CSS변수:
  • --brand-primary
  • --brand-accent
  • --brand-dark

5. 기술문서

경로: /Users/ef/crowny-academy/public/theirum/README.md 크기: 9.8 KB

섹션:

  • 파일구조
  • 온보딩플로우 (3단계)
  • 관리자포털 기능
  • 테넌트해석 (5단계우선순위)
  • 테넌트레지스트리 스키마
  • API 엔드포인트 (테넌트/채점/리포트)
  • 화이트라벨 헬퍼 사용법
  • 개발가이드 (로컬테스트/추가테넌트/호스팅)
  • 보안고려사항
  • FAQ

6. 사용자가이드

경로: /Users/ef/crowny-academy/THEIRUM_ONBOARDING_GUIDE.md

섹션:

  • 1단계: 온보딩페이지 접속
  • 2단계: 가맹학원 등록 (입력항목표)
  • 3단계: 관리자포털 접속
  • 테넌트 데이터 구조
  • API 엔드포인트 전체
  • 화이트라벨 커스터마이징
  • 호스팅옵션 (서브도메인/CNAME/쿼리)
  • 테넌트해석 우선순위
  • 생성된 파일 목록
  • 테스트체크리스트 (9개항)
  • 보안주의
  • FAQ 8개
  • 릴리스노트 (v1.0/v1.1예정)

7. 완성보고서

경로: /Users/ef/crowny-academy/IMPLEMENTATION_REPORT.json

포함:

  • 프로젝트명/완료일자/상태
  • 산출물 상세 (파일/타입/크기/설명)
  • 테넌트스키마 필드 및 검증
  • 온보딩페이지 기능 (8개)
  • 관리자포털 탭 (5개 + 기능)
  • 화이트라벨헬퍼 API (6개함수)
  • API엔드포인트 (테넌트6개, 기타)
  • 테넌트해석우선순위
  • 데이터구조
  • 보안정책
  • 테스트체크리스트
  • 완성메트릭스

규칙 준수 확인

도메인 고정 규칙

  • ✓ 실명/외부 사례 거명 금지 (PLACEHOLDER 사용)
  • ✓ 크라우니 용어만 사용 (FONE 아님, Cloudflare 미사용)
  • ✓ THE IRUM 테넌트는 navy#0f172a + amber#f59e0b (사용자 지정)
  • ✓ 포트 9865는 SSOT gateway.yaml에서 관리

한선씨 동반

  • 해당 없음 (JSON/JavaScript/HTML만 사용)
  • 필요시 학원서버.한선 참조

멀티테넌시 구현

  • ✓ lib/tenant.js (resolveTenant/tenantSub/loadTenant/saveTenant) 재사용
  • ✓ modules/tenant/routes.js 기존 API 통합
  • ✓ 테넌트해석 5단계 우선순위 구현
  • ✓ 데이터분리 (theirum=루트, 신규={academyId}/접두)

테넌트 스키마

  • ✓ academyId: /^[a-z0-9_-]{1,64}$/i 검증
  • ✓ name: 문자열
  • ✓ brandPrimary/Accent/Dark: hex color
  • ✓ logo: URL
  • ✓ cname: 선택사항
  • ✓ geminiLinks: 배열 {title, url}
  • ✓ netlifyApps: 배열 {title, url}
  • ✓ sns: {naverBlog, naverPlace, instagram}
  • ✓ createdAt/updatedAt: ISO 8601

보안

  • ✓ 공개: GET /api/tenant/current, 정적파일
  • ✓ 관리자: POST/PUT/DELETE, seed
  • ✓ 인증: Bearer token + X-Academy-Token

API 통합

기존 구현 재사용

  • lib/tenant.js: resolveTenant(), loadTenant(), saveTenant()
  • modules/tenant/routes.js: 6개 엔드포인트 (GET/POST/PUT + seed)
  • 검증: academyId 정규식, 필드화이트리스트

신규 호출

  • onboard.html: POST /api/tenant (신규등록) → 201 Created
  • index.html: GET /api/tenant/current (현재정보) + PUT /api/tenant/:id (수정)

미통합 (기존)

  • modules/scoring/routes.js: POST /api/scoring/upload
  • modules/report/routes.js: POST /api/report/student/:id/generate
  • (포털에서 모의)

테넌트 해석 우선순위

1. X-Academy-Tenant 헤더
2. ?tenant= 쿼리파라미터
3. Host 서브도메인 ({id}.academy.crowny.org)
4. CNAME 맵 (테넌트레지스트리)
5. 기본값 ('theirum')

구현처

  • lib/tenant.js resolveTenant()
  • modules/tenant/routes.js에서 호출

호스팅 옵션

옵션1: 서브도메인 (기본)

sample-academy.academy.crowny.org/public/theirum/index.html
resolveTenant()가 자동 감지

옵션2: CNAME (커스텀도메인)

academy.myschool.com → CNAME academy.crowny.org
테넌트레지스트리: cname: "academy.myschool.com"

옵션3: 쿼리파라미터

academy.crowny.org/public/theirum/index.html?tenant=sample-academy

파일 위치 정리

파일경로용도
theirum.json데이터/_테넌트/시드
onboard.htmlpublic/theirum/온보딩 SPA
index.htmlpublic/theirum/관리자 포털 SPA
theirum.jspublic/theirum/헬퍼 JS
README.mdpublic/theirum/기술문서
THEIRUM_ONBOARDING_GUIDE.md루트사용자가이드
IMPLEMENTATION_REPORT.json루트완성보고서

테스트 체크리스트

  • onboard.html 로드
  • 기본정보 입력 (학원ID, 이름)
  • 브랜드색상 선택
  • POST /api/tenant 실행 → 201
  • 관리자포털 접속
  • 대시보드 데이터 로드
  • 색상 실시간 적용
  • 공식채널 링크 렌더링
  • 설정에서 색상변경 → 저장 → 새로고침 유지

남은 과제 (다음 세션)

  1. 포털: 실제 API 호출 (지금은 모의)
- POST /api/scoring/upload - GET /api/report/student/:id - POST /api/diagnosis/mbti

  1. 학부모 포털 통합
- portal/report.html 연동 - 공유링크 토큰 생성

  1. 고급기능
- Gemini 실시간 동기화 - 다중통화 지원 - 분석 대시보드 고도화

  1. 배포
- gateway.yaml 업데이트 - stunnel cert 생성 - DNS CNAME 설정

문서 참조

  • 주관리사: /Users/ef/crowny-academy/CLAUDE.md
  • 기술참조: /Users/ef/crowny-academy/modules/tenant/routes.js
  • 헬퍼참조: /Users/ef/crowny-academy/lib/tenant.js
  • 마스터플랜: /Users/ef/crowny-academy/docs/마스터플랜.md

완성 메트릭스

  • 온보딩페이지: 1개
  • 관리자포털: 1개
  • 화이트라벨헬퍼: 1개
  • 테넌트시드: 1개
  • 문서: 4개 (README + 가이드 + 보고서 + CLAUDE)
  • 총 파일: 7개
  • 총 코드라인: ~3,000+ (HTML/CSS/JS)
  • 총 크기: ~60KB

상태: 완성 ✓ 검증: JSON/HTML/JS 형식 검증 통과 준비도: 프로덕션 배포 대기

← 이전이음미디어 크라우니ERP (leum.crowny.org) 구축2026-06-22-leum-crowny-erp다음 →tiomta.com — keepalive 영속화 + IG/Threads 단건 임베드2026-06-22-tiomta-keepalive-임베드

관련 문서

Phase 2 연동 스펙 — Tradovate · NinjaTrader · TradingView 챌린지 룰 설계 (온체인 고정) 포네 결제 모듈 스펙 교육 커리큘럼 초안 crowny-sweep — Crowny 데이터 관리 도구2026-04-14
1 / 1