경계 약속
API 계약
다른 이름: API · API contract · 엔드포인트 계약
API 제공자와 소비자가 입력·출력·권한·오류·상태를 같은 뜻으로 해석하도록 정한 약속이다. 화면이나 구현 코드의 모양이 아니라 관찰 가능한 경계를 소유한다.
GET /api/search?q=term · 401 · 403 · 404 · 409 · 500
이름·동의어·예제·비교를 한 카드에서 확인해요.
경계 약속
다른 이름: 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/ · apps/console/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 차단
비동기 실행 역할
다른 이름: 작업 스케줄러 · 예약 실행기 · Job Scheduler
정한 시각·주기·조건이 되면 수행할 비동기 작업을 생성하거나 실행 대상으로 내보내는 역할입니다.
데이터 도구
다른 이름: 객체 관계 매핑 · Object-Relational Mapping
애플리케이션 객체와 관계형 Table 사이 변환과 질의·Transaction 작성을 돕는 라이브러리 또는 방식입니다.
자원 관리
다른 이름: DB Pool · DB 연결 풀 · Database Connection Pool
만드는 비용이 큰 DB Connection을 제한된 수로 준비해 요청이 빌리고 반드시 반환하게 하는 관리 구조입니다.
실행 경로
다른 이름: 실행 계획 · 질의 계획 · Database Query Plan
데이터베이스가 한 SQL을 실행하기 위해 선택한 Table Scan·Index Search·JOIN·정렬의 순서와 비용 추정입니다.
Seq Scan · Index Scan · Index Only Scan
데이터베이스 제품
다른 이름: Postgres · PostgreSQL
별도 서버 프로세스가 여러 연결을 받아 SQL·Transaction·Constraint·Index와 운영 복구 기능을 제공하는 오픈소스 서버형 관계형 데이터베이스 제품입니다.
데이터베이스 제품
다른 이름: SQLite
별도 서버 프로세스 없이 한 파일에서 SQL·Transaction·Constraint를 제공하는 내장형 파일 기반 관계형 데이터베이스 제품입니다.
토큰 Claim 형식
다른 이름: JSON 웹 토큰 · JSON Web Token
주체와 사용 조건에 관한 JWT Claim 묶음을 JWS로 무결성 보호하거나 JWE로 암호화해 전달하는 표준 표현입니다. JWT라는 이름만으로 서명·MAC·암호화 중 어떤 보호를 적용했는지는 알 수 없습니다.
보안 기록
다른 이름: 감사 기록 · Audit Trail · Audit Log · 감사 추적
누가 언제 어떤 이유로 어떤 자원을 조회·변경하려 했고 결과가 어땠는지 추적하는 변조 방지 기록입니다. 고위험 작업은 실행 전 intent와 실행 후 결과를 구분해 남깁니다.
실패 정책
다른 이름: 안전 차단 · Fail-closed
검증이나 의존성이 실패했을 때 잘못 허용하는 피해를 피하려고 해당 행동을 기본 거절하는 정책입니다.
RPC 구현 체계
다른 이름: 지알피시 · gRPC Remote Procedure Calls
Protocol Buffers 계약과 생성 코드, HTTP/2 기반 전송을 주로 사용하는 RPC 구현 체계입니다.
프로토콜
다른 이름: 웹소켓 · raw WebSocket · WebSocket Protocol
한 번 연결한 뒤 클라이언트와 서버 양쪽이 메시지를 보낼 수 있는 지속 양방향 통신 프로토콜입니다.
미디어 기술 묶음
다른 이름: 웹 실시간 통신 · Web Real-Time Communication
브라우저와 기기 사이에서 음성·영상·데이터를 낮은 지연으로 전송하는 표준과 API 묶음입니다.
네트워크 경로 선택
다른 이름: 아이스 · 연결 경로 탐색 · Interactive Connectivity Establishment
WebRTC 피어가 사용할 수 있는 네트워크 후보를 모아 실제 연결 가능성을 시험하고 통신 경로를 고르는 절차입니다.
데이터 패킷 중계
다른 이름: 턴 · Traversal Using Relays around NAT
직접 경로가 막혔을 때 relay 서버가 미디어·DataChannel 같은 피어 사이 데이터 패킷을 대신 전달하게 하는 프로토콜과 서버 역할입니다.
AI 운영 비용 보호
다른 이름: AI 비용 게이트 · LLM 비용 차단 · provider cost gate
토큰이나 요청량에 따라 비용이 생기는 외부 AI provider를 기본 차단하고, 데이터 전송과 예산이 승인된 경우에만 호출을 허용하는 실행 경계입니다.
클라우드 provider 기본 차단 · 토큰 상한 승인 후 활성화
AI 능력
다른 이름: 음성 합성 · Speech Synthesis · Text-to-Speech
텍스트를 선택한 Voice와 속도·형식 조건에 맞는 재생 가능한 음성으로 변환하는 AI 기능입니다.
AI 구조
다른 이름: 검색 증강 생성 · Retrieval-Augmented Generation
질문과 관련된 자료를 먼저 검색해 모델 입력 문맥에 근거로 추가한 뒤 답을 생성하는 구조입니다.
ANN Index
다른 이름: HNSW Index · Hierarchical Navigable Small World
여러 층의 이웃 Graph를 따라 넓은 탐색에서 정밀 탐색으로 내려가는 ANN Index입니다.
PostgreSQL Extension
다른 이름: Postgres Vector Extension · pgvector PostgreSQL Extension
PostgreSQL에 Vector 자료형·거리 연산·Exact 및 ANN Index를 추가하는 Extension입니다.
프런트엔드 빌드 도구
ES 모듈 기반 개발 서버와 번들 빌드를 제공하는 프런트엔드 도구입니다.
앱 런타임
웹 UI를 운영체제 WebView에서 실행하고 Rust 명령과 권한으로 네이티브 기능을 제한하는 앱 프레임워크입니다.
클라이언트 상태
React 화면에서 여러 컴포넌트가 공유하는 UI 상태를 작은 store와 selector로 관리하는 상태 라이브러리입니다.
서버 상태
클라이언트에서 원격 데이터의 조회·캐시·재시도·무효화 수명을 관리하는 서버 상태 라이브러리입니다.
브라우저 저장소
브라우저에서 구조화된 대용량 데이터를 트랜잭션과 인덱스로 저장하는 비동기 로컬 데이터베이스입니다.
Python API
Python 타입 힌트와 검증 모델을 이용해 HTTP API와 문서를 구성하는 비동기 웹 프레임워크입니다.
Java API
Spring에서 요청 매핑·검증·응답 직렬화를 담당하는 서블릿 기반 HTTP 애플리케이션 계층입니다.
데이터 접근 제어
데이터베이스가 현재 주체와 행의 속성을 비교해 조회·수정 가능 여부를 정책으로 판정하는 접근 제어입니다.
브라우저 검증
실제 브라우저 엔진에서 탐색·입력·네트워크·접근 가능한 UI 동작을 자동 검증하는 테스트 도구입니다.
통합 검증
테스트 중 실제 데이터베이스·브로커 같은 의존 서비스를 일시 컨테이너로 실행하는 통합 테스트 도구입니다.
로컬 추론
로컬 모델을 실행하고 OpenAI 호환 HTTP 인터페이스로 추론 기능을 제공할 수 있는 데스크톱 런타임입니다.
브라우저 추론
ONNX 모델을 WebAssembly나 WebGPU 실행 공급자로 브라우저 안에서 추론하는 런타임입니다.
UI 라이브러리
상태와 속성으로 선언한 컴포넌트 트리를 화면과 동기화하는 사용자 인터페이스 라이브러리입니다.
웹 프레임워크
React의 서버·클라이언트 컴포넌트, 라우팅, 데이터 조회, 빌드와 배포 경계를 함께 제공하는 웹 프레임워크입니다.
인메모리 저장소
짧은 수명의 캐시·세션·rate limit·분산 상태를 빠르게 읽고 쓰는 인메모리 데이터 저장소입니다.
이벤트 스트리밍
이벤트를 순서가 있는 partition log에 보존하고 여러 consumer가 각자의 위치에서 처리하게 하는 스트리밍 플랫폼입니다.
문서 인식
이미지와 스캔 문서의 글자 영역을 찾아 기계가 다룰 수 있는 텍스트로 변환하는 처리 과정입니다.
웹 프록시
TLS 인증서 자동화와 HTTP reverse proxy를 제공하며 공개 진입점과 내부 서비스 경계를 분리하는 웹 서버입니다.