What is Umbra¶

Umbra 는 Discord 커뮤니티를 보호하고 복구하는 구독형 SaaS 봇입니다. 길드 관리자는 사고가 발생하기 전에는 능동적 보호를, 사고가 발생한 후에는 완전한 복구를 받습니다.

What is this¶

Umbra 는 Discord 서버(이하 "길드")의 구조와 데이터를 지속적으로 백업하고, 필요한 시점에 그 상태로 되돌리는 서비스입니다. 멤버 목록, 역할, 채널, 권한 오버라이드, 길드 설정 같은 운영 데이터를 실시간으로 미러링하며, 관리자가 지정한 시점의 스냅샷으로 길드를 복구할 수 있습니다.

추가로 Umbra 는 비정상적인 대량 삭제나 권한 이상 변경을 감지하여 사고 직전 상태를 자동 스냅샷으로 보존하고, owner 에게 긴급 알림을 보냅니다. 이것이 Umbra 의 이름이 의미하는 바입니다 — 그림자처럼 항상 옆에 있는 보호자.

결제는 Toss Payments 빌링키 기반 구독이며, 한 사용자가 여러 길드의 구독을 관리할 수 있습니다.

Why it exists¶

Discord 커뮤니티는 규모가 커질수록 운영 리스크도 커집니다. 관리자 계정 탈취, 내부자의 악의적 행동, 봇 오작동, 실수로 인한 대량 삭제는 실제로 빈번히 발생합니다. Discord 는 사용자 개인 데이터에 대한 복구 도구를 제공하지만, 길드 운영자 입장에서 필요한 "길드 전체 상태의 복구" 는 공식적으로 지원하지 않습니다.

기존 Discord 봇 시장에는 모더레이션, 자동화, 미니게임 중심의 제품이 많지만, 길드 상태 자체를 보험 들어주는 제품은 드뭅니다. 몇몇 백업 봇이 존재하지만 대부분 단순 JSON 덤프 수준이며, 실시간 미러링과 선택적 복구, 능동적 이상 감지를 통합한 제품은 사실상 없습니다. Umbra 는 이 공백을 채우기 위해 존재합니다.

Umbra 의 핵심 가치는 신뢰성 입니다. 백업이 있어야 할 순간은 대부분 예상하지 못한 순간이며, 그 순간에 제대로 동작하지 않는 백업은 없는 것과 같습니다. 따라서 Umbra 는 복구 플로우 자체를 Temporal 워크플로우로 구현하여 프로세스 장애에도 이어서 진행되도록 하며, 스냅샷은 트랜잭션 경계 안에서 생성되어 부분 저장을 허용하지 않습니다.

Key concepts¶

Umbra 를 이해하기 위해 알아야 할 핵심 개념들입니다. 전체 용어 사전은 overview/glossary.md 를 참조하세요.

Guild — Discord 에서 "서버" 라고 부르는 단위. Umbra 의 구독 적용 대상이자 복구 대상의 기본 단위입니다.
License — 특정 길드에 부여된 권한. Plan(Free/Pro/Enterprise) 에 따라 접근 가능한 기능이 결정됩니다.
Subscription — 특정 사용자가 특정 길드를 대상으로 진행 중인 결제 관계. License 와 분리된 엔티티로, 서로 다른 lifecycle 을 가집니다.
Snapshot — 특정 시점의 길드 상태 전체를 저장한 기록. 복구의 기준점입니다.
Restore — 스냅샷을 기준으로 길드 상태를 되돌리는 작업. Temporal 워크플로우로 실행됩니다.
Live Sync — Discord 에서 발생하는 상태 변경 이벤트를 우리 DB 에 실시간 반영하는 메커니즘.
Anti-Nuke — 대량 삭제, 권한 이상 변경 같은 비정상 이벤트를 감지하여 자동으로 대응하는 능동적 보호 시스템.
Hybrid model — 결제 주체는 User, 권한 적용 대상은 Guild 인 분리 구조. 한 User 가 여러 길드의 구독을 독립적으로 관리할 수 있습니다.

Scope¶

In scope

Discord 길드의 구조 데이터(멤버, 역할, 채널, 권한, 설정) 실시간 미러링
수동 및 자동 스냅샷 생성과 보관
Full / Partial Restore 를 포함한 복구 실행
Anti-Nuke 이상 감지와 자동 대응
Toss Payments 기반 구독 결제
웹 대시보드(app.umbra.ink) 및 웹 조인(join.umbra.ink)

Out of scope

메시지 본문(채팅 내용) 백업 — 프라이버시와 법적 부담으로 1차 제외. adr/0027-message-content-exclusion.md 참조
Sticker 백업 — 복구 가치 대비 용량 부담이 커서 제외
모더레이션, 자동 역할, 미니게임 등 일반 봇 기능 — Umbra 의 차별화 영역이 아님
Discord 이외 플랫폼 — 현재는 Discord 전용

Who this is for¶

Umbra 의 타겟 사용자는 다음과 같습니다.

멤버 수가 수백 명 이상인 중대형 길드의 owner 및 관리자
여러 커뮤니티를 동시에 운영하는 길드 관리자(Hybrid 모델의 직접 수혜자)
사고 발생 시 비즈니스 또는 수익 손실이 발생하는 상업적 커뮤니티(크리에이터 팬덤, 유료 강의 커뮤니티, 온라인 게임 길드)
운영 자동화보다 운영 안정성을 우선시하는 팀

overview/value-proposition.md — Umbra 의 핵심 가치 제안
overview/glossary.md — 전체 용어 사전
architecture/overview.md — 시스템 전체 아키텍처
domain/recovery/overview.md — Recovery 도메인 상세
roadmap/mvp-scope.md — MVP 범위와 이후 계획