03-ssot

03-ssot — 20-operation

Status: ACTIVE AppliesTo: v10 ParentSSOT: skills/devian/80-tools/03-ssot/SKILL.md

Scope

Operation 웹앱의 기능(탭) 정의를 관리한다. 각 탭의 입출력, 파이프라인, 참조 SSOT를 이 문서에서 정의한다.

---

A) Obfuscate

ComplexUtil byte-substitution. 평문 -> 난독화.

항목	값
입력	평문 바이트
출력	난독화된 바이트
버튼	[Obfuscate]

ComplexUtil 정본: 31-variable-complex

---

B) Deobfuscate

ComplexUtil byte-substitution. 난독화 -> 평문.

항목	값
입력	난독화된 바이트
출력	평문 바이트
버튼	[Deobfuscate]

ComplexUtil 정본: 31-variable-complex

---

C) Save Data

Save Data 편집 워크플로우. 파일 확장자(.json / .dvn)에 따라 자동 분기.

입력 형식

확장자	출처	외부 래핑
.json	Unity Editor 로컬 저장	없음 (SaveLocalPayload JSON 그대로)
.dvn	모바일 Export	DVN 인코딩 (version byte + ComplexUtil + HMAC)

두 형식 모두 내부 payload 필드는 ComplexUtil.Encrypt_Base64(게임 상태 JSON). .dvn v2는 HMAC 무결성 검증을 포함한다 (§DVN 파이프라인 참조).

양방향 프로세스

[SaveDataManager]                    [Operation]
  ExportDvnAsync  ── .dvn ──→  Import (decode)
  로컬 저장        ── .json ──→  Import (parse)
                                   ↓ JSON 편집
  ImportDvnAsync  ←── .dvn ──  Export (encode)
  RestoreFromPlainJsonAsync ←── .json ──  Export (serialize)

DVN 파이프라인

v2 (현재, HMAC 포함):

Export (.dvn):
  1. JSON에서 account.socialUserId 추출
  2. HMAC-SHA256(JSON, APP_SECRET + socialUserId) -> hmac_hex
  3. signedPayload = JSON + "\n" + hmac_hex
  4. ComplexUtil.Encrypt_Base64(signedPayload) -> obfuscated
  5. (char)0x02 + obfuscated -> .dvn

Import (.dvn):
  1. version parse (0x02)
  2. ComplexUtil.Decrypt_Base64 -> signedPayload
  3. signedPayload 분리 -> JSON + hmac_hex
  4. HMAC 검증 (APP_SECRET + socialUserId)
  5. Return JSON

v1 (레거시, HMAC 없음):

Import (.dvn): .dvn -> version parse (0x01) -> ComplexUtil.Decrypt_Base64 -> JSON

• Export는 항상 v2로 생성한다.
• Import는 v1/v2 모두 허용한다 (v1은 HMAC 검증 없이 통과).
• Operation 웹앱은 APP_SECRET을 코드 내 상수로 보유한다 (dvn-codec.ts).

정본: 25-recovery-system/03-ssot

• DVN 포맷: §A
• 인코딩 파이프라인: §B
• HMAC Integrity: §E

---

D) Push Send

FCM 토픽 기반 푸시 알림 발송. PUSH_REMOTE 테이블 데이터를 로드하여 토픽별/언어별로 발송한다.

항목	값
데이터 소스	PUSH_REMOTE.json (NDJSON, 파일 로드)
입력	Topic (드롭다운), Body × 3언어 (Korean / English / Japanese)
출력	FCM 발송 결과 (성공/실패)
버튼	[Load Data], [Send]
백엔드	Firebase Cloud Function sendPushNotification (Callable v2)

발송 흐름

1. [Load Data] → PUSH_REMOTE.json 파일 선택 → NDJSON 파싱
2. Topic 드롭다운에 고유 Topic 목록 표시 (예: event, test)
3. 사용자가 Topic 선택 + 언어별 Body 작성
4. [Send] → 선택 Topic에 해당하는 PUSH_REMOTE 행 필터링
5. 각 행의 PushId를 FCM 토픽으로, 해당 Language의 Body를 매칭하여 발송
   예: Topic="event" 선택 시
     → event_korean (PushId) + Korean body
     → event_english (PushId) + English body
6. Body가 비어있거나 매칭 행이 없는 언어는 skip

Firebase Function: sendPushNotification

• Callable v2 (onCall), region: asia-northeast3
• 입력: { entries: [{ pushId: string, body: string }] }
• 동작: 각 entry에 대해 admin.messaging().send({ topic: pushId, notification: { body } })
• 응답: { results: [{ pushId: string, success: boolean, error?: string }] }

PUSH_REMOTE 테이블 정본: 52-push-system/03-ssot §D, §F

---

Related

• 00-overview — Operation 개요
• 01-policy — 정책
• Tools SSOT — 상위 SSOT
• 52-push-system/03-ssot — Push 시스템 SSOT