용어 사전

다른 이름: API · API contract · 엔드포인트 계약

API 제공자와 소비자가 입력·출력·권한·오류·상태를 같은 뜻으로 해석하도록 정한 약속이다. 화면이나 구현 코드의 모양이 아니라 관찰 가능한 경계를 소유한다.

GET /api/search?q=term · 401 · 403 · 404 · 409 · 500

다른 이름: 멱등 · idempotent · 중복 요청 안전성

같은 의도를 여러 번 처리해도 관찰되는 최종 업무 상태가 한 번 처리한 결과와 같도록 만드는 성질이다. 재시도 자체를 없애는 것이 아니라 중복 효과를 제한한다.

Idempotency-Key: order-123 · ON CONFLICT DO NOTHING

다른 이름: SSOT · single source of truth · 원본 단일화

하나의 사실을 변경할 권한과 의미를 한 원본에 두고, 다른 표현은 파생물로 취급하는 원칙이다. 복사본을 없애는 말이 아니라 소유권과 동기화 경계를 명확히 하는 말이다.

notes/ · courses/ · frontend/admin/sql/

다른 이름: DB migration · database migration · 스키마 변경

운영 데이터의 구조나 제약을 한 상태에서 다음 상태로 바꾸는 버전화된 변경 단위다. SQL 문법이 성공한 것과 서비스가 호환되고 복구 가능한 것은 별도 판정이다.

CREATE INDEX CONCURRENTLY · forward fix

다른 이름: rate limiting · 요청 제한 · 호출 제한

시간·주체·경로별 요청량을 제한해 시스템 자원과 외부 비용을 보호하는 정책이다. 차단 숫자만 정하는 것이 아니라 초과 응답과 재시도 안내까지 계약으로 만든다.

60 requests / minute · HTTP 429

다른 이름: cache · 캐싱 · 캐시 적중

다시 계산하거나 가져올 결과의 복사본을 저장해 지연과 원본 부하를 줄이는 방식이다. 캐시 적중은 빠른 응답의 증거일 뿐 최신성·권한·정합성의 증거는 아니다.

Cache-Control: max-age=300 · cache hit / miss

다른 이름: SSE · EventSource · 서버 이벤트

서버가 HTTP 연결을 열어 둔 채 클라이언트로 텍스트 이벤트를 한 방향으로 전달하는 계약이다. 알림 신호와 업무 데이터의 원본을 분리하고 재연결 cursor를 정해야 한다.

Content-Type: text/event-stream · Last-Event-ID: 42

다른 이름: WebRTC cost gate · TURN 비용 게이트 · 영상채팅 비용 차단

WebRTC 기능의 코드와 운영 진입점을 분리해 두고, TURN·SFU·영상처럼 비용이 커질 수 있는 경로는 명시적 설정과 비용 승인 전까지 비활성화하는 원칙이다.

WEBRTC_VOICE_ENABLED=false · TURN·SFU·video disabled

다른 이름: Fixture · test fixture · 테스트 준비 데이터

한 테스트를 같은 조건에서 재현하도록 미리 준비한 입력·상태·대역의 작은 묶음이다. 평가 Dataset처럼 운영 분포를 대표하는 자료와는 범위가 다르다.

seeded PostgreSQL row · temporary upload file

다른 이름: Object Storage · S3 · 객체 스토리지

큰 파일 바이트를 객체 키와 부가 메타데이터로 저장하는 시스템이다. 저장 성공은 업무 처리 완료나 권한 검증 완료와 같은 뜻이 아니다.

bucket/object-key · presigned URL

다른 이름: Tauri capability · capability file · Tauri 권한

Tauri 앱 창이 사용할 수 있는 명령과 권한을 명시적으로 묶는 설정 경계다. 편의를 위해 로컬 서버나 파일 시스템 전체를 열기보다 필요한 능력만 허용한다.

core:default · localhost:8000 차단