Repository navigation
KO Architecture
윤혁준 edited this page Jul 10, 2026
·
1 revision
toard는 수집 방법이 달라도 같은 사용량 이벤트로 수렴시키고, 비용 계산과 저장을 서버 책임으로 두는 구조입니다.
| 위치 | 책임 |
|---|---|
apps/web |
Next.js 앱, API, 대시보드, 인증 |
packages/core |
도메인 타입과 StorageBackend 계약 |
packages/ingest |
파싱, provider 식별, 정규화, dedup |
packages/pricing |
가격 동기화와 비용 계산 |
packages/storage-postgres |
기본 이벤트·집계 저장소 |
packages/storage-clickhouse |
선택형 분석 저장소 |
shim/rust |
로컬 수집, wrapper, daemon, 업데이트 |
기본 수집은 shim이 로컬 파일을 읽어 /api/v1/events로 보내는 pull 경로입니다. 서버는 token으로 사용자를 결정하고 비용을 계산합니다. OTLP는 experimental 경로이며, provider별 수집 방식을 분리해 이중 집계를 막습니다.
Postgres는 메타데이터와 기본 이벤트 저장소입니다. ClickHouse를 선택해도 계정·팀·인증은 Postgres에 남습니다.
이 Wiki는 길잡이입니다. 데이터 모델, ADR, 수집 계약의 원본은 아키텍처 설계 문서와 사용량 pull 설계입니다.