완전 가이드

나만의 버티컬
애플리케이션 구축

18개 코어 스택 서비스를 사용하여 헬스케어, 법률, 부동산 또는 모든 버티컬 AI 애플리케이션을 구축하는 단계별 가이드. 제로에서 프로덕션까지.

18
코어 서비스
7
단계
2-4주
타임라인
1

설정 및 아키텍처

2-3일 · 기반 설정 및 버티컬 계획

Nexus CLI가 처음이신가요?

이 가이드는 Nexus CLI를 광범위하게 사용합니다. 아직 설치하지 않았거나 60개 이상의 사용 가능한 명령, 템플릿, 고급 기능에 대해 자세히 알고 싶으시면 전체 CLI 문서를 확인하세요.

CLI 문서 보기

1.1. Nexus-Forge 설치

모든 개발 도구, Docker Compose 설정, Claude Desktop 통합을 제공하는 Nexus-Forge CLI를 설치합니다.

npm install -g @adverant/nexus-forge
forge --version  # Verify installation
사전 요구사항: Node.js 18+, Docker Desktop 실행 중, 8GB+ RAM 필요

1.2. 버티컬 프로젝트 생성

버티컬 템플릿을 선택하거나 빈 프로젝트로 시작하세요. 템플릿에는 특정 산업을 위한 데이터 모델, API 라우트, 예제 쿼리가 포함됩니다.

# Interactive setup
forge create my-vertical

# Or specify a template
forge create healthcare-crm --template healthcare
forge create legal-research --template legal
forge create property-mgmt --template property

# Or start completely blank
forge create custom-vertical --template blank
🏥
Healthcare 템플릿
환자, 예약, EHR, HIPAA 준수
⚖️
Legal 템플릿
사건, 문서, 고객, 사건 관리
🏠
Property 템플릿
매물, 세입자, 임대, 유지보수
빈 템플릿
코어 스택만으로 처음부터 시작

1.3. 사용 가능한 코어 서비스 이해

18개 코어 서비스 모두 자동으로 사용 가능합니다. 각 서비스가 버티컬에 제공하는 기능:

brain ai
GraphRAG 메모리
환자 기록, 사건 파일, 부동산 데이터 저장
target
MageAgent LLM 게이트웨이
채팅 인터페이스, 문서 분석, 요약
robot arm
멀티 에이전트 오케스트레이션
복잡한 워크플로, 다단계 조사
video camera
비디오 인텔리전스
의료 영상, 부동산 투어, 증언
document file
문서 처리
PDF, 스캔, 계약서, 양식
map fold
지오스페이셜 서비스
부동산 위치, 서비스 구역, 라우팅
shield lock
Auth 및 RBAC
멀티 테넌트 워크스페이스, 사용자 권한
lightning bolt
API Gateway
속도 제한, 로드 밸런싱, 라우팅
2

데이터 모델 및 인증

3-4일 · 데이터 구조 및 접근 제어 정의

2.1. GraphRAG 스키마 설계

버티컬의 엔티티 타입, 관계, 벡터 임베딩을 정의합니다. GraphRAG는 PostgreSQL(구조화) 및 Neo4j(그래프) 스토리지를 모두 제공합니다.

// src/schema/entities.ts
export const HealthcareSchema = {
  entities: {
    Patient: {
      properties: ['name', 'dateOfBirth', 'medicalHistory'],
      embeddings: ['medicalHistory', 'symptoms'],
      relationships: ['HAS_APPOINTMENT', 'HAS_DIAGNOSIS']
    },
    Appointment: {
      properties: ['datetime', 'status', 'notes'],
      embeddings: ['notes', 'diagnosis'],
      relationships: ['WITH_PATIENT', 'WITH_DOCTOR']
    }
  }
}

// Forge automatically creates:
// - PostgreSQL tables
// - Neo4j nodes/relationships
// - Qdrant vector collections
// - VoyageAI embedding pipelines

2.2. 멀티 테넌트 인증 구성

워크스페이스, 역할, 권한을 설정합니다. Auth 서비스가 JWT 토큰, SSO 통합, 워크스페이스 격리를 자동으로 처리합니다.

// src/config/auth.ts
export const authConfig = {
  workspaces: {
    enabled: true,
    isolation: 'strict'  // Each workspace = separate data
  },
  roles: {
    admin: ['read', 'write', 'delete', 'manage_users'],
    doctor: ['read', 'write', 'view_patients'],
    nurse: ['read', 'write_limited'],
    patient: ['read_own']
  },
  sso: {
    providers: ['google', 'okta', 'auth0']
  }
}

// Forge generates:
// - Login/signup API routes
// - JWT middleware
// - RBAC enforcement
// - Workspace switching UI
3

AI 통합

4-5일 · LLM 연결 및 지능형 기능 구축

3.1. AI 모델 구성

다양한 작업에 사용할 AI 모델을 선택합니다. MageAgent는 OpenRouter, Anthropic, OpenAI의 320개 이상의 모델에 대한 접근을 제공하며 비용 절감을 위한 지능형 라우팅을 포함합니다.

// src/config/ai.ts
export const aiConfig = {
  chat: {
    model: 'anthropic/claude-opus-4.6',
    fallback: 'openai/gpt-4o'
  },
  analysis: {
    model: 'anthropic/claude-opus-4',
    temperature: 0.1
  },
  summarization: {
    model: 'anthropic/claude-haiku-4', // Faster, cheaper
    maxTokens: 1000
  },
  routing: {
    enabled: true,  // Intelligent cost optimization
    costSavings: '45-60%'
  }
}

3.2. 멀티 에이전트 워크플로 구축

여러 AI 에이전트가 협업하는 워크플로를 생성합니다. 예: 증상 분석, 연구, 권장 사항 에이전트가 포함된 의료 진단 워크플로.

// src/workflows/diagnosis.ts
export const diagnosisWorkflow = {
  name: 'Medical Diagnosis Assistant',
  agents: [
    {
      id: 'symptom-analyzer',
      model: 'claude-opus-4',
      task: 'Analyze patient symptoms and medical history',
      tools: ['graphrag_query', 'vector_search']
    },
    {
      id: 'research-agent',
      model: 'gpt-4o',
      task: 'Research similar cases in medical literature',
      tools: ['web_search', 'document_fetch']
    },
    {
      id: 'recommendation-agent',
      model: 'claude-opus-4-6-20260206',
      task: 'Generate treatment recommendations',
      tools: ['graphrag_query', 'guideline_lookup']
    }
  ],
  orchestration: 'parallel',  // Run simultaneously
  synthesis: true  // Combine results into final output
}

// Frontend shows real-time progress per agent
4

프론트엔드 구축

4-5일 · 사용자 인터페이스 생성

채팅 인터페이스, 데이터 테이블, 양식, 대시보드를 위한 사전 구축 컴포넌트로 React/Next.js 프론트엔드를 구축합니다. TypeScript SDK가 완전한 타입 안전성을 제공합니다.

  • Forge UI 컴포넌트 라이브러리 사용 (50개 이상의 사전 구축 컴포넌트)
  • WebSocket 스트리밍으로 실시간 채팅 구현
  • 무한 스크롤 및 필터가 포함된 데이터 테이블 생성
  • VideoAgent/FileProcessAgent 통합으로 파일 업로드 추가
  • 차트 및 메트릭이 포함된 대시보드 구축
5

고급 기능

3-4일 · 전문 기능 추가

비디오 처리

의료 영상, 부동산 투어, 증언

지오스페이셜 기능

지도, 라우팅, 위치 기반 검색

문서 인텔리전스

OCR, 양식 추출, 계약 분석

알림

이메일, SMS, 푸시 알림, 웹훅

6

테스트 및 QA

2-3일 · 품질 및 성능 보장

유닛 테스트
80%+
Vitest
통합 테스트
크리티컬 경로
Playwright
부하 테스트
1000+ 사용자
k6
7

배포

1-2일 · 프로덕션에 출시

$ forge deploy --environment production

✓ Running pre-deployment checks...
✓ Building Docker images...
✓ Pushing to registry...
✓ Updating Kubernetes...
✓ Running smoke tests...
✓ Health checks passing...

🎉 Deployed to: https://my-vertical.adverant.cloud
📊 Dashboard: https://my-vertical.adverant.cloud/admin
📈 Metrics: https://metrics.adverant.cloud/my-vertical
무중단 배포
1-1000+ 사용자
자동 확장
내장
모니터링

구축할 준비가 되셨나요?

Nexus-Forge를 설치하고 오늘부터 버티컬을 구축하세요. 18개 코어 서비스가 모두 포함됩니다.

2-4주
구축 시간
18
코어 서비스
550+
API 엔드포인트
1M+
앱당 사용자