Loafacto Hub 문서

Appearance

Loafacto 문서/참고 문서/backend-server 문서/Backend Server Overview

Backend Server 개요 ​

Backend Server는 사용자가 보는 웹 UI에서 발생하는 기능 호출을 실제 서비스 동작으로 연결하는 핵심 계층입니다.

목표 ​

  • 인증/인가를 공통 처리해 요청을 보호합니다.
  • 프로젝트, 문서, 작업(Job), 알림 같은 도메인 API를 제공합니다.
  • AI 에이전트 실행을 위한 오케스트레이션을 담당합니다.
  • 문서 검색(RAG) 인덱싱과 질의 동선을 제공합니다.
  • 배경 작업(색인화, 동기화, 정리)을 안정적으로 처리합니다.

핵심 책임 ​

  1. 요청 게이트웨이
    • 프런트엔드에서 전달되는 API 요청을 유효성 검증 후 내부 서비스로 전달
    • 오류 포맷, 인증 토큰, 응답 형태를 일관되게 관리
  2. 도메인 처리기
    • 프로젝트/문서/유저 설정/운영 엔티티를 조회·수정
  3. AI 실행 계층
    • 프롬프트, 도구 호출, 결과 정합성 등을 관리하는 런타임 계층
  4. RAG/검색 계층
    • 업로드 콘텐츠 파싱, chunking, 임베딩, 벡터 검색 연동
  5. 운영 계층
    • 작업 큐, 재시도 정책, 로깅·메트릭·이벤트 추적을 지원

참고 흐름 ​

mermaid
flowchart LR
  Web[Web UI] --> API[Backend API]
  API --> Auth[Auth/Policy]
  API --> Domain[Domain Service]
  API --> Agent[Agent Engine]
  API --> Search[RAG Search]
  Agent --> Search
  Search --> DB[(Storage & Metadata)]

문서 간 관계 ​

  • 아키텍처: 구성 요소와 데이터 흐름 정리
  • 환경 및 실행 설정: 로컬/배포 실행 기준
  • API 엔드포인트: 라우트 목록과 사용법
  • Agent Engine: 에이전트 동작 구조
  • RAG Ingest: 문서 임베딩/색인 파이프라인
  • Supabase RAG: 벡터 검색 저장소 스키마