Skip to content
shcommit edited this page Nov 11, 2026 · 4 revisions

🏮 OnMaru Backend Engineering Wiki

온마루(OnMaru) 백엔드 시스템의 아키텍처 의사결정, 인프라 전환 이력, 보안 방어선 및 실전 트러블슈팅을 기록하는 엔지니어링 위키입니다.

graph LR
    User["사용자 / 브라우저"]
    
    subgraph Edge["1. Edge Layer"]
        CF["Cloudflare WAF<br/>(DDoS 방어, Rate Limit 10초 45회, IP 은닉)"]
    end
    
    subgraph Host["2. AWS Lightsail (Linux 1GB RAM)"]
        Nginx["Nginx (TLS 종료, 80/443)"]
        subgraph AppSlot["초경량 Blue-Green CD"]
            Spring["Spring Boot (JVM 8080)"]
        end
        subgraph DB["Docker 사설 내부 네트워크"]
            PG["PostgreSQL 17 + PostGIS 3.5<br/>(TourAPI / Odii 원본 데이터)"]
        end
    end
    
    User -->|api.onmaru.site| CF
    CF -->|포워딩| Nginx
    Nginx -->|무중단 upstream| Spring
    Spring -->|5432 사설 직결| PG
Loading

📚 Categories & Articles

🛡️ Security (보안 아키텍처)

인프라 및 애플리케이션 레벨에서 서비스 가용성과 사용자 데이터를 지켜내는 방어 체계입니다.

⚙️ Tech (기술 & 인프라)

실제 온마루가 겪었던 인프라 한계와 이를 극복하기 위한 아키텍처 전환 스토리입니다.

🚀 Feature (도메인 기능 구현)

한옥·동네 탐색, AI 기반 여정 추천, 오디오 가이드 등 핵심 비즈니스 로직의 구현과 최적화 기록입니다.

  • 지도 공동 편집: WebSocket부터 C4, 멱등성, 다중 인스턴스 확장까지
    • 배경: Liveblocks 중심 상태를 OnMaru 도메인과 PostgreSQL 이벤트 이력으로 내재화
    • 핵심: 방별 Actor 직렬 처리, opId 멱등성, seq replay, Redis 확장 시 지켜야 할 쓰기 소유권
  • AI 여정 생성 런타임 라이프사이클과 SSE 실시간 스트리밍 (준비 중)
  • ODII 한국관광공사 오디오 도슨트 데이터 동기화 및 캐싱 (준비 중)
  • 방문 리뷰 멱등성(Idempotency) 보장과 소유권 은닉화 (준비 중)

💡 Tip: 우측(또는 좌측)의 Sidebar를 통해 원하는 기술 아티클로 즉시 이동하실 수 있습니다.

🛡️ Security (보안 아키텍처)


⚙️ Tech (기술 & 인프라)


🚀 Feature (도메인 기능 구현)

Clone this wiki locally