Lurus는 하이브리드 클라우드 아키텍처를 채택하여 Kubernetes + GitOps 기반의 통합 서비스 배포 및 거버넌스 체계를 구축합니다. 12개 제품이 동일한 계정, 과금, 기억, LLM 게이트웨이, 가관측성 기반을 공유합니다. 독립 서비스를 단순히 짜맞춘 것이 아니라, 한 번에 명확하게 설명할 수 있는 하나의 그림입니다.
아키텍처 전경
계층 뷰 C 측 제품부터 운영 기반까지, 위에서 아래로 다섯 계층입니다. 하위 계층은 상위 계층에 능력을 제공하고, 상위 계층은 하위 계층의 구현을 인지하지 않습니다.
graph TB
subgraph C[C 측 제품 계층]
Lucrum[Lucrum 퀀트]
Switch[Switch 데스크톱]
Creator[Creator 콘텐츠]
Lutu[Lutu 모바일]
end
subgraph B[B 측 제품 계층]
API[Lurus API LLM 게이트웨이]
Forge[Forge 워크벤치]
Lumen[Lumen 개발자 도구]
end
subgraph E[핵심 엔진 계층]
Kova[Kova 지속 실행 Rust]
MemX[MemX 지능형 기억 Python]
end
subgraph I[인프라 계층]
Platform[Platform 계정 과금]
Auth[Auth OIDC]
Notify[Notification 멀티 채널 알림]
end
subgraph O[운영 계층]
Ops[K8s Traefik ArgoCD Prometheus Grafana Jaeger Loki]
end
C --> B
B --> E
E --> I
I --> O텍스트 버전 분층도 (접근성 / 복사용)
┌─────────────────────────────────────────────────────────────────┐
│ C 端产品层 │
│ Lucrum (量化) · Switch (桌面) · Creator (内容) · Lutu (移动) │
├─────────────────────────────────────────────────────────────────┤
│ B 端产品层 │
│ Lurus API (LLM 网关) · Forge (工作台) · Lumen (开发者工具) │
├─────────────────────────────────────────────────────────────────┤
│ 核心引擎层 │
│ Kova (持久执行, Rust) · MemX (智能记忆, Python) │
├─────────────────────────────────────────────────────────────────┤
│ 基础设施层 │
│ Platform (账号/计费) · Auth (OIDC) · Notification (多渠道通知) │
├─────────────────────────────────────────────────────────────────┤
│ 运维层 │
│ K8s · Traefik · ArgoCD · Prometheus · Grafana · Jaeger · Loki │
└─────────────────────────────────────────────────────────────────┘설계 원칙
다섯 가지 원칙 진입 통합, 모델 통합, 배포 자동화, 가관측성 일체화, 장애 자가 복구.
핵심 설계
통합 게이트웨이
Traefik 진입, TLS 종료, 와일드카드 인증서 자동 관리
멀티 모델 AI 게이트웨이
50+ LLM 채널 통합 연결(OpenAI / Claude / Gemini / Deepseek / Qwen / Moonshot 등), per-channel 서킷 브레이커 보호
GitOps 배포
GitHub Actions → GHCR 컨테이너 이미지 → ArgoCD 자동 동기화
풀스택 가관측성
Prometheus 지표 + Grafana 대시보드 + Loki 로그 + Jaeger 분산 추적
고가용성 설계
채널 장애 자동 전환, 우선순위 + 가중치 라우팅, PodDisruptionBudget 보호
요청 처리 흐름
데이터 흐름 한 번의 LLM 요청이 진입에서 업스트림까지, 인증·레이트 리밋·서킷 브레이커·과금·로그 다섯 관문을 거칩니다.
graph LR
Client[Client] --> Traefik[Traefik TLS]
Traefik --> GW[API Gateway]
GW --> Route[지능형 라우팅]
Route --> Up[업스트림 AI 50+ 제공자]
Up --> Resp[응답]
GW -.-> Mid[인증 / 레이트 리밋 / 서킷 브레이커 / 과금 / 로그]API Gateway는 모델 이름에 따라 사용 가능한 채널을 자동으로 매칭하며, 우선순위 정렬과 가중치 랜덤 분배를 지원합니다. 고우선순위 채널에 장애가 발생하면 per-channel 서킷 브레이커가 장애 채널을 자동 격리하고, 트래픽이 대체 채널로 전환됩니다.
기술 스택 개요
기술 선택 다중 언어 하이브리드 스택, 업무에 따라 가장 적합한 런타임을 매칭합니다.
| 계층 | 기술 선택 |
|---|---|
| 백엔드 서비스 | Go (Gin), Rust, Python (FastAPI) |
| 프론트엔드 | React / Next.js / Vue 3 / Flutter |
| 데스크톱 앱 | Wails (Go + Web), 단일 exe 무의존성 |
| 데이터베이스 | PostgreSQL (CNPG), 서비스별 schema 격리 |
| 캐시 | Redis, 서비스별 DB 격리 |
| 메시지 | NATS JetStream (이벤트 브로드캐스트) |
| 워크플로 | Temporal (구독 갱신/예약 작업) |
| 신원 인증 | Casdoor (OIDC) |
| 컨테이너 | scratch/alpine 최소 이미지, 멀티 스테이지 빌드 |
| 보안 | Kyverno 정책 엔진 + NetworkPolicy + Trivy 컨테이너 스캔 |
하이브리드 클라우드 배포
배포 형태 이중 공인망 진입 + 혼합 배치 오케스트레이션. 국내 접근성과 운영 비용을 모두 고려합니다.
SanFengYun + Alibaba Cloud 이중 공인망 진입, K3s + Docker-Compose 혼합 배치, 업무별 인프라 격리.
GitHub Actions → GHCR → ArgoCD 전체 흐름 자동화, 이미지 tag는 main-<sha7>로 고정.
Grafana + Prometheus + Jaeger + Loki 통합 패널, 지표 / 로그 / 트레이스 일체.
보안 설계
심층 방어 전송부터 컨테이너 런타임까지, 7계층 심층 방어.
| 계층 | 조치 |
|---|---|
| 전송 | 전체 HTTPS (TLS 1.3), 와일드카드 인증서 자동 갱신 |
| 네트워크 | VPN 네트워킹, NetworkPolicy 네임스페이스 격리 |
| 인증 | 통합 신원 인증: OIDC JWT + API Key 이중 모드, WebAuthn Passkey, 기업 SSO 페더레이션 |
| 인가 | RBAC 역할 권한 제어, 멀티 테넌트 GORM 자동 격리 |
| 암호화 | ChaCha20-Poly1305 + 국산 암호 SM4-GCM(신창 컴플라이언스) |
| 감사 | 구조화 JSON 로그 + OpenTelemetry 분산 추적 |
| 컨테이너 | readOnlyRootFilesystem, drop ALL capabilities, runAsUser:65534 |
데이터 주권
국산 암호 SM4-GCM 전 구간 암호화, 온프레미스 배포, 데이터가 기업 경계를 벗어나지 않습니다. 하나의 SSO / Passkey / MFA로 기업의 기존 IdP에 연결할 수 있고, OpenAI SDK와 호환되며, 내보내기 시 종속 이탈 비용이 없습니다.
상세 아키텍처 문서
단일 진실 공급원
상세 아키텍처 다이어그램은 governance repo에 있습니다: lurus.yaml + doc/architecture.md. 본 사이트는 이중 진실 공급원 유지를 피하기 위해 전체 다이어그램을 더 이상 내장하지 않습니다.