Server (Express + TypeScript)

진입점: server/src/index.ts

Directory Structure

server/src/
  index.ts              # Express 앱 팩토리 (CORS, 라우트 마운트, health 엔드포인트)
  config/
    db-paths.ts         # DB_DIR 기준 파일 경로 계산
    database.ts         # Core SQLite 연결 및 스키마 초기화
    analytics-db.ts     # Analytics SQLite 연결 및 스키마 초기화
    request-logs-db.ts  # 월별 request_logs SQLite 연결 및 스키마 초기화
  models/
    User.ts             # 사용자 CRUD (create, findById, findByApiKey, update, delete, regenerateApiKey)
    Backend.ts          # 백엔드 CRUD (create, findById, findAll, update, delete)
    Permission.ts       # 권한 관리 (user-backend 매핑)
    Script.ts           # 스크립트 CRUD (타입별 필터링, 활성화/비활성화)
  routes/
    auth.ts             # Bearer 토큰 인증 미들웨어 (API 키 검증, 권한 로드)
    api.ts              # OpenAI 호환 프록시 엔드포인트 (/v1/chat/completions, /v1/models)
    admin.ts            # Admin CRUD 엔드포인트 (users, backends, permissions, /admin/health, /admin/scripts 마운트)
    scripts.ts          # Script 관리/테스트 엔드포인트
    analytics.ts        # Analytics 조회 엔드포인트
  services/
    RouterService.ts    # 활성 백엔드 선택, HTTP 요청 포워딩, header/body 정규화
    AnalyticsService.ts # 일별 사용량/메트릭 집계 + request_logs 조회
    RequestLogService.ts # 월별 request_logs 기록/조회
    ScriptEngine.ts     # 스크립트 체인 오케스트레이션 (onRequest/onResponse 훅 적용)
    ScriptExecutor.ts   # isolated-vm 기반 스크립트 컴파일/실행 (5s timeout, 50MB memory)
  utils/
    apiKey.ts           # API 키 생성 (sk-{timestamp}-{random}, crypto.randomBytes)
    logger.ts           # 컬러 콘솔 로거
    time.ts             # TZ 기준 날짜/월 계산, UTC timestamp 생성

Request Flow

Client → auth.ts (API 키 검증, 권한 로드)
       → RouterService.selectBackend (허용된 활성 백엔드 중 1개 선택)
       → ScriptEngine.applyOnRequestScripts (요청 변조)
       → RouterService.forwardRequest (백엔드 프록시)
       → ScriptEngine.applyOnResponseScripts (응답 컨텍스트 후처리/검사)
       → AnalyticsService.logRequest (집계 + 월별 request_logs 기록)
       → Response

참고:

라우트 마운트는 server/src/index.ts 에서 직접 수행한다.
onResponse 훅은 실행되지만, 현재 구현에서는 훅 반환값을 최종 HTTP 응답에 다시 반영하지 않는다.

Time & Storage

DB 루트는 DB_DIR로 설정한다. 파일은 core.db, analytics.db, request_logs/request_logs_YYYY-MM.db 구조로 생성된다.
일/월 경계 계산은 TZ 기준으로 수행한다.
저장되는 timestamp 문자열은 UTC ISO 형식으로 통일한다.

Dependencies

Package	Purpose
express@5	웹 프레임워크
better-sqlite3	SQLite 드라이버
isolated-vm	스크립트 샌드박스 실행
zod	입력 검증
cors	CORS 미들웨어
dotenv	환경변수 로딩

Tests

통합 테스트: server/tests/integration/

api.test.ts — 인증, 인가, 프록시 엔드포인트
admin.test.ts — Admin CRUD
routing.test.ts — 백엔드 선택, 요청 포워딩
scripts.test.ts — 스크립트 생성, 실행, 훅

테스트 유틸: server/tests/utils/ (testApp.ts, mockBackend.ts)

벤치마크: server/benchmarks/ (index.ts, runner.ts, scenarios.ts, report.ts, stats.ts)

사용 문서:

docs/benchmarks.md - benchmark CLI usage, modes, output, caveats

3.7 KiB Raw Blame History