용어집
Specvital 플랫폼 전반에서 사용되는 도메인 용어.
핵심 도메인
| 용어 | 정의 |
|---|---|
| Codebase | 분석 대상으로 등록된 GitHub 리포지토리 (host + owner + name) |
| Analysis | 특정 커밋 시점의 코드베이스에 대한 단일 파싱 작업 |
| Inventory | 코드베이스에서 파싱된 테스트 파일 전체 컬렉션 |
| Test Suite | 관련 테스트 그룹 (예: Jest의 describe 블록) |
| Test Case | 개별 테스트 (예: it/test 블록) |
| Framework | 사용된 테스트 라이브러리 (Jest, Vitest, Playwright, Go testing 등) |
테스트 상태
| 용어 | 정의 |
|---|---|
| active | 실행될 일반 테스트 |
| skipped | 건너뛰도록 표시된 테스트 (.skip, t.Skip()) |
| todo | 아직 구현되지 않은 플레이스홀더 (.todo) |
| focused | 단독 실행하도록 표시된 테스트 (.only) |
| xfail | 실패가 예상되는 테스트 (@pytest.mark.xfail) |
분석 상태
| 용어 | 정의 |
|---|---|
| pending | 큐에 등록됨, 아직 시작 안 함 |
| running | 분석 진행 중 |
| completed | 분석 성공적으로 완료 |
| failed | 분석 중 오류 발생 |
아키텍처
| 용어 | 정의 |
|---|---|
| Core | 테스트 파서 라이브러리 (Go) - 소스 코드를 테스트 인벤토리로 파싱 |
| Collector | 백그라운드 워커 서비스 - 큐를 통해 분석 작업 조율 |
| Web | 프론트엔드 (Next.js) + 백엔드 API (Go Chi) |
| Infra | 데이터베이스 스키마 및 로컬 개발 인프라 |
| Worker | PostgreSQL 큐에서 분석 태스크를 소비하는 River 기반 프로세스 |
| Scheduler | 주기적 갱신 태스크를 큐에 등록하는 Cron 기반 프로세스 |
기술 용어
| 용어 | 정의 |
|---|---|
| Tree-sitter | AST 기반 코드 분석에 사용되는 점진적 파싱 라이브러리 |
| AST | 추상 구문 트리 - 소스 코드의 구조화된 표현 |
| River | PostgreSQL을 사용한 분산 태스크 큐 Go 라이브러리 |
| sqlc | SQL 쿼리에서 타입 안전 Go 코드 생성 |
| Atlas | 데이터베이스 스키마 마이그레이션 도구 |
소스 타입
| 용어 | 정의 |
|---|---|
| LocalSource | 파서가 로컬 파일시스템에서 읽음 |
| GitSource | 파서가 원격 Git 리포지토리에서 클론 |