Getting Started

SaaS 온보딩, 데모 환경, Console·API 첫 연결

1. 데모 환경

로컬 또는 배포된 데모에서 운영 루프를 체험할 수 있습니다. Console에 로그인한 뒤 Vision 탐지 → Agent 추천 → Approve & Execute → Incident → Replay 순서를 따라가 보세요.

2. SaaS 테넌트 온보딩

  1. 테넌트 생성 및 플랜(pilot / standard / enterprise) 할당
  2. Module entitlements 활성화 — 구매한 모듈만 API·Console에서 사용 가능
  3. Integrations에서 API 키 발급 또는 JWT 사용자 초대
  4. 웹훅·커넥터(Slack, Splunk, ServiceNow 등) 연결

3. 첫 API 호출 (Public API v1)

API Gateway의 /v1 경로가 외부 계약입니다. 마이크로서비스 URL은 노출하지 않습니다.

탐지 ingest (vision:ingest)
curl -X POST "https://api-gateway-production-20f8.up.railway.app/v1/vision/detections" \
  -H "X-Aimon-Api-Key: aimon_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "siteId": "site_demo",
    "cameraId": "cam_01",
    "label": "person",
    "confidence": 0.92,
    "occurredAt": "2026-05-27T10:00:00Z"
  }'

4. 모듈 vs 커넥터

모듈(entitlement)은 테넌트가 구매한 제품 기능입니다. 커넥터는 integrations 모듈이 있을 때 선택적으로 연결하는 외부 시스템 어댑터입니다.

예: cctv_vision만 활성화해도 Vision ingest는 가능하지만, Slack 알림은 integrations 모듈과 커넥터 설정이 필요합니다.

5. 다음 단계