🌿 ssak (싹)

🔍 더 많은 메뉴 화면 캡처 보기 (클릭하여 펼치기)

메뉴 / 기능	캡처 이미지
실행 상세 & 노드 모니터링
노드 I/O JSON 인스펙터
AES-256 자격증명 금고 & 키 회전
AI 플레이그라운드 (256K 토큰)
Scoped API 키 발급 & 최소 권한
Keycloak OIDC SSO 연동 설정
RBAC 사용자 및 역할 관리
추가 전용 불변 감사 로그 (Trace ID)
시스템 상태 진단 (PostgreSQL & Queue)

👉 전체 14개 메뉴 상세 설명은 **기능 및 화면 가이드 (docs/features.md)**에서 확인하실 수 있습니다.

• 단 4개의 환경변수로 즉시 기동: 복잡한 Kafka, Redis, Vault 없이 단일 PostgreSQL로 완벽 동작
• 100% 오프라인 & 폐쇄망 배포: 단일 Go 바이너리 내 React 정적 번들이 임베드되어 외부 의존성 제로
• 결함 감내 내구성(Durable Execution):
  • 트랜잭셔널 아웃박스: 노드 실행과 엣지 활성화 이벤트를 1개 DB 트랜잭션으로 원자적 기록
  • 분산 작업 임대: FOR UPDATE SKIP LOCKED 기반 다중 워커 경쟁 임대 및 하트비트
  • 내구 타이머: 지연 대기, 승인 대기, 콜백 만료를 메모리가 아닌 DB 테이블에 보존
  • 멱등성 보장: (execution_id, node_id, iteration_key) 복합 키로 중복 실행 원천 차단
• 엔터프라이즈 보안 & 자격증명 금고:
  • ENCRYPTION_KEY 기반 AES-256-GCM 봉투 암호화 및 컨텍스트 바인딩
  • 원문 재조회 불가 단방향 보호 & 무중단 키 버전 회전(Zero-Downtime Key Rotation)
  • HTTP 요청 노드의 SSRF 방지 (Loopback, Link-Local, Metadata IP 차단)
• Keycloak OIDC SSO 연동: OIDC Discovery 자동 연동 & 그룹 클레임 기반 관리자 권한 매핑
• AI & Model Context Protocol (MCP):
  • OpenAI 호환 API 실시간 SSE 스트리밍 채팅 (최대 256K 토큰)
  • POST /mcp Streamable HTTP 엔드포인트 제공 (list_workflows, run_workflow, get_execution)
• 실시간 관측성 & 불변 감사 로그:
  • SSE 기반 실시간 실행 상태 스트림 (Last-Event-ID 자동 재연결)
  • 모든 설정 변경, 키 회전, 권한 부여의 Trace ID 연계 감사 로그
  • Prometheus 메트릭 수집 (GET /metrics)

docker run -d --name ssak --restart unless-stopped \
  -p 8080:8080 \
  -e POSTGRES_DSN='postgres://ssak:[email protected]:5432/ssak?sslmode=require' \
  -e BOOTSTRAP_ADMIN='admin' \
  -e BOOTSTRAP_ADMIN_PASSWORD='replace-with-a-strong-password' \
  -e ENCRYPTION_KEY='replace-with-at-least-32-random-characters' \
  ssak:v0.1.0

필수 환경변수 4종:

• POSTGRES_DSN: PostgreSQL 연결 문자열
• BOOTSTRAP_ADMIN: 초기 부트스트랩 관리자 아이디
• BOOTSTRAP_ADMIN_PASSWORD: 초기 관리자 비밀번호 (12자 이상)
• ENCRYPTION_KEY: AES-256-GCM 마스터 암호화 키 (32자 이상)

# 프론트엔드 빌드
make web

# 테스트 실행
make test

# 단일 실행 파일 빌드
make build VERSION=0.1.0

# 컨테이너 이미지 빌드 및 오프라인 아카이브 생성
make image-archive VERSION=0.1.0

  ┌─────────────────────────────────────────────────────────────┐
  │         React UI / REST API / SSE / MCP / Webhooks          │
  └──────────────────────────────┬──────────────────────────────┘
                                 │
                     ┌───────────▼───────────┐
                     │     Go Control API    │
                     └───────────┬───────────┘
                                 │
     ┌───────────────────────────▼───────────────────────────┐
     │              PostgreSQL Database                      │
     │  - executions (고정 버전 바인딩)                       │
     │  - node_runs / edge_runs (상태 전이)                  │
     │  - outbox_events (트랜잭셔널 아웃박스)                │
     │  - durable_timers (DB 내구 타이머)                    │
     │  - payload_objects (대용량 페이로드)                  │
     └───────────────────────────┬───────────────────────────┘
                                 │ FOR UPDATE SKIP LOCKED
                     ┌───────────▼───────────┐
                     │    Durable Workers    │
                     │  (Lease Heartbeat)    │
                     └───────────────────────┘

본 프로젝트는 사내망 및 엔터프라이즈 환경을 위한 내부 배포 표준을 준수합니다.