본문으로 건너뛰기

ONESHIM 시스템 아키텍처 개요

3-Tier 시스템 구조​

ONESHIM은 3계층 아키텍처로 구성되어 있으며, 각 계층은 독립적으로 확장 가능합니다.

각 계층의 역할​

Tier 1: Client Layer (Desktop Agent)​

Rust 네이티브 데스크톱 에이전트로, 사용자의 작업 환경을 실시간으로 모니터링하고 컨텍스트를 수집합니다.

  • 실시간 컨텍스트 수집: 활성 창, 시스템 메트릭, 사용자 활동 추적
  • Edge 이미지 처리: 스크린샷 캡처, 변경 감지, OCR
  • 로컬 분석: 집중도 분석, 작업 세션 추적
  • 크로스 플랫폼: macOS, Windows, Linux 지원

Tier 2: Server Layer (AI Server)​

DDD(Domain-Driven Design) 기반의 AI 서버로, 14개 도메인에 걸쳐 비즈니스 로직을 처리합니다.

  • API Gateway: REST, gRPC, WebSocket을 통한 멀티 프로토콜 통신
  • 비즈니스 로직: CQRS 패턴 기반의 명령/조회 분리
  • AI 엔진: LLM 기반 컨텍스트 분석 및 지능형 제안 생성
  • 비동기 처리: 대용량 작업의 큐 기반 병렬 처리

Tier 3: Data Layer​

그래프 데이터베이스를 단일 소스 오브 트루스(Single Source of Truth)로 사용합니다.

  • Graph DB: 지식 그래프, 엔티티 관계, 벡터 임베딩 저장
  • Cache: 세션 캐시 및 메시지 브로커

데이터 플로우​

사용자 작업 수행부터 AI 제안 수신까지의 전체 데이터 흐름입니다.

확장성 아키텍처​

ONESHIM은 수평 확장이 가능한 구조로 설계되어, 동시 접속 에이전트 수에 따라 유연하게 확장됩니다.

기술 스택 요약​

레이어역할
ClientRust 네이티브 데스크탑 에이전트 (크로스 플랫폼, gRPC 지원)
API멀티 프로토콜 통신 레이어 (REST, gRPC, WebSocket)
BusinessDDD + CQRS 기반 비즈니스 로직 (14개 도메인)
AILLM 기반 지능형 분석 및 프롬프트 최적화
Background큐 기반 비동기 처리 엔진
Database그래프 DB (단일 소스 오브 트루스)
Cache캐시 + 메시지 브로커

관련 문서: