아키텍처¶

SeMu-GPT 2026은 세무 법령·예규·판례·상담사례 코퍼스를 Elasticsearch에 색인하고, OpenAI 기반 RAG(Retrieval-Augmented Generation) 파이프라인으로 사용자 질의에 답변하는 모노레포 시스템이다. 프론트엔드(Next.js), 백엔드(Kotlin/Spring Boot), 데이터 파이프라인(Python CLI)의 3개 deployable과 MySQL/Elasticsearch/Redis 인프라로 구성된다.

시스템 구성¶

graph TD
    subgraph Client["클라이언트"]
        BROWSER[웹 브라우저]
    end

    subgraph Edge["엣지 / CDN"]
        CF[Cloudflare
Workers + Tunnel]
        ALB[AWS ALB
prod 전용]
    end

    subgraph App["애플리케이션 계층"]
        FE[Frontend
Next.js 16 / React 19]
        BE[Backend
Kotlin / Spring Boot 3.1]
    end

    subgraph Data["데이터 계층"]
        MYSQL[(MySQL 8.0
거래/사용자 데이터)]
        ES[(Elasticsearch 8.17
법령 코퍼스 + 임베딩)]
        REDIS[(Redis 7
캐시)]
    end

    subgraph Pipeline["데이터 파이프라인 (오프라인)"]
        COL[Collector
Python CLI]
        IDX[Indexer
Python CLI]
    end

    subgraph External["외부 서비스"]
        OPENAI[OpenAI
GPT-5 + Embeddings]
        LF[Langfuse
프롬프트 관리]
        TOSS[Toss Payments]
        SENS[Naver Cloud SENS
SMS]
        SENTRY[Sentry]
    end

    BROWSER --> CF
    BROWSER --> ALB
    CF --> FE
    ALB --> FE
    ALB --> BE
    FE -- HTTP/SSE --> BE
    BE --> MYSQL
    BE --> ES
    BE --> REDIS
    BE -- 프롬프트 fetch --> LF
    BE -- 채팅/임베딩 --> OPENAI
    BE -- 결제 confirm/webhook --> TOSS
    BE -- SMS 발송 --> SENS
    FE -- 에러 리포팅 --> SENTRY

    COL -- JSONL --> IDX
    IDX -- bulk index --> ES
    IDX -- 임베딩 생성 --> OPENAI

컴포넌트 책임¶

통신 패턴¶

외부 의존성¶

백엔드 Sentry는 미설치 상태(CLAUDE.md "Pre-cutover 코드 수정" 참조).

인프라¶

개발 환경 (dev)¶

• Backend: AWS Lightsail (semugpt-backend, ap-northeast-2, $24/mo, Static IP 3.39.17.132)
• systemd semugpt-backend (Spring Boot fat jar, port 8080)
• Docker Compose: mysql + elasticsearch + redis
• Cloudflare Tunnel semugpt-backend → semu-gpt-dev.bootalk.co.kr
• Frontend: Cloudflare Workers (semugpt-frontend-dev)
• @opennextjs/cloudflare 빌드 → KV 자산 + Worker
• GitHub Actions deploy-frontend-dev.yml (push to develop, paths apps/frontend/**)
• URL: semu-chat-dev.bootalk.co.kr

운영 환경 (prod, soft launch)¶

semugpt.co.kr apex/www/api/pro는 레거시 tax-gpt (EC2 + ALB + RDS) 가 그대로 운영 중. 새 버전은 new.semugpt.co.kr (frontend) 와 api-new.semugpt.co.kr (backend) 로 병행 운영 (Issue #151).

• Backend (계획): AWS Lightsail semugpt-prod (large_3_0, 8GB, $44/mo)
• systemd semugpt-backend (port 8080) + systemd semugpt-frontend (port 3000)
• Docker: ES + Redis (MySQL은 RDS 재사용)
• VPC peering: Lightsail VPC ↔ default VPC (ALB 도달용, 활성 ✅)
• ALB (재사용): semu-gpt-alb (HTTPS:443, ACM *.semugpt.co.kr)
• host=api-new → TG-backend-2026 (priority 100)
• host=new → TG-frontend-2026 (priority 110)
• RDS: tax-gpt (MySQL 8.0.44, db.t3.micro, 20GB)
• 신규 database semugpt_2026 (account/phone_auth/membership 부분 마이그레이션 완료 — 2026-05-11)
• DNS: Route 53 semugpt.co.kr. (zone Z0917222THSORQW5ECCW)

상세는 운영 런북 운영 배포 및 프로젝트 루트 CLAUDE.md의 "Production Infrastructure" 섹션 참조.

빌드/배포 흐름¶

관련 문서¶

• 시스템 다이어그램 — 전체 컴포넌트 / 데이터 흐름 / 인프라 토폴로지 다이어그램 모음
• 기능 카탈로그 — 기능별 상세 (회원/멤버십/결제/리포트 등)
• 데이터 파이프라인 — 수집기·인덱서·임베딩 운영 가이드
• 개발 환경 — 로컬 + dev Lightsail 운영
• 운영 배포 — prod 인프라 + cutover 계획
• 복구 절차 — 장애 대응