크라우니독 기술백서 프로젝트문서 오피스 계획판 셀그래프
← 목록
엔터프라이즈 2026-06-15 18KB 읽기 18분

Enterprise ERP 실제화 + Padella 게임화 라운드1

개요

enterprise.crowny.org (포트 9701/9700) 를 실제 ERP 시스템으로 탈바꿈하고, 빠델라 웹스튜디오 (padella.crowny.org:9874) 의 천상 월드 게임셸 개념을 확장하여 ERP를 6대관리 게임화 플랫폼으로 통합하는 라운드1 작업.

우리 목표:

  • ERP = 한글 RPN 크라우니 네이티브 (JS 래퍼 최소화)
  • 게임화 = 기존 자산 조립 (데일리콘솔.한선 XP/레벨/스트릭 + 미션카드)
  • 실제운영 = 47테이블 dat 영속 + SSE 실시간 알림 + SLA 에스컬레이션

A. 인프라 수정 (2026-06-15 완료)

상태: 라이브 배포 완료 · 배포 검증 GREEN

A-1: dat 영속 결함 근본수정

문제: 파일존재() 반환값 -1 오류 (파일이 존재해도 -1 반환) → 47테이블 .dat 재기동 복원 실패 → 데이터 손실 위험.

근본 원인: 크라우니 VM 함정 — 파일존재(경로) 함수는 1(참) / 0(거짓) / -1(미초기화) 3값 반환. 무방비하게 사용시 -1 잘못 감지.

수정: 

hanseon; 헬퍼: 파일이 실제 있는지 확인 (_dat있음)
함수 _dat있음(경로) {
    변수 크기 = 읽기(경로)
    변수 실제 = 글자수(크기)
    만약 (실제 > 0) { 반환 1 }
    반환 0
}

; 47테이블 복원 패턴
함수 DB불러오기() {
    만약 (_dat있음("./data/erp.dat")) {
        변수 전체 = 읽기("./data/erp.dat")
        ; 구조화 복원 로직...
    }
    반환 0
}

효과:

  • 서버 재기동 시 dat 자동 감지 활성화
  • 47테이블 전체 복원 가능
  • 데이터 손실 방지
관련 파일: /Users/ef/crowny-enterprise/서버.한선 (1~50줄), libs/셀DB행맵헬퍼.한선

A-2: 알림.한선 flat-array 버그 수정

문제: 알림전파() 함수가 구독자 명부를 조회하되, flat array 인덱싱으로 오작동.

hanseon; 버그: flat 배열 [필드1, 값1, 필드2, 값2, ...] → 인덱스 계산 틀림
변수 구독목록 = 조회(_구독DB, "이벤트유형", "==", 유형)
변수 i = 0
동안 (i < 길이(구독목록)) {
    변수 키 = 원소(구독목록, i * 2)    ; ← 틀린 오프셋 계산
    변수 값 = 원소(구독목록, i * 2 + 1)
}

수정: 

hanseon; 정확: 조회() → 행맵 배열 반환 → 맵꺼내()로 필드 접근
변수 구독목록 = 조회(_구독DB, "이벤트유형", "==", 유형)
변수 i = 0
동안 (i < 길이(구독목록)) {
    변수 구독행 = 원소(구독목록, i)            ; ← 행맵 객체
    변수 활성여부 = 맵꺼내(구독행, "활성")    ; ← 필드 조회
    i = i + 1
}

효과:

  • 알림 발행/구독 정확성 보장
  • 이벤트 버스 실시간 동작
관련 파일: /Users/ef/crowny-enterprise/libs/알림.한선 (61~81줄)

A-3: SSE 실시간 알림 (Server-Sent Events)

신규: 폴링(polling) 대신 Server-Sent Events (SSE) 로 실시간 알림 스트림.

구현: 

hanseon; 서버.한선 — SSE 핸들러
만약 (경로 == "/api/events/stream") {
    _SSE연결맵 = 맵넣어(_SSE연결맵, 사용자ID, 소켓번호)
    응답_SSE_헤더 쓰기   ; "Content-Type: text/event-stream"
    ; 메인루프에서 이벤트 발행 시마다:
    ;   문자열쓰기(소켓번호, "data: " + JSON직렬화(알림) + "\n\n")
}

클라이언트: 

javascript// proxy.js 또는 웹프론트
const sse = new EventSource('/api/events/stream');
sse.onmessage = (e) => {
    const data = JSON.parse(e.data);
    console.log('알림:', data);
    // 화면 갱신
};

효과:

  • 폴링(5~10초 주기) → SSE(즉시 전달)
  • 브라우저 CPU 부하 감소
  • 실제감 있는 UX
관련 파일: /Users/ef/crowny-enterprise/서버.한선 (55~59줄 _SSE연결맵), proxy.js

A-4: SLA 에스컬레이션 타이머

신규: 워크플로우 만료 체크 — 60초 주기 근사(완전 정확하지 않음).

hanseon; 메인루프 (서버.한선 메인())
변수 _SLA타이머 = 0

동안 (참) {
    ; 요청 처리...
    
    _SLA타이머 = _SLA타이머 + 1
    만약 (_SLA타이머 >= 60) {
        ; WF만료체크() — 승인 대기 중 만료된 항목 에스컬레이션
        워크플로우_SLA_체크()
        _SLA타이머 = 0
    }
}

함수 워크플로우_SLA_체크() {
    변수 대기목록 = 워크플로우_대기조회()
    변수 i = 0
    동안 (i < 길이(대기목록)) {
        변수 항목 = 원소(대기목록, i)
        변수 경과시간 = 현재시간() - 항목["생성일시"]
        만약 (경과시간 > 86400) {  ; 24시간
            ; 상위결재자로 에스컬레이션 (알림 발행 + 우선순위 상향)
            알림발행("경보", "워크플로우", "승인 24시간 초과", item.제목, "시스템")
            항목["우선순위"] = 9
        }
        i = i + 1
    }
}

한계: VM 메인루프 주기 불규칙 → 정확히 60초 아님. 경악 알림용으로는 충분.

관련 파일: /Users/ef/crowny-enterprise/서버.한선 (52~54줄 _SLA타이머), modules/워크플로우.한선

배포 검증 (06-15 10:30 UTC)

항목상태메모
dat 불러오기✅ GREEN47테이블 구조 복원 동작
SSE data:connected✅ GREEN클라이언트 수신 확인
전역 회귀✅ GREEN기존 API 동작 불변 (45개 GET 열림)
알림 발행/구독✅ GREEN이벤트 버스 정상 전파
SLA 타이머✅ GREEN워크플로우 만료 감지 (60초 근사)

C. 게임화 아키텍처 (설계, 라운드1)

개념: Padella 천상 월드(5방 게임셸) 패턴을 ERP에 적용 → 6대관리 = 6방, 업무 = 미션카드.

C-1: 게임셸 (game-shell.js 재활용)

기존: padella.crowny.org/world.html

  • 5방 포털 (plaza/kitchen/reserve/library/lounge)
  • HUD (로고 + 시계)
  • 하단 독(dock) — 5개 버튼
  • 패럴랙스 배경 + 씬 페이드 전환
확장: enterprise-world.js (ERP용 6방) 
javascriptconst SCENES = [
    '전략실',      // 대시보드 (KPI, 비전)
    '재무실',      // 회계, 예산
    '인사실',      // HR, 급여
    '생산실',      // BOM, 작업지시
    '영업실',      // CRM, 파이프라인
    '운영실'       // 자산, 워크플로우
];
const SCENE_IDS = ['strategy', 'finance', 'hrm', 'production', 'sales', 'operations'];
const SCENE_ICONS = ['🎯', '💰', '👥', '⚙️', '📈', '🔧'];

HUD 확장: 

javascript// 게임셸 HUD 확장
<div class="hud-stats">
    <div class="stat">레벨 <span id="level">1</span></div>
    <div class="stat">XP <span id="xp">0</span>/100</div>
    <div class="stat">스트릭 <span id="streak">0</span>일</div>
</div>

씬 매핑: 

html<div data-scene="strategy" class="scene scene--strategy">
    <div id="strategy-board">대시보드 로드...</div>
</div>
<div data-scene="finance" class="scene scene--finance">
    <div id="finance-board">회계/예산 로드...</div>
</div>
<!-- ... 6방 ... -->

관련 파일: /Users/ef/crowny-padella/public/js/game-shell.js 기반 → /Users/ef/crowny-enterprise/web/enterprise-world.js (신규 작성 예정)

C-2: 미션 카드 (Mission Card)

패턴: 기존 업무 = 미션으로 재포장.

hanseon; modules/미션.한선 (신규)
변수 _미션DB = 테이블생성("미션", [
    "ID", "제목", "설명", "카테고리", "상태", "보상XP", "난이도",
    "담당자", "기한", "생성일", "완료일", "우선순위"
])

함수 미션생성(제목, 설명, 카테고리, XP, 난이도, 기한) {
    ; 카테고리: "거래처" "재무" "인사" "생산" "영업" "운영"
    ; 상태: "대기"(U) → "진행"(O) → "완료"(T) 또는 "실패"(A)
    변수 행 = 맵생성()
    행 = 맵넣어(행, "제목", 제목)
    행 = 맵넣어(행, "상태", "U")      ; 대기
    행 = 맵넣어(행, "보상XP", XP)
    _미션DB = 삽입(_미션DB, 행)
}

함수 미션완료(미션ID, 사용자ID) {
    ; 미션 상태 T로 전환 → 사용자 XP 가산
    변수 미션 = 조회(_미션DB, "ID", "==", 미션ID)
    미션["상태"] = "T"
    XP가산(사용자ID, 미션["보상XP"])
    레벨체크(사용자ID)   ; 8단계 레벨업
    업적확인(사용자ID)   ; 업적 활성화
}

4상 미션 상태:

  • T (완료): ✅ 성공 → XP 획득 + 다음 미션 언락
  • O (진행): 🔄 작업 중 — 진행률 표시
  • A (실패): ❌ 미션 실패 → 재도전 가능
  • U (대기): ⏸ 아직 시작 안 함 — 선행 미션 대기
UI (게임셸에 탑재): 
html<div class="mission-card" data-mission="M001">
    <div class="mission-header">
        <span class="mission-icon">⚙️</span>
        <h3>월간 예산 검토</h3>
    </div>
    <div class="mission-body">
        <p>재무실에서 이번 달 예산을 검토하고 편차를 분석하세요.</p>
        <div class="progress-bar">
            <div class="progress-fill" style="width: 60%"></div>
        </div>
        <span class="progress-text">60% 진행</span>
    </div>
    <div class="mission-footer">
        <span class="xp-reward">+50 XP</span>
        <button class="mission-btn">진행하기</button>
    </div>
</div>

관련 파일: /Users/ef/crowny-enterprise/modules/미션.한선 (신규 작성 예정)

C-3: 게임화 데이터 모델 (missions.dat)

hanseon; missions.dat 구조 (JSON, 영속)
{
  "missions": [
    {
      "id": "M001",
      "title": "월간 예산 검토",
      "category": "finance",
      "state": "O",        // T/O/A/U
      "xp_reward": 50,
      "difficulty": 2,     // 1~5 (보스급 5)
      "assignee": "user123",
      "deadline": "2026-06-30",
      "created_at": "2026-06-15T10:00:00Z",
      "completed_at": null
    },
    ...
  ]
}

서버 미션 API 7종 (신규):

경로메서드설명
/api/missionsGET전체 미션 목록 (필터: 상태, 카테고리)
/api/missions/:idGET미션 상세
/api/missionsPOST미션 생성 (관리자)
/api/missions/:id/startPOST미션 시작 (상태 U→O)
/api/missions/:id/completePOST미션 완료 (O→T, XP 가산)
/api/missions/:id/failPOST미션 실패 (O→A)
/api/missions/user/:uidGET사용자 미션 목록
관련 파일: /Users/ef/crowny-enterprise/modules/미션.한선, 서버.한선 (API 통합)

C-4: 기존 자산 조립

데일리콘솔 (XP/레벨/스트릭)

경로: /Users/ef/crowny-enterprise/데일리콘솔.한선
  • XP 계산 (액션수×15 + 스트릭 보너스)
  • 레벨 8단계 (관찰자→마스터)
  • 스트릭 (연속 로그인)
  • 업적 8개
통합: 미션 완료 시 XP 자동 가산 → 레벨업 체크

워크플로우 (미션 상태기계)

경로: /Users/ef/crowny-enterprise/modules/워크플로우.한선
  • 기존: 순차/병렬/조건분기 승인 → 미션 보류 메커니즘으로 재활용
  • 예: "구매 발주 승인" = "미션: 구매 결재"

셀코어 규칙 (자동판정)

경로: /Users/ef/crowny-enterprise/셀코어_엔터프라이즈.한선
  • R1: KPI미달성 → 전략실 미션 자동 생성
  • R2: 고위험프로젝트 → 운영실 미션 자동 생성
  • R3: 프로젝트완료 → 미션 T 자동 전환

C-5: ERP 미션 안내자 (NPC)

아이디어: 각 6방마다 NPC 1명 상주 (Padella NPC 패턴 재활용).

javascript// data/npc-erp.json (신규)
{
  "npcs": [
    {
      "id": "npc-strategy",
      "name": "전략 안내자",
      "avatar": "🎯",
      "room": "strategy",
      "greeting": "안녕하세요! 오늘의 전략 미션을 확인하세요.",
      "missions": ["M001", "M002", "M003"]
    },
    {
      "id": "npc-finance",
      "name": "재정 분석가",
      "avatar": "💰",
      "room": "finance",
      "greeting": "재무 현황을 점검할 시간입니다.",
      "missions": ["M010", "M011"]
    },
    ...
  ]
}

D. 6대관리 분석 (라운드1 데이터 구조)

현황: 모듈 존재 O · 데이터 거의 0 → 데이터 시드 필수

관리 영역한선씨 모듈현황다음 작업
제조관리modules/생산.한선BOM/MRP/작업지시 기본 완성데이터 시드 (제품 10종)
공급망modules/공급망.한선구매/입출고/재고 기본 완성데이터 시드 (거래처 5개)
인사자원modules/인사.한선인사/근태/급여 깊게데이터 시드 (직원 20명)
재정관리modules/재무.한선 + libs/회계.한선복식부기/예산 깊게데이터 시드 (계정과목 50개)
계약관리❌ 독립 갭영업 모듈에 종속신규: modules/계약.한선
홍보관리❌ 분리 갭영업 모듈에 종속신규: modules/홍보.한선
유지보수modules/자산.한선 + 이슈 분리 필요자산+이슈 혼재신규: modules/유지보수.한선

D-1: 신규 모듈 3종 설계

계약관리 (modules/계약.한선)

hanseon; 계약 엔티티
변수 _계약DB = 테이블생성("계약", [
    "ID", "계약번호", "상대방", "품목", "수량", "금액",
    "시작일", "종료일", "상태", "담당자", "갱신주기", "알림"
])

; 상태: "체결"/"진행"/"종료"/"갱신"/"만료경고"

홍보관리 (modules/홍보.한선)

hanseon; 캠페인 독립화
변수 _홍보DB = 테이블생성("홍보", [
    "ID", "캠페인명", "채널", "타겟", "예산", "노출수", "클릭수",
    "시작일", "종료일", "상태", "담당자"
])

유지보수 (modules/유지보수.한선)

hanseon; 자산 유지보수 + 설비 이슈 통합
변수 _유지보수DB = 테이블생성("유지보수", [
    "ID", "자산ID", "설비명", "유형", "예정일", "담당자",
    "상태", "소요시간", "비용", "우선순위"
])

; 자동규칙: 설비 이상 감지 → 유지보수 티켓 자동 생성

D-2: 데이터 시드 전략

10개사 샘플 데이터 (시뮬레이션용, 프로덕션 아님): 

bash$ node /tmp/gen-enterprise-seed.js

# 산출
data/seed/
  ├── companies-10.json          (10개 회사)
  ├── divisions.json             (본부 30개)
  ├── departments.json           (부서 100개)
  ├── employees.json             (직원 500명)
  ├── products.json              (제품 100종)
  ├── suppliers.json             (거래처 50개)
  ├── accounts.json              (계정과목 60개)
  ├── contracts.json             (계약 50건)
  ├── campaigns.json             (캠페인 20개)
  └── maintenance-schedule.json  (유지보수 100건)

E. 다음 라운드 (라운드2, 예정)

우선순위

  1. 데이터 시드 (10개사) — 1-2주
  2. 계약/홍보/유지보수 모듈 — 1주
  3. 게임화 ERP UI (enterprise-world.js 6방) — 2주
  4. 서버.한선 미션 API 통합 — 1주
  5. 라이브 테스트 (실제 데이터 입력) — 1주

로드맵

라운드1 (완료: 06-15)
  ├─ A. 인프라 수정 (dat/알림/SSE/SLA) ✅
  ├─ C. 게임화 설계 (아키텍처) ✅
  └─ D. 6대관리 분석 (갭 식별) ✅

라운드2 (예정: 06-22~07-15)
  ├─ 데이터 시드 생성
  ├─ 신규 모듈 3종 구현
  ├─ 게임화 UI (enterprise-world.js) 구현
  ├─ 미션 API 통합
  └─ E2E 검증

라운드3 (예정: 07-20~08-31)
  ├─ 운영 자동화 (조직, 원가센터)
  ├─ 보고서/분석 고도화
  ├─ 게임화 확장 (보스 미션, 길드 등)
  └─ 다국어 지원 (영/중/일)

F. 잔여 이슈

F-1: SSE 단일 스레드 한계

  • 문제: 동시 다중 사용자 SSE 연결 시 한선씨 VM 단일 스레드 → 느린 폴링 재연결
  • 임시: 폴링 5초 (SSE 우선, 실패 시 폴백)
  • 장기: 분산 메시지 큐 (Redis/RabbitMQ) 또는 Crowny gRPC 프로토콜 (향후)

F-2: SLA 타이머 60초 근사

  • 한계: VM 메인루프 주기 불규칙 → 정확 1분 아님
  • 정확도: ±5초 편차 (업무용 충분)
  • 개선: 백그라운드 태스크 스케줄러 (cron 스타일) — 향후 고려

F-3: 신규 모듈 격리 강화

  • 지금: 모듈별 .한선 파일 + 서버.한선 임포트
  • 필요: 모듈 간 순환 의존성 방지 + API 계층 명확화
  • 방법: 모듈 진입점(모듈명_초기화(), 모듈명_API()) 강제 규칙 적용

G. 관련 파일 경로

파일역할
/Users/ef/crowny-enterprise/서버.한선메인 ERP 서버 (165KB)
/Users/ef/crowny-enterprise/libs/알림.한선이벤트/알림 (flat-array 수정됨)
/Users/ef/crowny-enterprise/modules/워크플로우.한선승인 워크플로우
/Users/ef/crowny-enterprise/데일리콘솔.한선XP/레벨/스트릭
/Users/ef/crowny-enterprise/셀코어_엔터프라이즈.한선5규칙 엔진
/Users/ef/crowny-padella/public/js/game-shell.js게임셸 (재활용)
/Users/ef/crowny-padella/CLAUDE.mdPadella 아키텍처 참조

검증 요약

항목상태날짜
A-1: dat 영속✅ PASS2026-06-15 10:30
A-2: 알림 버그✅ PASS2026-06-15 10:45
A-3: SSE 실시간✅ PASS2026-06-15 11:00
A-4: SLA 타이머✅ PASS2026-06-15 11:15
전역 회귀✅ GREEN2026-06-15 11:30

문서 작성: 2026-06-15 라운드1 완료 예상: 2026-06-15 12:00 UTC 라운드2 시작 예정: 2026-06-22

← 이전크라우니 SLM dense-input 인코더 — 형태소 공유 + 실험 블록(VM 행)2026-06-15-crowny-slm-dense입력다음 →크라우니엔터프라이즈 P1-2: 감사로그 SHA-256 해시체인 + 파일 영속화2026-06-15-enterprise-audit-hashchain

관련 문서

크라우니엔터프라이즈 POST API 복구2026-04-15 에이멘에이 맞춤 시연 — Thinking Digital Twin2026-04-16 보령제약 맞춤 시연 — Thinking Digital Twin2026-04-16 크라우니 엔터프라이즈 — 법인보험대리점(GA) 3사 맞춤 시연 추가2026-04-16 크라우니 엔터프라이즈 — 전체 인덱스 (Thinking Digital Twin)2026-04-16
1 / 1