경계 약속
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 차단
과정
다른 이름: 개발 주기 · Development Cycle
사용자 문제를 정하고 변경을 검증·전달·관찰한 뒤 그 증거로 다음 개선을 고르는 반복 과정입니다. 운영 증거가 다음 판단으로 돌아온다는 점에서는 학습 루프처럼 작동하지만, 모든 학습 활동과 같은 뜻은 아닙니다.
제품
다른 이름: User Problem
특정 사용자가 어떤 상황에서 겪는 불편과 줄이려는 결과를 관찰 가능한 말로 표현한 것입니다. 문제를 찾아 표현하는 문제 정의 활동 전체와 그 결과인 사용자 문제를 같은 대상으로 부르지 않습니다.
계약
다른 이름: 요구 · Requirement
사용자나 사업이 시스템에 기대하는 가치·행동·제약을 표현한 합의 대상입니다.
계약
다른 이름: 기능 계약 · Development Contract
입력·출력·권한·오류·상태와 호환 조건을 제공자와 소비자가 같은 뜻으로 해석하도록 정한 약속입니다.
검증
다른 이름: 완료 조건 · 인수 기준 · Acceptance Criteria
누가 어떤 상황에서 행동했을 때 무엇이 관찰되어야 완료인지 정상·거절·경계 결과로 적은 조건입니다.
식별 값
다른 이름: ID · Identifier · 식별값 · Identifier (ID)
자료나 요청처럼 시스템이 다루는 한 대상을 다른 대상과 구분하고 다시 찾도록 부여한 안정적인 값입니다.
계약
다른 이름: Spec · 스펙 · Specification
문제·범위·구체 예·입출력·오류·권한·비기능 조건과 검증 증거를 구현 전에 합의한 기록입니다.
개발 방식
다른 이름: Specification-Driven · 명세 주도 개발 · Specification-Driven Development
검증 가능한 명세를 먼저 구체화하고 작업·코드·테스트를 그 완료 기준에 계속 연결하는 개발 방식입니다.
개발 방식
다른 이름: Test-Driven · 테스트 주도 개발 · Test-Driven Development
작은 기대 행동의 실패 테스트를 먼저 확인하고 최소 구현과 안전한 구조 개선을 짧게 반복하는 개발 방식입니다.
TDD 단계
다른 이름: 실패 단계 · Red Phase
새 기대 행동을 나타내는 테스트가 구현 부족 때문에 올바른 이유로 실패하는지 확인하는 단계입니다.
TDD 단계
다른 이름: 통과 단계 · Green Phase
현재 실패 테스트를 통과시키는 가장 단순한 구현을 만들어 행동 증거를 확보하는 단계입니다.
개발 활동
다른 이름: Refactor · Refactoring
외부에서 관찰되는 동작을 유지하면서 이름·중복·책임과 구조를 더 이해하기 쉽게 바꾸는 활동입니다.
변경
다른 이름: 행동 변경 · Feature Change
사용자나 다른 시스템이 관찰하는 입력·출력·규칙·상태 중 하나를 바꾸는 변경입니다.
작업 분해
다른 이름: 수직 슬라이스 · Vertical Slice
가장 작은 사용자 결과가 화면·서버·데이터 경계를 끝까지 통과하도록 기능을 얇게 나누는 방식입니다.
작업 분해
다른 이름: 수평 분할 · Layer-only Work
화면이나 데이터베이스처럼 한 기술 계층의 변경을 먼저 크게 묶는 작업 방식입니다.
테스트
다른 이름: Unit Test
작은 규칙이나 객체의 입력과 결과를 빠르고 격리된 조건에서 확인하는 테스트입니다.
테스트
다른 이름: Integration Test
데이터베이스·API·외부 어댑터처럼 둘 이상의 실제 경계가 같은 계약으로 동작하는지 확인하는 테스트입니다.
테스트
다른 이름: E2E · End-to-End · 종단 간 테스트 · End-to-End Test · E2E Test
사용자 진입점에서 시작해 핵심 업무 결과까지 여러 실제 계층을 통과하는 흐름을 확인하는 테스트입니다.
검증
다른 이름: Test
주어진 조건에서 시스템이 기대 행동을 보이는지 반복 가능하게 판정하는 증거입니다.
테스트 판정
다른 이름: 검증문 · 기대값 검증 · Test Assertion
테스트에서 실제 결과가 기대한 값이나 조건과 맞는지 비교하고, 다르면 그 테스트를 실패시키는 한 개의 판정문입니다.
테스트 방식
다른 이름: 테스트 우선 · Test-first Development
구현 전에 호출 방법과 기대 결과를 테스트로 먼저 표현해 설계 피드백을 일찍 얻는 방식입니다.
테스트 방식
다른 이름: 구현 후 테스트 · Test-after Development
구현하거나 탐색한 행동을 나중에 테스트로 고정해 회귀를 막고 기존 코드를 안정화하는 방식입니다.
프로그래밍 언어
다른 이름: JS · 자바스크립트 · JavaScript Programming Language
브라우저와 서버 프로그램에서 데이터·규칙·입출력 동작을 표현하는 프로그래밍 언어입니다.
실행 프로그램
다른 이름: Node.js Runtime · Node.js JavaScript Runtime
JavaScript 파일과 내장 모듈·테스트 러너를 브라우저 밖에서 실행하는 프로그램입니다. 터미널의 node는 이 실행 프로그램을 호출하는 명령입니다.
node
프로그래밍 언어
다른 이름: 파이썬 · Python 언어 · Python Programming Language
데이터 처리·자동화·서버 프로그램의 규칙과 동작을 표현하는 프로그래밍 언어입니다.
실행 프로그램
다른 이름: Python Interpreter · Python 3 Interpreter
Python 3 언어로 작성한 소스 파일과 표준 라이브러리를 읽어 실행하는 프로그램으로, 이 과정에서는 터미널의 python3 명령으로 호출합니다.
python3
테스트 도구
다른 이름: 시험 대역 · Test Double
테스트에서 느리거나 통제하기 어려운 실제 협력자를 대신해 정해진 행동을 제공하는 객체의 상위 개념입니다.
테스트 대역
다른 이름: 모의 객체 · Mock Object
예상한 호출·인자·순서를 기록하고 검증하도록 만든 테스트 대역입니다.
테스트 대역
다른 이름: 가짜 구현 · Fake Implementation
실제 시스템보다 단순하지만 같은 소유 계약을 실행해 성공·실패 상태를 통제할 수 있는 구현입니다.
품질
다른 이름: 요구 추적성 · Traceability
요구나 명세 항목이 어느 작업·코드 변경·테스트·운영 증거로 이어졌는지 되찾는 능력입니다.
전달 과정
다른 이름: Build
소스와 의존성을 검사·컴파일·묶어 실행하거나 배포할 수 있는 결과를 만드는 과정입니다.
전달 결과
다른 이름: Artifact · 산출물 · Build Artifact
빌드가 만든 실행 파일·브라우저 번들·배포 묶음처럼 저장하고 환경으로 옮길 수 있는 결과물입니다.
전달 원칙
다른 이름: 변경 불가 산출물 · Immutable Artifact
한 번 식별된 뒤 내용을 바꾸지 않고 같은 바이트를 여러 환경으로 승격하는 산출물입니다.
내용 요약값
다른 이름: 내용 Digest · 콘텐츠 다이제스트 · Content Digest
정확히 정한 바이트 범위와 알고리즘에서 계산하는 고정 길이 요약값입니다. 내용 동일성 판단의 강도는 선택한 알고리즘과 검증 계약에 달려 있으며, 값만으로 작성 주체나 출처를 증명하지는 않습니다.
산출물 식별자
다른 이름: 산출물 내용 해시 · Artifact Digest
빌드 산출물의 정확한 바이트 범위에서 계산해 내용 동일성을 확인하는 Content Digest입니다.
전달 사건
다른 이름: Deploy · 디플로이 · Deployment
선택한 Build Artifact를 특정 실행 환경에 놓고 Process로 실행해 서비스가 요청을 받을 수 있게 하는 사건입니다.
제품 사건
다른 이름: Release · 기능 공개
이미 배포되었거나 준비된 기능·버전을 사용자나 소비자가 실제로 사용할 수 있게 여는 사건입니다.
배포 복구
다른 이름: 배포 되돌림 · Deployment Rollback
문제가 생긴 Software Application의 새 Build Artifact 대신 이전 호환 Build Artifact를 다시 실행해 서비스의 실행 버전을 되돌리는 복구입니다. Source Code 이력을 바꾸거나 DB 데이터·외부 효과를 자동으로 되돌리는 행동은 아닙니다.
릴리스 제어
다른 이름: 기능 토글 · Feature Toggle · Feature Flag
배포된 코드의 특정 행동을 설정이나 대상 조건으로 켜고 끄는 임시 릴리스 제어 장치입니다.
운영 검사
다른 이름: 상태 검사 · Health Check
실행 중인 구성 요소가 정한 건강 조건에 응답하는지 기계가 반복 확인하는 검사입니다.
운영 검사
다른 이름: 시작 검사 · 초기화 검사 · Startup Probe
느린 초기화가 끝날 때까지 시작 상태만 확인하고 성공한 뒤 반복 Liveness·Readiness 검사에 판정을 넘기는 전용 검사입니다.
운영 검사
다른 이름: 생존 검사 · Liveness Check
프로세스가 교착되거나 회복 불가능하게 멈추지 않고 살아 있는지 판정하는 상태 검사입니다.
운영 검사
다른 이름: 준비 상태 검사 · Readiness Check
프로세스가 필요한 의존성과 초기화를 갖춰 실제 요청을 받을 준비가 되었는지 판정하는 검사입니다.
배포 검증
다른 이름: 스모크 테스트 · Smoke Test
배포된 실제 환경에서 로그인·조회·저장 같은 가장 중요한 업무 경로가 최소한 동작하는지 빠르게 확인하는 검사입니다.
운영 품질
다른 이름: Observability · 관측성
로그·메트릭·트레이스 같은 외부 신호로 시스템 내부 상태와 실패 원인을 추론할 수 있는 성질입니다.
운영 활동
다른 이름: 감시 · Monitoring
미리 정한 지표·조건·대시보드·경보로 서비스 상태를 지속 확인하는 운영 활동입니다.
구조
다른 이름: 소프트웨어 시스템 · System
화면·통신·처리·기억·외부 능력·운영 요소가 연결되어 사용자 기능을 제공하는 전체입니다.
영역
다른 이름: Frontend · 클라이언트 화면
사용자 기기에서 화면을 그리고 입력·대기·오류 상태를 표현하며 서버와 통신하는 소프트웨어 영역입니다.
영역
다른 이름: Backend · 서버 애플리케이션
관리되는 신뢰 경계에서 입력·신원·권한·업무 규칙과 데이터 접근을 최종 판정하는 소프트웨어 영역입니다.
통신 역할
다른 이름: Client
네트워크 연결이나 요청을 시작해 다른 프로그램의 기능을 사용하는 쪽입니다. 모든 인프로세스 호출자가 네트워크 Client인 것은 아닙니다.
통신 역할
다른 이름: Server · 서버 프로그램
주소와 포트에서 요청을 받아 계약과 업무 규칙에 따라 결과를 돌려주는 프로그램 역할입니다.
개발 재료
다른 이름: 소스 코드 원본 · Source Code
사람이 읽고 변경하며 버전 관리에 기록하는 프로그램의 원본 표현입니다.
소프트웨어 프로그램
다른 이름: Application · 소프트웨어 애플리케이션 · Software Application
사용자나 다른 시스템에 업무 기능을 제공하도록 코드와 필요한 구성 요소를 묶은 소프트웨어 프로그램입니다. 아직 실행되지 않은 Application과 운영체제가 실행해 만든 Process는 같은 대상이 아닙니다.
실행 기반
다른 이름: 실행 체계 · Runtime
프로그램 코드가 실제로 실행되도록 메모리·입출력·언어 기능을 제공하는 환경 또는 그 실행 체계입니다.
실행 단위
다른 이름: 실행 프로세스 · Process
운영체제가 메모리·CPU·파일·네트워크 자원을 할당해 실행하는 프로그램 인스턴스입니다.
실행 자원
다른 이름: 중앙처리장치 · Central Processing Unit
프로그램의 명령과 계산 작업을 실행하는 처리 자원으로, 동시에 밀어 넣는 작업량이 처리 능력을 넘으면 대기와 지연이 늘어납니다.
운영 경계
다른 이름: 실행 서비스 · Runtime Service
하나 이상의 교체 가능한 프로세스가 안정적인 이름과 계약으로 제공하는 사용자 기대 기능입니다.
서비스 실행 단위
다른 이름: Application Instance · App Instance · 서비스 인스턴스 · Service Instance
같은 런타임 서비스 계약을 제공하도록 실행 중인 교체 가능한 한 복사본으로, 보통 한 프로세스나 컨테이너가 이 역할을 맡습니다.
네트워크 주소
다른 이름: 네트워크 포트 번호 · Network Port
한 네트워크 대상에서 어느 통신 접점이 연결을 받을지 구분하는 0~65535 범위의 번호입니다. Network Port 하나만으로 특정 장비나 Process의 신원을 증명하지는 않습니다.
빌드 산출물
다른 이름: Container Image
프로그램 실행에 필요한 파일·의존성·기본 설정을 불변 계층으로 묶은 컨테이너 실행 틀입니다.
실행 단위
다른 이름: 런타임 컨테이너 · Software Container
컨테이너 이미지를 격리된 파일·프로세스·네트워크 설정으로 실행한 인스턴스입니다. 하나의 Container 안에서 하나 이상의 Process가 실행될 수 있습니다.
데이터
다른 이름: 업무 상태 · State
현재와 다음 행동을 결정하기 위해 시스템이 시간에 따라 기억해야 하는 값입니다.
임시 데이터
다른 이름: 프로세스 메모리 · Memory State · In-memory State
현재 프로세스가 살아 있는 동안만 빠르게 유지되며 재시작이나 다른 실행본과 자동 공유되지 않는 상태입니다.
지속 저장 역할
다른 이름: 지속 저장 자원 · 지속 저장소 · Persistent Data Storage
프로세스 실행보다 오래 남겨야 할 데이터와 파일을 기록하고 다시 읽게 하는 자원이나 시스템 역할입니다. 먼저 배우는 Database와 Object Storage는 서로 다른 구조와 조회 계약으로 이 역할을 구현합니다.
지속 저장 자원
다른 이름: Disk · 디스크 · Persistent Disk Storage
프로세스가 종료돼도 파일과 데이터베이스 바이트를 남길 수 있는 장치·블록·파일 저장 자원입니다. 로컬 디스크는 이 저장 자원의 한 배치 형태입니다.
로컬 디스크
데이터 원칙
다른 이름: 단일 진실 원천 · 정답 원본 · Single Source of Truth
복사본들이 충돌할 때 최종 업무 사실로 판정하기로 합의한 한 소유 원천입니다.
실행 단위
다른 이름: 작업 실행 단위 · Executable Job
완료 조건과 실행 상태를 가진 한 묶음의 작업입니다. 제품 업무·자동 검증·예약 실행처럼 문맥에 따라 수명과 책임이 달라지므로 범위를 붙여 사용합니다.
실행 흐름
다른 이름: 동기 요청 · Sync · Synchronous Processing
호출자가 같은 요청 연결에서 작업의 최종 결과가 돌아올 때까지 기다리는 처리 방식입니다.
실행 흐름
다른 이름: Async Job · 백그라운드 작업 · Asynchronous Job
요청과 최종 완료를 분리하고 작업 ID와 상태를 저장한 뒤 뒤에서 처리하는 실행 단위입니다.
실행 역할
다른 이름: 백그라운드 워커 · Background Worker
Queue나 저장된 작업을 가져와 요청 연결 밖에서 비동기 업무를 실제 수행하는 프로세스 역할입니다.
비동기 실행 역할
다른 이름: 작업 스케줄러 · 예약 실행기 · Job Scheduler
정한 시각·주기·조건이 되면 수행할 비동기 작업을 생성하거나 실행 대상으로 내보내는 역할입니다.
중의적 기술 용어
다른 이름: 시스템 사건 · System Event
시스템에서 관찰되어 다른 처리나 기록의 계기가 되는 발생 사실입니다. 사용자 입력·업무 상태 변화·자동화 시작처럼 문맥마다 발생 주체와 의미가 다르므로 범위를 붙여 사용합니다.
다른 이름: 업무 Event · 업무 사건 · Business Event
이미 일어난 업무 사실을 이름·식별자·시각과 필요한 데이터로 다른 처리자에게 알리는 메시지입니다. 화면 Event나 네트워크 Event 같은 모든 사건을 뜻하지는 않습니다.
메시징
다른 이름: 대기열 · 메시지 큐 · Queue
아직 처리되지 않은 작업이나 메시지를 생산자와 소비자 사이에 순서와 전달 정책으로 보관하는 대기열입니다.
환경
다른 이름: 로컬 환경 · Local Environment
개발자 기기에서 빠른 수정과 재현을 위해 로컬 주소·가짜 데이터·개인 실행을 사용하는 환경입니다. 개발자 기기는 이 환경을 실행하는 장소이지 환경 자체의 다른 이름은 아닙니다.
환경
다른 이름: 시험 환경 · 통합 시험 환경 · Test Environment
합성 데이터와 시험용 자원을 사용해 여러 구성 요소의 실제 통합을 운영 전 확인하는 환경입니다. 조직마다 붙이는 개발·검증·사전 운영 이름이 같아도 이 책임 경계와 자동으로 같은 것은 아닙니다.
다른 이름: 운영 환경 · Prod · Production Environment
실제 사용자·데이터·과금과 복구 책임을 가진 서비스 운영 환경입니다.
운영 경계
다른 이름: 실행 환경 · Environment
같은 코드가 서로 다른 주소·데이터·권한·자원·복구 책임으로 실행되는 분리된 경계입니다.
운영 값
다른 이름: Config · 환경 설정 · Configuration
주소·기능 상태·시간 제한처럼 코드와 분리해 환경별로 바꿀 수 있는 실행 값입니다.
보안 값
다른 이름: 비밀값 · 시크릿 · Secret
비밀번호·개인 키·서명 비밀처럼 알게 된 주체에게 시스템 행동 권한이나 복호화 능력을 주는 값입니다.
네트워크 주소
다른 이름: localhost 호스트명 · Localhost
요청을 보내는 현재 실행 환경 자기 자신을 가리키는 Loopback 호스트 이름입니다. 127.0.0.1과 ::1은 이 이름이 가리킬 수 있는 IPv4·IPv6 주소 사례이지 같은 이름은 아닙니다.
127.0.0.1 · ::1
개발 도구
다른 이름: 프레임워크 · 개발 틀 · Software Framework
프로그램의 실행 흐름과 확장 지점을 제공하며 애플리케이션 코드가 정해진 규칙에 맞춰 들어가는 개발 틀입니다.
프로그래밍 언어
다른 이름: 타입스크립트 · TS · TypeScript Programming Language
JavaScript 문법에 정적 타입 검사를 더하고 실행 전에 JavaScript 코드로 변환하는 프로그래밍 언어입니다.
코드 계약
다른 이름: 인터페이스 · Interface
구현 내부를 드러내지 않고 호출자가 사용할 입력·출력·행동의 경계를 선언한 코드 계약입니다. 모든 코드 계약이 언어의 Interface 선언인 것은 아닙니다.
애플리케이션 계층
다른 이름: HTTP Controller
HTTP 같은 외부 입력을 검증 가능한 애플리케이션 요청으로 번역하고 결과를 응답으로 바꾸는 경계 계층입니다. 모든 단일 요청 처리 함수가 Controller 계층인 것은 아닙니다.
애플리케이션 계층
다른 이름: 업무 서비스 · Application Service · Service Layer
한 업무 사용 사례의 권한·상태·트랜잭션과 여러 협력자 호출 순서를 조율하는 코드 계층입니다.
애플리케이션 계층
다른 이름: 저장소 계층 · Repository Pattern
업무 코드가 저장 기술 세부 대신 도메인 의미의 조회·저장 계약을 사용하게 하는 데이터 접근 경계입니다.
업무 흐름
다른 이름: 사용 사례 · 업무 사용 사례 · Use Case
특정 주체가 목표를 이루기 위해 시스템과 주고받는 입력·판정·결과의 한 업무 흐름입니다.
데이터 변환
다른 이름: Serialization
메모리의 값을 JSON이나 Byte처럼 저장·전송할 수 있는 표현으로 바꾸는 과정입니다. 직렬화 형식은 이 과정이 선택하는 결과 표현이지 과정의 다른 이름이 아닙니다.
프로그램 계약
다른 이름: 애플리케이션 프로그래밍 인터페이스 · Application Programming Interface
한 프로그램이 다른 프로그램의 데이터와 기능을 사용하기 위해 지켜야 하는 호출 계약입니다.
API 경계
다른 이름: 엔드포인트 · API 진입점 · API Endpoint
특정 주소와 전송 규칙으로 접근할 수 있는 API의 한 호출 진입점입니다.
서버 규칙
다른 이름: Route · HTTP 라우트 · 서버 Route · 라우트 · 서버 요청 연결 규칙
HTTP Method와 Path 조합을 특정 Controller나 처리 함수로 연결하는 서버 규칙입니다.
자원 식별 표현
다른 이름: 통합 자원 식별자 · Uniform Resource Identifier
자원을 이름이나 위치로 식별하는 표준 문자열의 상위 개념입니다. 모든 URI가 네트워크에서 곧바로 가져올 수 있는 위치 주소는 아닙니다.
주소
다른 이름: 웹 주소 · Uniform Resource Locator
스킴·호스트·포트 번호·경로·질의 문자열을 조합해 네트워크 자원과 접근 방법을 나타내는 URI입니다.
주소 구성
다른 이름: Scheme · 스킴 · URL Scheme
URL 맨 앞에서 HTTP나 HTTPS처럼 자원에 접근할 통신 방식을 지정하는 부분입니다.
주소 구성
다른 이름: URL 호스트 · URL Host
URL에서 연결할 네트워크 대상의 DNS 이름이나 IP 주소를 나타내는 부분입니다. 하나의 URL Host가 여러 IP 주소로 해석되거나 Load Balancer와 가상 Host를 거쳐 실제 애플리케이션으로 이어질 수 있습니다.
주소 구성
다른 이름: Path · 경로 · URL Path
호스트 안에서 요청할 자원의 위치를 계층적으로 나타내는 URL 부분입니다.
주소 구성
다른 이름: Query · 질의 문자열 · URL Query String
URL의 물음표 뒤에서 필터·정렬·페이지 같은 추가 요청 조건을 이름과 값으로 전달하는 부분입니다.
네트워크
다른 이름: 도메인 이름 시스템 · Domain Name System
사람이 읽는 Host 이름을 통신에 사용할 IP 주소와 관련 기록으로 찾는 분산 이름 체계입니다.
네트워크 주소
다른 이름: IP · IP Address · Internet Protocol Address
IP 네트워크에서 패킷을 보낼 장치나 인터페이스의 위치를 식별하는 주소입니다. 네트워크 주소는 다른 주소 체계나 한 네트워크 대역의 식별값까지 가리킬 수 있어 IP 주소의 동의어로 등록하지 않습니다.
네트워크 캐시
다른 이름: DNS 캐시 · DNS Cache
최근 DNS 응답을 만료 시간 동안 저장해 이름 조회를 줄이는 복사본입니다.
전송 프로토콜
다른 이름: 전송 제어 프로토콜 · Transmission Control Protocol
두 프로그램 사이에 순서가 보존되는 바이트 흐름과 손실 재전송을 제공하는 전송 프로토콜입니다.
데이터 단위
다른 이름: 바이트 · Byte
문자·파일·미디어를 저장하거나 전송할 때 사용하는 작은 이진 데이터 단위로, 보통 8개의 bit로 이루어집니다. 바이트 흐름은 여러 Byte가 순서대로 이어진 것이지 Byte 한 개의 다른 이름이 아닙니다.
연결
다른 이름: TCP 네트워크 연결 · TCP Connection
TCP가 양쪽 주소와 포트 번호 사이에 만들고 순서가 보존되는 바이트 흐름을 주고받는 상태 있는 통신 경로입니다. 모든 네트워크 연결이 TCP인 것은 아닙니다.
보안 프로토콜
다른 이름: 전송 계층 보안 · Transport Layer Security
인증서와 암호화 키를 사용해 통신 상대 신원과 전송 중 기밀성·무결성을 보호하는 프로토콜입니다.
보호 연결 시작
다른 이름: TLS 핸드셰이크 · TLS 연결 협상 · Transport Layer Security Handshake
TLS 통신을 시작할 때 상대 인증서와 지원 조건을 확인하고 이후 데이터를 보호할 암호화 키를 합의하는 단계입니다.
신원 증명
다른 이름: TLS Certificate
공개 키와 상대 신원을 신뢰 체인의 서명으로 묶어 TLS 통신 상대를 검증하게 하는 전자 문서입니다. 서버 인증서와 클라이언트 인증서는 사용 방향이 다른 구체 사례입니다.
서버 인증서 · 클라이언트 인증서
응용 프로토콜
다른 이름: 하이퍼텍스트 전송 프로토콜 · Hypertext Transfer Protocol
클라이언트가 원하는 행동과 입력을 요청 메시지로 보내고 서버가 처리 분류와 결과를 응답 메시지로 돌려주도록 정한 웹 통신 규칙입니다.
보호된 URL 접근 방식
다른 이름: 보안 HTTP · Hypertext Transfer Protocol Secure
HTTP 메시지를 TLS로 보호해 서버 신원과 전송 중 기밀성·무결성을 확인하는 통신 방식입니다.
메시지
다른 이름: HTTP 요청 · 요청 봉투 · HTTP Request
클라이언트가 원하는 행동·자원 위치·부가 정보와 선택적 입력 데이터를 서버에 보내는 HTTP 메시지입니다.
다른 이름: HTTP 응답 · 응답 봉투 · HTTP Response
서버가 처리 결과의 큰 분류·부가 정보와 선택적 결과 데이터를 클라이언트에 돌려주는 HTTP 메시지입니다.
HTTP 구성
다른 이름: Method · 요청 메서드 · HTTP Method
GET·POST·PUT·DELETE·OPTIONS처럼 요청이 자원에 하려는 표준 행동 의도를 나타내는 값입니다. 각각은 HTTP Method의 다른 이름이 아니라 구체적인 Method 값입니다.
GET · POST · PUT
HTTP 구성
다른 이름: Header · 헤더 · HTTP Header
인증·형식·캐시·추적처럼 요청이나 응답 본문을 해석할 부가 정보를 담는 이름과 값입니다.
HTTP 구성
다른 이름: Body · 본문 · HTTP Message Body
요청 입력이나 응답 결과의 실제 데이터 표현을 담는 선택적인 HTTP 메시지 부분입니다.
HTTP 결과
다른 이름: Status · 상태 코드 · HTTP Status Code
2xx·4xx·5xx처럼 요청 처리 결과의 큰 종류를 기계가 판단하게 하는 표준 숫자입니다.
HTTP Status
다른 이름: HTTP 성공 상태군 · 2xx 성공 · HTTP 2xx Successful
서버가 요청을 성공적으로 수신하고 이해해 받아들였음을 나타내는 HTTP Status 범위입니다. 실제 작업 완료 여부와 결과 표현은 개별 2xx Status와 Body·비동기 상태 계약으로 구분합니다.
HTTP Status
다른 이름: 400 · 잘못된 요청 · HTTP 400 Bad Request
요청의 형식·자료형·필수값 등이 계약에 맞지 않아 서버가 처리할 수 없음을 나타내는 상태입니다.
HTTP Status
다른 이름: 401 · 인증 필요 · HTTP 401 Unauthorized
대상 자원에 유효한 인증 자격 증명이 없어서 요청을 처리할 수 없음을 나타내는 상태입니다.
HTTP Status
다른 이름: 403 · 요청 거절 · HTTP 403 Forbidden
서버가 요청을 이해했지만 수행하기를 거절했음을 나타내는 상태입니다. 자격 증명과 무관한 이유로도 거절할 수 있으므로 인증 완료를 필수 전제로 두지 않습니다.
HTTP Status
다른 이름: 404 · 대상 없음 · HTTP 404 Not Found
요청한 라우트나 허용된 범위 안의 자원을 서버가 찾지 못했음을 나타내는 상태입니다.
HTTP Status
다른 이름: 409 · 상태 충돌 · HTTP 409 Conflict
요청 형식은 유효하지만 자원의 현재 상태나 동시 변경 때문에 그대로 적용할 수 없음을 나타내는 상태입니다.
HTTP Status
다른 이름: 429 · 요청 과다 · HTTP 429 Too Many Requests
호출자가 허용된 요청 속도나 사용 한도를 넘어서 현재 요청을 처리하지 않았음을 나타내는 상태입니다.
HTTP Status
다른 이름: 500 · 서버 내부 오류 · HTTP 500 Internal Server Error
서버가 예상하지 못한 내부 오류로 요청 계약을 완료하지 못했음을 나타내는 상태입니다.
HTTP Status
다른 이름: 502 · 잘못된 Gateway 응답 · HTTP 502 Bad Gateway
중계 서버나 Gateway가 선택한 뒤쪽 Server에서 유효한 응답을 받지 못했음을 나타내는 5xx 상태입니다.
HTTP Status
다른 이름: 503 · 일시 이용 불가 · HTTP 503 Service Unavailable
서버가 과부하·점검·필수 의존성 문제로 현재 요청을 일시적으로 처리할 준비가 없음을 나타내는 상태입니다.
HTTP Status
다른 이름: 504 · Gateway 시간 초과 · HTTP 504 Gateway Timeout
Gateway나 Proxy가 뒤쪽 서버의 응답을 제한 시간 안에 받지 못했음을 나타내는 상태입니다.
API 결과
다른 이름: Error Code · 업무 오류 코드 · Business Error Code
같은 HTTP Status 안에서도 클라이언트가 안전하게 구분할 수 있도록 정한 안정적인 업무 실패 식별자입니다.
데이터 형식
다른 이름: 제이슨 · JavaScript Object Notation
문자열·숫자·Boolean·배열·객체·null을 텍스트로 표현하는 데이터 교환 형식입니다.
텍스트 데이터 형식
다른 이름: YAML Ain't Markup Language
들여쓰기와 이름·값·목록 문법으로 사람이 읽을 설정과 구조화 데이터를 표현하는 텍스트 형식입니다. YAML 문서는 이 형식으로 작성한 한 데이터 인스턴스이고 .yml과 .yaml은 이를 담는 파일 확장자 사례입니다.
.yml · .yaml
표현 식별값
다른 이름: 미디어 유형 · MIME Type · Internet Media Type
전송한 데이터의 표현 형식과 필요하면 문자 규칙을 식별하는 표준 값입니다. application/json은 JSON 표현을 가리키는 한 예입니다.
HTTP Header
다른 이름: Content-Type Header · HTTP Content-Type Header
HTTP Body를 어떤 미디어 유형과 문자 규칙으로 해석할지 알리는 Header입니다. application/json 같은 미디어 유형은 이 Header의 값이지 Header 자체의 다른 이름이 아닙니다.
API 설계 방식
다른 이름: REST 설계 방식 · Representational State Transfer
자원과 표현, 무상태 상호작용과 HTTP 표준 의미를 활용해 예측 가능한 API를 만드는 설계 방식입니다. REST API는 이 방식을 적용해 만든 API이지 REST 자체의 다른 이름은 아닙니다.
API 개념
다른 이름: REST Resource · 자원 · Web Resource
API가 안정적인 식별자로 가리키고 여러 표현과 행동을 제공하는 업무 대상입니다.
요청 식별자
다른 이름: Idempotency-Key · 멱등 Key · 멱등키 · Idempotency Key
클라이언트의 같은 업무 의도를 재시도 사이에 식별해 서버가 이전 처리 결과를 찾게 하는 고유 값입니다.
웹 보안 경계
다른 이름: 웹 Origin · 브라우저 출처 · Browser Origin
브라우저가 스킴·호스트·포트 번호의 동일 조합으로 계산하는 웹 문서와 요청의 출처 경계입니다.
웹 보안 경계
다른 이름: Schemeful Site · 브라우저 사이트 경계
브라우저가 스킴과 등록 가능한 도메인을 중심으로 계산해 SameSite Cookie 전송 판단에 사용하는 사이트 경계입니다.
브라우저 정책
다른 이름: 교차 출처 리소스 공유 · Cross-Origin Resource Sharing
서버가 다른 출처의 브라우저 스크립트에 응답 읽기를 허용할지 HTTP 헤더로 알리는 규칙입니다. Cross-Origin은 서로 다른 출처라는 관계이고 CORS는 그 관계에서 응답 공개를 정하는 정책입니다.
브라우저 요청
다른 이름: Preflight · Preflight Request · 사전 요청 · CORS Preflight Request
브라우저가 실제 교차 출처 요청 전에 OPTIONS Method로 허용할 요청 메서드·헤더·자격 증명 조건을 묻는 CORS 확인 요청입니다. 모든 OPTIONS 요청이 Preflight는 아닙니다.
OPTIONS
네트워크 중계 역할
다른 이름: 네트워크 프록시 · 중계 서버 · Network Proxy
통신의 한쪽을 대신해 연결이나 요청을 받고 다른 대상에 전달하며 정책·기록·경로 선택을 적용하는 중계 역할입니다.
네트워크 중계 역할
다른 이름: 포워드 프록시 · 클라이언트 측 프록시 · Forward Proxy
클라이언트를 대신해 외부 서버로 연결하고 목적지 접근·출구 정책·클라이언트 주소 노출을 제어하는 중계자입니다.
네트워크 경계
다른 이름: 리버스 프록시 · Reverse Proxy
클라이언트 요청을 서버 앞에서 받아 TLS 종료·경로 분기·접근 기록 후 내부 서버로 전달하는 중계자입니다.
네트워크 경계
다른 이름: 로드 밸런서 · 부하 분산기 · Load Balancer
준비된 여러 서버 실행본 중 하나로 트래픽을 분배하고 고장 난 대상을 제외하는 구성 요소입니다. L7 Reverse Proxy뿐 아니라 더 낮은 전송 계층에서 분배하는 구현도 있습니다.
추적 식별자
다른 이름: 요청 식별자 · Request Identifier
한 요청의 Proxy·서버·DB·외부 호출 로그와 오류를 연결하기 위해 전송 경계에 함께 싣는 식별값입니다. Correlation ID는 여러 요청·메시지를 한 업무 흐름으로 묶을 수도 있어 같은 분모라고 단정하지 않습니다.
네트워크 통제
다른 이름: 방화벽 · Network Firewall
출발지·목적지·통신 규약·Network Port 같은 규칙으로 허용되지 않은 네트워크 트래픽을 차단하는 통제 경계입니다.
저장 시스템
다른 이름: DB · Database
업무 상태를 프로세스 수명 밖에 지속하고 여러 요청의 조회·변경·복구를 조정하는 저장 시스템입니다.
데이터베이스 방식
다른 이름: RDB · 관계형 DB · Relational Database
같은 종류의 사실을 관계형 표의 행과 열로 저장하고 키·Constraint·Transaction으로 관계와 규칙을 관리하는 데이터베이스입니다.
데이터 구조
다른 이름: Table · DB Table · 테이블 · 표 · Database Table
관계형 데이터베이스에서 같은 종류의 사실을 Schema에 맞는 Row 집합으로 보관하는 구조입니다.
데이터 구조
다른 이름: 행 · Record · Database Row
Table 안에서 한 회원이나 한 주문처럼 하나의 구체적인 사실을 나타내는 값 묶음입니다.
데이터 구조
다른 이름: 열 · Field · Database Column
Table의 모든 Row에서 같은 의미와 자료형을 갖는 한 속성의 자리입니다.
데이터 계약
다른 이름: Schema · 스키마 · DB 구조 · Database Schema
Table·Column·자료형·키·Constraint와 관계를 정해 데이터베이스가 허용할 상태를 표현한 구조 계약입니다.
데이터 규칙
다른 이름: Type · 데이터 타입 · Data Type
Column이나 값이 표현할 수 있는 숫자·문자·날짜 같은 형태와 허용 연산을 정하는 규칙입니다.
데이터 키
다른 이름: PK · 기본 키 · Primary Key
한 Table 안에서 각 Row를 중복 없이 안정적으로 식별하는 Key입니다.
데이터 키
다른 이름: FK · 외래 키 · Foreign Key
한 Table의 값이 다른 Table의 실제 Key를 가리키도록 존재 관계를 강제하는 Constraint입니다.
데이터 제약
다른 이름: 고유 제약 · Unique Constraint
정한 Column 조합의 값이 Table 안에서 중복 저장되지 않도록 데이터베이스가 강제하는 Constraint입니다.
데이터 관계
다른 이름: 일대다 관계 · One-to-Many · One-to-Many Relationship
한 부모 Row가 여러 자식 Row와 연결되지만 각 자식은 그 관계에서 한 부모를 가리키는 구조입니다.
데이터 언어
다른 이름: 구조화 질의 언어 · Structured Query Language
관계형 데이터베이스에 원하는 조회·추가·수정·삭제와 구조 변경을 선언하는 언어입니다.
SQL 문장
다른 이름: 조회 SQL · SQL SELECT
조건·결합·정렬·제한에 맞는 Row와 Column을 읽어 결과 집합을 만드는 SQL 문장입니다.
SQL 절
다른 이름: 행 선택 조건 · 행 필터 조건 · SQL WHERE Clause
SELECT·UPDATE·삭제 SQL이 대상으로 삼을 Row를 Boolean 조건으로 좁히는 SQL 절입니다. 조회뿐 아니라 수정·삭제 대상도 제한합니다.
SQL 조회 절
다른 이름: 결과 정렬 절 · SQL ORDER BY Clause
조회 결과 Row를 지정한 Column과 오름·내림 순서로 정렬하는 SQL 절입니다.
SQL 조회 절
다른 이름: 결과 개수 제한 절 · SQL LIMIT Clause
정렬과 조건을 적용한 조회 결과에서 반환할 최대 Row 수를 제한하는 SQL 절입니다.
SQL 문장
다른 이름: 추가 SQL · SQL INSERT
Schema와 Constraint에 맞는 새 Row를 Table에 추가하는 SQL 문장입니다.
SQL 문장
다른 이름: 수정 SQL · SQL UPDATE
조건에 맞는 기존 Row의 Column 값을 원자적인 한 SQL 실행으로 바꾸는 문장입니다.
SQL 문장
다른 이름: 삭제 SQL · SQL DELETE
조건에 맞는 기존 Row를 Table에서 제거하고 연결 관계와 보존 정책의 영향을 받는 SQL 문장입니다.
SQL 연산
다른 이름: 조인 · 관계 결합 · SQL JOIN
키와 조건을 기준으로 둘 이상의 Table Row를 한 조회 결과로 결합하는 SQL 연산입니다.
SQL 문장 구조
다른 이름: 매개변수화 질의 · SQL Parameterized Query
신뢰하지 않는 값을 SQL 문자열에 직접 넣지 않고 값 자리표시자를 둔 질의 문장입니다. 자리표시자 모양과 지원 범위는 데이터베이스 연결 구현에 따라 다릅니다.
SQL 값 전달
다른 이름: 매개변수 바인딩 · SQL Parameter Binding
Parameterized Query의 자리표시자에 실제 값을 연결해 데이터베이스 연결 구현이 SQL 구조가 아닌 값으로 전달하게 하는 동작입니다.
다른 이름: SQL 삽입 · SQL Injection
신뢰하지 않는 입력이 SQL 문장 구조로 이어져 공격자가 의도하지 않은 질의나 변경을 실행하게 하는 취약점입니다.
데이터 도구
다른 이름: 객체 관계 매핑 · Object-Relational Mapping
애플리케이션 객체와 관계형 Table 사이 변환과 질의·Transaction 작성을 돕는 라이브러리 또는 방식입니다.
데이터 통신
다른 이름: Connection · DB 연결 · Database Connection
애플리케이션과 데이터베이스가 인증된 세션에서 SQL과 결과를 주고받는 대화 채널입니다.
자원 관리
다른 이름: DB Pool · DB 연결 풀 · Database Connection Pool
만드는 비용이 큰 DB Connection을 제한된 수로 준비해 요청이 빌리고 반드시 반환하게 하는 관리 구조입니다.
데이터 작업
다른 이름: 트랜잭션 · 업무 원자 단위 · Database Transaction
여러 읽기와 쓰기를 한 업무 경계로 묶어 모두 반영하거나 모두 취소하고 동시 실행의 관찰 규칙을 정하는 작업입니다.
Transaction 명령
다른 이름: Transaction 시작 · Transaction BEGIN
이후 SQL 변경을 같은 Transaction 경계에서 처리하도록 시작하는 명령입니다.
Transaction 명령
다른 이름: DB 커밋 · Transaction COMMIT
Transaction 안에서 성공한 변경을 데이터베이스의 지속 상태로 확정하는 명령입니다. 맥락 없는 Commit은 Git 기록을 뜻할 수도 있으므로 DB COMMIT으로 구분합니다.
Transaction 명령
다른 이름: ROLLBACK · DB 롤백 · Transaction ROLLBACK
DB COMMIT으로 확정하지 않은 현재 Transaction의 데이터 변경을 취소하고 이전 지속 상태로 돌리는 명령입니다.
Transaction 원칙
다른 이름: 트랜잭션 네 성질 · ACID Transaction Properties
Transaction이 원자성(Atomicity)·일관성(Consistency)·격리성(Isolation)·지속성(Durability)을 지향한다는 네 성질의 약자입니다.
Transaction 성질
다른 이름: Atomicity · Transaction Atomicity
Transaction의 여러 변경이 전부 반영되거나 전부 취소되어 부분 결과가 남지 않는 성질입니다.
Transaction 성질
다른 이름: Consistency · Transaction Consistency
Transaction 전후에 애플리케이션과 Schema에 명시한 Constraint·업무 불변식을 만족하는 상태를 유지하는 성질입니다.
Transaction 성질
다른 이름: Isolation · Transaction Isolation
동시에 실행되는 Transaction이 서로의 중간 변경을 보는 범위와 충돌 행동을 정하는 성질입니다.
Transaction 성질
다른 이름: Durability · Transaction Durability
DB 커밋으로 확정된 결과가 프로세스나 시스템 장애 뒤에도 복구 가능한 형태로 남는 성질입니다.
동시성 제어
다른 이름: Lock · 잠금 · Database Lock
동시에 실행되는 Transaction이 같은 데이터에 충돌하는 변경을 하지 못하도록 접근을 기다리게 하거나 제한하는 장치입니다.
동시성 실패
다른 이름: 교착 상태 · 교착 · Database Deadlock
둘 이상의 Transaction이 서로 보유한 Lock을 기다려 누구도 진행할 수 없는 순환 대기 상태입니다.
데이터 규칙
다른 이름: Constraint · 제약 조건 · Database Constraint
어떤 코드 경로에서도 데이터베이스에 허용되지 않은 최종 상태가 저장되지 않도록 강제하는 규칙입니다.
입력 규칙
다른 이름: API 입력 검증 · API Input Validation
외부 API 입력의 형식·범위·필수값을 업무 처리 전에 검사하고 안전한 오류로 돌려주는 경계입니다. 화면·도메인·파일의 모든 Validation을 뜻하는 상위어는 아닙니다.
데이터 제약
다른 이름: 필수값 제약 · NOT NULL Constraint
정한 Column에 값 없음인 NULL이 저장되지 않도록 강제하는 Constraint입니다.
SQL 값
다른 이름: SQL 값 없음 · SQL 미정 값 · SQL NULL
Column의 값이 없거나 아직 알려지지 않았음을 나타내는 SQL의 특별한 값 표지로, 자료형 자체가 아니며 빈 문자열이나 숫자 0과도 같지 않습니다.
데이터 제약
다른 이름: 검사 제약 · CHECK Constraint
한 Row의 값이 제목 길이 1~80자 같은 조건을 만족할 때만 저장되게 하는 Constraint입니다.
중의적 기술 용어
다른 이름: 인덱스 · Context-dependent Index Term
빠른 찾기용 자료구조, 다음 Git Commit 준비 공간, 검색 사본처럼 문맥마다 서로 다른 대상을 가리키는 기술 용어입니다. 공통 철자만으로 같은 개념이라고 묶지 않습니다.
데이터 구조
다른 이름: 데이터베이스 인덱스 · Database Index
특정 Column 값과 Row 위치를 검색에 유리한 구조로 보관해 모든 Row를 훑는 비용을 줄이는 데이터 구조입니다.
DB 구성 요소
다른 이름: 질의 계획기 · Database Query Planner
통계와 비용 추정을 사용해 SQL을 어떤 Table Scan·Index Search·JOIN·정렬 순서로 실행할지 선택하는 데이터베이스 구성 요소입니다.
실행 경로
다른 이름: 실행 계획 · 질의 계획 · Database Query Plan
데이터베이스가 한 SQL을 실행하기 위해 선택한 Table Scan·Index Search·JOIN·정렬의 순서와 비용 추정입니다.
Query 접근 경로
다른 이름: 전체 행 탐색 · Database Table Scan
조건에 맞는 Row를 찾기 위해 Table의 넓은 범위를 차례로 읽는 Query Plan 접근 경로입니다. SQLite 실행 계획의 SCAN 표시는 이 접근 경로를 보고하는 제품별 출력 예입니다.
SQLite EXPLAIN QUERY PLAN의 SCAN 출력
Query 접근 경로
다른 이름: 인덱스 탐색 · Database Index Search
조건과 맞는 DB Index의 키 범위에서 시작해 필요한 Row 위치를 찾는 Query Plan 접근 경로입니다. SQLite 실행 계획의 SEARCH 표시는 이 접근 경로를 보고하는 제품별 출력 예입니다.
SQLite EXPLAIN QUERY PLAN의 SEARCH 출력
DB 진단
다른 이름: 실행 계획 보기 · SQL EXPLAIN
SQL을 어떻게 실행할지 Query Plan과 추정 비용·Row 수로 보여 주는 데이터베이스 진단 명령입니다.
DB 진단
다른 이름: 실제 실행 계획 측정 · SQL EXPLAIN with ANALYZE
SQL을 실제로 실행해 실행 계획의 추정값 옆에 실제 Row 수와 시간을 측정해 보여 주는 진단 방식입니다.
상태 사본
다른 이름: 시점 사본 · Point-in-time Snapshot
대상의 한 시점 상태를 나중에 비교하거나 재구성할 수 있도록 고정한 사본 또는 기준점입니다. 같은 저장 장치의 시점 사본만으로 독립된 재해 복구 사본이 되지는 않습니다.
복구
다른 이름: 백업 · 복구 사본 · Database Backup
데이터베이스 파일이나 논리 데이터를 원본과 다른 장애 경계에 특정 시점 사본으로 보관하는 작업과 결과입니다.
복구
다른 이름: 복원 · 복구 실행 · Database Restore
Backup을 새 데이터베이스 환경에 적용하고 Schema·행·핵심 업무 검증을 통과시켜 사용 가능한 상태로 되살리는 과정입니다.
복구 목표
다른 이름: 복구 시점 목표 · Recovery Point Objective
장애 복구에서 얼마 전 시점까지의 데이터 손실을 감수할지 정한 시간 목표입니다.
복구 목표
다른 이름: 복구 시간 목표 · Recovery Time Objective
장애 시작 뒤 서비스를 사용 가능한 상태로 되살리기까지 허용할 목표 시간입니다.
데이터베이스 제품
다른 이름: Postgres · PostgreSQL
별도 서버 프로세스가 여러 연결을 받아 SQL·Transaction·Constraint·Index와 운영 복구 기능을 제공하는 오픈소스 서버형 관계형 데이터베이스 제품입니다.
데이터베이스 제품
다른 이름: SQLite
별도 서버 프로세스 없이 한 파일에서 SQL·Transaction·Constraint를 제공하는 내장형 파일 기반 관계형 데이터베이스 제품입니다.
버전 관리 도구
다른 이름: Git
파일 변경을 커밋 그래프로 로컬에 기록하고 비교·분기·결합·복구하는 분산 버전 관리 도구입니다. 분산 버전 관리는 Git이 속한 도구 유형이지 Git의 다른 이름은 아닙니다.
협업 서비스
다른 이름: GitHub
Git Repository를 원격에 보관하고 Pull Request·Review·권한·자동 검사를 제공하는 협업 서비스 제품입니다. Git 호스팅 서비스는 GitHub가 속한 제품 유형입니다.
버전 관리 저장소
다른 이름: Git 저장소 · Repo · Git Repository
Git이 파일 시점 기준점·Git Commit·Git Branch·Git Tag와 그 관계 이력을 보관하는 작업 공간입니다. 맥락 없는 Repository나 저장소는 데이터 접근 계층이나 일반 Storage도 뜻할 수 있습니다.
Git 공간
다른 이름: 작업 트리 · Git Working Tree
현재 Checkout한 기준에서 사용자가 실제로 편집하고 실행하는 파일 상태입니다. 편집 파일은 Working Tree 안의 한 파일일 뿐 공간 전체의 다른 이름은 아닙니다.
Git 공간
다른 이름: Git Staging Area · Git 스테이지 · Git Index
Working Tree 변경 중 다음 Git Commit에 포함할 내용만 선택해 준비하는 Git의 중간 상태입니다.
Git 명령
다른 이름: Diff · 변경 비교 · Git Diff
두 파일 상태나 커밋 사이에 어떤 줄과 내용이 달라졌는지 비교해 보여 주는 Git 기능입니다.
Git 명령
다른 이름: 상태 확인 · Git Status
현재 Branch와 Working Tree·Git Index의 변경 상태를 요약해 보여 주는 Git 기능입니다.
버전 기록
다른 이름: Git 커밋 · Git Commit
선택한 파일 Snapshot과 부모 Git Commit·작성 정보·메시지를 가진 식별 가능한 불변 Git 기록입니다. 맥락 없는 Commit은 DB Transaction 확정 명령과 혼동될 수 있습니다.
버전 기록
다른 이름: Git 파일 상태 기준점 · Git File Snapshot
특정 Git Commit이 가리키며 프로젝트 파일 전체 상태를 재현할 수 있는 내용 집합입니다.
버전 포인터
다른 이름: Branch · 브랜치 · Git Branch
특정 커밋을 가리키며 그 Branch 위에 새 커밋을 만들면 자동으로 앞으로 이동하는 가벼운 Git 이름입니다.
main · change/environment-policy
버전 결합
다른 이름: Merge · 병합 · Git Merge
공통 부모 뒤에서 갈라진 변경을 이해해 하나의 검증된 Git 역사로 잇는 작업입니다.
버전 충돌
다른 이름: Conflict · 병합 충돌 · Merge Conflict
공통 부모 뒤의 변경이 같은 부분에 다른 의도를 만들어 Git이 최종 결과를 자동 결정할 수 없는 상태입니다.
다른 이름: PR · 변경 제안 · Pull Request
어떤 문제를 왜 풀었고 무엇을 바꾸며 어떻게 검증·배포·복구할지 팀에 검토 요청하는 변경 제안입니다.
협업 검증
다른 이름: 코드 리뷰 · Review · Code Review
변경의 요구 충족·이해 가능성·보안·데이터·실패·복구 위험을 다른 사람이 근거와 함께 검토하는 활동입니다.
자동화
다른 이름: 지속적 통합 · Continuous Integration
변경이 공유될 때 깨끗한 환경에서 정한 검사·테스트·빌드를 반복 실행해 통합 문제를 빠르게 알리는 방식입니다.
자동화 정의
다른 이름: Workflow · 자동화 흐름 · Continuous Integration Workflow
어떤 사건에 어떤 CI Job을 어떤 순서와 권한으로 실행할지 코드로 정의한 자동화 흐름입니다.
자동화 단위
다른 이름: CI Workflow Job · CI 자동화 Job · Continuous Integration Job
CI Workflow 안에서 한 CI Runner 환경에 배정되어 여러 Step을 순서대로 실행하는 작업 단위입니다. 맥락 없는 Job은 제품의 비동기 작업도 뜻할 수 있습니다.
자동화 실행
다른 이름: CI 실행기 · CI 실행 환경 · Continuous Integration Runner
CI Job을 배정받아 소스 코드를 가져오고 명령을 실행한 뒤 결과와 Log를 돌려주는 실행 주체 또는 환경입니다. 작업 사이 격리·초기화·폐기 수준은 공급자가 관리하는 실행 환경인지 팀이 직접 관리하는 실행 환경인지와 구성 정책에 따라 다릅니다.
자동 검증
다른 이름: Checks · 필수 검사 · Quality Check
Lint·Type Check·Test·Build처럼 변경을 합치거나 전달하기 전에 통과해야 하는 반복 가능한 검사입니다.
자동 검증
다른 이름: 린트 · 정적 규칙 검사 · Static Lint Check
코드를 실행하지 않고 문법·스타일·위험 패턴과 프로젝트 규칙 위반을 찾는 정적 검사입니다.
재현성 파일
다른 이름: 의존성 잠금 파일 · Dependency Lockfile
직접·간접 의존성의 정확한 버전과 무결성 정보를 기록해 설치 결과를 재현하게 하는 파일입니다.
버전 포인터
다른 이름: Tag · 태그 · Git Tag
특정 Git 객체, 보통 Git Commit에 버전이나 사건 이름을 붙이는 참조입니다. 새 Git Commit에 따라 자동 이동하지 않고 관례상 안정적으로 유지하지만 기술적으로 강제 교체하거나 삭제할 수 있습니다.
Git 동기화
다른 이름: Git 원격 전송 · Git Push
로컬 Git Commit과 참조를 원격 Git Repository에 보내 팀과 자동화가 볼 수 있게 하는 작업입니다.
버전 복구
다른 이름: Git 되돌림 Commit · Git Revert
과거 Git Commit을 삭제하지 않고 그 효과를 반대로 적용하는 새 Git Commit을 만들어 공유 이력을 보존하는 복구입니다.
위험한 버전 작업
다른 이름: 강제 Push · Git Force Push
원격 Git Branch가 가리키는 이력을 일반 Fast-forward 조건 없이 강제로 다른 커밋으로 바꾸는 방식입니다. --force와 --force-with-lease는 이를 요청하는 서로 다른 안전 조건의 옵션입니다.
--force · --force-with-lease
보안 판단
다른 이름: 신원 확인 · AuthN · Authentication
요청 주체가 자신이 주장하는 사용자나 서비스가 맞는지 credential로 확인하는 과정입니다.
보안 판단
다른 이름: 권한 판정 · AuthZ · Authorization
확인된 주체의 역할·소속·자원 소유권·현재 상태를 보고 특정 행동을 허용할지 판정하는 과정입니다.
보안 정보
다른 이름: 주체 정보 · Identity
인증 결과로 확인한 사용자나 서비스의 안정적인 식별 정보입니다.
보안 증명
다른 이름: 자격 증명 · 신원 증명 · Credential
비밀번호·일회용 코드·키·토큰처럼 신원이나 허용된 권한을 증명하기 위해 제출하는 정보입니다.
인증 시스템
다른 이름: IdP · 신원 공급자 · Identity Provider
사용자의 Credential을 검증하고 그 결과로 서비스가 확인할 신원 정보나 인증 토큰을 발급하는 시스템입니다. 외부 로그인 공급자는 우리 서비스 밖에 둔 IdP의 한 배치 형태입니다.
외부 로그인 공급자
중의적 기술 용어
다른 이름: 토큰 · Context-dependent Token Term
권한 증명·전달 주소·다음 페이지 위치·텍스트 단위처럼 어떤 대상을 대신하는 값을 여러 문맥에서 부르는 말입니다. 같은 철자만 보고 비밀 여부·수명·용도를 같다고 가정하지 않습니다.
보안 증명
다른 이름: 인증 토큰 · Authentication Token
인증 결과와 제한된 사용 조건을 다음 요청에 전달하도록 발급한 값입니다. 토큰은 인증 외에도 기기 주소·페이지 이동·요청 의도 등 여러 값을 뜻하므로 문맥을 붙여 구분합니다.
인증 상태
다른 이름: 로그인 세션 · 인증 세션 · Authentication Session
서버가 로그인 상태를 보관하고 클라이언트가 임의의 Session ID로 그 상태를 가리키는 인증 방식입니다. 서버에 보관하는 상태에는 장바구니 같은 비인증 정보도 있을 수 있으므로 모든 서버 측 Session이 인증 Session인 것은 아닙니다.
인증 식별자
다른 이름: 세션 식별자 · Session Identifier
브라우저가 서버에 저장된 인증 세션을 찾도록 보내는 추측하기 어려운 임의 식별값입니다.
브라우저 저장·전송
다른 이름: HTTP 쿠키 · HTTP Cookie
브라우저가 이름과 값을 저장하고 Domain·Path·보안 조건에 맞는 HTTP 요청에 자동으로 보내는 브라우저 상태 전달 방식입니다.
Cookie 수명
다른 이름: Browser Session Cookie · 브라우저 세션 쿠키 · HTTP Session Cookie
Cookie Expires와 Cookie Max-Age로 지속 수명을 지정하지 않아 사용자 에이전트가 현재 브라우징 세션이 끝날 때까지 보관하는 Cookie입니다. 인증 정보가 아닌 값도 담을 수 있고, 브라우징 세션 종료 시점은 사용자 에이전트가 정합니다.
인증 전달
다른 이름: Session ID Cookie · 인증 세션 쿠키 · Authentication Session-ID Cookie
서버의 인증 Session을 찾는 임의 Session ID를 브라우저 Cookie에 담아 자동 전송하는 구성입니다. Cookie 수명 설정에 따라 브라우저 세션용일 수도 지속형일 수도 있습니다.
Cookie 수명 속성
다른 이름: Cookie Expires 속성 · Cookie Expires Attribute
Cookie가 더 이상 유지되지 않아야 할 최대 수명을 절대 날짜와 시각으로 나타내는 Set-Cookie Header 속성입니다. 사용자 에이전트는 저장 한도·개인정보 정책 등으로 그 시각보다 먼저 Cookie를 버릴 수 있습니다.
Expires=Wed, 09 Jun 2027 10:18:14 GMT
Cookie 수명 속성
다른 이름: Cookie Max-Age 속성 · Cookie Max-Age Attribute
Cookie가 더 이상 유지되지 않아야 할 최대 수명을 수신 시점부터의 초 수로 나타내는 Set-Cookie Header 속성입니다. 0 이하 값은 즉시 만료시키며, 사용자 에이전트는 저장 한도·개인정보 정책 등으로 더 일찍 버릴 수 있습니다.
Max-Age=3600 · Max-Age=0
인증 전달
다른 이름: 서명 토큰 · Cryptographically Integrity-protected Token
발급자가 검증할 주장과 암호학적 검증값을 함께 만들어 수신자가 내용의 위조·변경 여부를 확인할 수 있게 한 Token입니다. 비대칭 키 방식과 공유 비밀 방식은 검증 주체와 발급 주체의 관계가 다르므로 구체 알고리즘과 키 소유 계약을 확인해야 합니다.
인증 전달
다른 이름: 소지자 토큰 · Bearer Token
그 값을 가진 호출자가 별도 소유 증명 없이 사용할 수 있으므로 노출 자체가 권한 탈취가 되는 Token입니다. Bearer는 Token의 소지 여부를 사용 권한으로 인정하는 방식이지 인증 과정 전체의 다른 이름은 아닙니다.
HTTP 인증 전달
다른 이름: Authorization 헤더 · HTTP Authorization Header
클라이언트가 서버에 인증 방식을 밝히고 Bearer Token 같은 credential을 전달하는 HTTP Header입니다.
토큰 Claim 형식
다른 이름: JSON 웹 토큰 · JSON Web Token
주체와 사용 조건에 관한 JWT Claim 묶음을 JWS로 무결성 보호하거나 JWE로 암호화해 전달하는 표준 표현입니다. JWT라는 이름만으로 서명·MAC·암호화 중 어떤 보호를 적용했는지는 알 수 없습니다.
무결성 보호 형식
다른 이름: JSON Web Signature
보호할 내용과 보호용 머리 정보를 Digital Signature 또는 MAC으로 무결성 보호해 전달하는 표준 표현입니다. 내용을 숨기는 암호화 형식은 아니며, 이 강의의 Compact Serialization은 점으로 나뉜 세 부분을 사용합니다.
토큰 구성
다른 이름: JWT 헤더 · JSON Web Token Header
이 강의에서 다루는 세 부분짜리 JWS 보호 JWT에서 Token 종류와 서명·MAC 알고리즘 같은 검증 정보를 담는 첫 번째 부분입니다.
토큰 구성
다른 이름: JWT 페이로드 · JSON Web Token Payload
이 강의에서 다루는 세 부분짜리 JWS 보호 JWT가 전달할 주체·발급자·대상·만료 같은 JWT Claim을 담는 두 번째 부분입니다.
토큰 데이터
다른 이름: JWT 클레임 · 토큰 주장 · JSON Web Token Claim
발급자가 JWT Payload에 기록하는 주체나 사용 조건에 관한 주장입니다. JWS 보호 JWT에서는 JWS Signature 검증이 Claim의 무결성을 확인하지만 Base64URL을 풀어 읽기만 한 값은 아직 신뢰할 Identity가 아닙니다.
Token 무결성 값
다른 이름: JWS 서명 값 · JWS Signature Value
JWS의 보호 입력과 허용한 alg로 계산해 Compact Serialization의 세 번째 부분에 넣는 암호학적 검증값입니다. alg에 따라 비대칭 Digital Signature나 공유 비밀 기반 MAC으로 만들 수 있습니다.
암호 기술
다른 이름: 디지털 서명 · Digital Signature
비공개 서명 키 보유자가 데이터의 서명값을 만들고, 미리 신뢰한 대응 공개 키로 그 키 보유 사실과 서명 이후 데이터가 바뀌지 않았음을 검증하는 비대칭 암호 기술입니다. 공개 키를 특정 주체와 연결하려면 인증서·공개 키 고정·신뢰 설정 같은 별도 신뢰 근거가 필요하며 서명 대상 내용을 숨기지는 않습니다.
암호 기술
다른 이름: 메시지 인증 코드 · Message Authentication Code
공유 비밀 키로 데이터의 무결성과 그 비밀 보유자가 만든 값임을 검증하는 암호학적 코드입니다. 생성자와 검증자가 같은 비밀을 가져 검증자도 유효한 MAC을 만들 수 있습니다.
인코딩
다른 이름: Base64URL 인코딩 · Base64 URL Encoding
바이트를 URL에 쓰기 쉬운 문자로 바꾸는 가역 표현 방식입니다.
암호 기술
다른 이름: Encryption · 암호문 변환
허가된 키를 가진 주체만 원래 내용을 읽을 수 있도록 데이터를 변환하는 기술입니다.
토큰 Claim
다른 이름: JWT 발급자 Claim · JSON Web Token Issuer Claim
어느 신뢰한 주체가 JWT를 발급했는지 나타내는 Claim입니다. iss는 이 Claim을 담는 표준 이름입니다.
iss
API 인가 자격 증명
다른 이름: 접근 토큰 · API Access Token
보호된 API 자원에 허용된 범위로 접근하도록 서버에 제출하는 자격 증명입니다. 사용자와 연결된 주체 속성을 담을 수 있지만 Access Token 자체가 사용자 신원을 증명하는 ID Token은 아닙니다.
인증 토큰
다른 이름: 갱신 토큰 · Refresh Token
사용자에게 다시 로그인시키지 않고 새 Access Token을 발급받도록 더 오래 보관하는 고위험 토큰입니다.
토큰 보호
다른 이름: 갱신 Token 회전 · Refresh Token Rotation
Refresh Token을 사용할 때마다 이전 값을 폐기하고 새 값을 발급해 탈취된 값의 재사용을 탐지하는 방식입니다. Rotation만으로 부르면 Secret이나 인증서의 주기적 교체와 혼동될 수 있습니다.
비밀번호 저장
다른 이름: 비밀번호 해시 · Password Hash
원문 비밀번호 대신 비밀번호 전용 단방향 함수의 결과를 저장해 로그인 때 후보와 비교하는 값입니다. 파일 무결성 등에 쓰는 빠른 내용 해시와는 목적과 필요한 계산 비용이 다릅니다.
인증 방식
다른 이름: Multi-Factor · 다중 인증 · 다요소 인증 · Multi-Factor Authentication
서로 다른 종류의 증명 요소를 둘 이상 확인해 하나의 Credential 탈취만으로 로그인하지 못하게 하는 방식입니다.
Cookie 보호
다른 이름: Cookie Secure 속성 · Cookie Secure Attribute
브라우저가 Cookie를 HTTPS 연결에서만 전송하도록 제한하는 Cookie 속성입니다. 별도의 Cookie 종류가 아니라 Set-Cookie에 붙이는 전송 조건입니다.
Secure
Cookie 보호
다른 이름: Cookie HttpOnly 속성 · Cookie HttpOnly Attribute
브라우저 JavaScript가 Cookie 값을 직접 읽지 못하도록 제한하는 Cookie 속성입니다. 별도의 Cookie 종류가 아니라 Set-Cookie에 붙이는 접근 조건입니다.
HttpOnly
Cookie 보호
다른 이름: Cookie SameSite 속성 · Cookie SameSite Attribute
다른 Browser Site에서 시작된 요청에 Cookie를 보낼 조건을 제한하는 Cookie 속성입니다. 별도의 Cookie 종류가 아니라 Set-Cookie Header에 붙이는 교차 Browser Site 전송 조건입니다.
SameSite
웹 공격
다른 이름: 교차 사이트 요청 위조 · Cross-Site Request Forgery
공격 사이트가 사용자의 브라우저에 저장된 인증 정보를 자동 전송시켜 원치 않는 요청을 실행하게 하는 공격입니다.
요청 의도 증명
다른 이름: 요청 위조 방지 Token · Anti-CSRF Token · Cross-Site Request Forgery Token
서버가 허용한 사용자 흐름에 연결해 발급하고 상태 변경 요청에서 다시 확인하는 예측하기 어려운 값입니다.
보안 경계
다른 이름: 인증 가드 · 인증 Guard · Authentication Guard
보호된 요청에서 Credential의 형식·암호학적 검증값·발급자·대상·만료 같은 사용 조건과 필요한 사용자 상태를 공통 진입점에서 검사하는 구성 요소 역할입니다. Credential이 불투명한 임의 값인지 JWS인지에 따라 실제 검증 절차는 달라집니다. Framework에 따라 Filter나 Dependency로 구현할 수 있지만 모든 Guard·Filter·Dependency가 인증 경계인 것은 아닙니다.
보안 Filter · 인증 Dependency
보안 규칙
다른 이름: 권한 정책 · Authorization Policy
어떤 주체가 어떤 조건에서 어느 자원에 어떤 행동을 할 수 있는지 표현한 판정 규칙입니다. Policy만으로 부르면 보존·Retry·개인정보 같은 다른 정책과 구분되지 않습니다.
인가 속성
다른 이름: 역할 · 권한 역할 · Role
직원·회원·관리자처럼 주체가 수행할 수 있는 행동의 큰 범주를 나타내는 속성입니다.
데이터 경계
다른 이름: 조직 경계 · 테넌트 · Tenant
여러 조직이 한 시스템을 사용할 때 데이터·설정·권한을 논리적으로 분리하는 고객 조직 단위입니다.
인가 관계
다른 이름: 자원 소유자 · Resource Owner
특정 주문·문서·대출 같은 업무 Resource를 소유하거나 관리할 권리가 있는 주체입니다. 단순히 소유자라고만 부르면 Process·팀·Git Repository 등 무엇의 소유자인지 알 수 없습니다.
인가 검사
다른 이름: 자원 소유권 검사 · Resource Ownership Check
요청 주체와 실제 조회한 자원의 Resource Owner 또는 허용된 조직 관계가 일치하는지 서버에서 확인하는 검사입니다.
보안 원칙
다른 이름: Least Privilege · Principle of Least Privilege
주체에게 필요한 자원·행동·기간만 허용하고 나머지는 기본 거절하는 원칙입니다.
인가 취약점
다른 이름: 불안전한 직접 객체 참조 · Insecure Direct Object Reference
사용자가 전달한 객체 식별자를 서버가 소유권 검사 없이 믿어 다른 주체의 자원에 접근하게 되는 취약점입니다.
보안 기록
다른 이름: 감사 기록 · Audit Trail · Audit Log
누가 언제 어떤 근거로 민감한 자원이나 상태를 조회·변경했는지 변경 불가능하게 추적하는 기록입니다.
시스템 경계
다른 이름: External Dependency
가격·정책·한도·장애를 우리 조직이 직접 통제하지 못하는 네트워크 기능이나 운영 자원입니다. 외부 연동은 이 대상과 연결하는 관계·작업이고 의존 대상 자체의 다른 이름은 아닙니다.
코드 의존성
다른 이름: 라이브러리 · 코드 라이브러리 · Software Library
우리 프로그램 프로세스 안에서 호출되어 재사용 기능을 제공하는 코드 묶음입니다.
네트워크 서비스
다른 이름: 사내 서비스 · Internal Service
같은 조직이 소유·운영하지만 호출 프로그램과 별도 프로세스에서 네트워크로 기능을 제공하는 서비스입니다.
네트워크 서비스
다른 이름: 외부서비스 · Third-party Service · External Service
다른 조직이 운영하며 API·Webhook·SDK 같은 경계로 기능을 제공하는 서비스입니다.
중의적 기술 용어
다른 이름: Provider · Capability Provider
기능·자원·외부 효과를 제공하고 그 계약이나 상태에 책임을 지는 주체를 가리키는 넓은 말입니다. 조직 경계나 제공 능력을 함께 붙여야 실제 책임 범위를 알 수 있습니다.
외부 주체
다른 이름: 외부 공급자 · 외부 벤더 · External Service Provider
외부 Service의 기능·API·운영 정책과 장애 신호에 책임을 지는 조직입니다. Service는 네트워크로 제공되는 기능이고 Provider는 그 Service를 소유·운영하는 주체입니다.
운영 모델
다른 이름: 자가 호스팅 · 직접 운영 제품 · Self-hosted Software
다른 주체가 만든 소프트웨어를 우리 조직의 실행 환경에 설치하고 직접 운영하는 모델입니다.
운영 모델
다른 이름: 관리형 SaaS · 서비스형 소프트웨어 · Software as a Service
공급자가 소프트웨어와 실행 환경을 운영하고 사용자는 네트워크로 기능을 이용하는 제공 모델입니다.
연동 도구
다른 이름: 소프트웨어 개발 키트 · Software Development Kit
특정 플랫폼의 API를 쉽게 사용하도록 Library·형식·도구와 사용 규칙을 묶어 제공하는 개발 도구 모음입니다.
외부 연동 흐름
다른 이름: 외부 연동 Callback · 외부 연동 콜백 · External Integration Callback
이 강의의 외부 연동에서 시작 요청과 분리된 중간·완료 신호를 나중에 미리 정한 Application 코드나 Redirect URI로 돌려주는 호출 흐름입니다. 함수 인자를 나중에 실행하는 일반 프로그래밍 Callback 전체를 뜻하지 않습니다.
연동 흐름
다른 이름: HTTP Callback · 웹훅 · Webhook
외부 시스템에서 사건이 생겼을 때 그 시스템이 우리 공개 HTTP Endpoint로 요청을 보내 알려 주는 방식입니다.
연동 흐름
다른 이름: 주기 조회 · 폴링 · Polling
작업 결과나 상태가 바뀌었는지 호출자가 일정 간격으로 반복 조회하는 방식입니다.
외부 환경
다른 이름: 공급자 시험 공간 · 공급자 Sandbox · Provider Sandbox
공급자가 실제 과금·발송 같은 효과 없이 제한된 연동을 시험하도록 제공하는 모의 Environment입니다. 강의에서 말하는 Sandbox는 우리 Test Environment 안에 속한 공간이 아니라 별도 소유 경계입니다.
공개 식별·제한 키
다른 이름: 공개용 연동 키 · Publishable Key
브라우저나 App에 노출될 것을 전제로 허용된 웹 출처·App·기능·한도를 제한해 발급한 공개 가능한 연동 값입니다. 외부 공급자마다 키 이름이 다르므로 공개 가능 여부를 이름만으로 판단하지 않고 공식 계약을 확인합니다.
외부 Credential
다른 이름: API Secret · 비밀 API 키 · Secret API Key
외부 API에서 계정이나 서비스의 권한을 증명하며 서버 비밀 저장소에서만 다뤄야 하는 값입니다.
기계 신원
다른 이름: 서비스 계정 · Service Account
사람 대신 Software Application이나 자동 Job이 외부 자원에 접근하도록 발급한 관리 대상 신원입니다. 모든 자동화 주체의 신원이 Service Account 형태인 것은 아닙니다.
외부 배치
다른 이름: 외부서비스 지역 · External Provider Region
외부 공급자가 요청 처리와 데이터 저장 자원을 운영하는 지리적 배치 단위입니다.
운영 원칙
다른 이름: 공유 책임 모델 · Shared Responsibility
공급자와 사용 조직이 기능·보안·데이터·가용성·복구에서 각자 맡을 행동과 증거를 나누는 원칙입니다.
아키텍처 경계
다른 이름: 어댑터 · 외부 연동 Adapter · Adapter
우리 업무 계약과 외부 API·SDK의 입력·출력·오류·상태를 서로 번역하는 경계 구현입니다.
상태 모델
다른 이름: 외부 Operation 상태 · External Operation State
외부 요청이 접수부터 최종 결과까지 어느 단계에 있는지 우리 업무 언어로 정규화한 상태입니다. Provider의 원본 상태값은 공급자 계약의 표현이고 외부 작업 상태는 여러 표현을 우리 판단 기준으로 번역한 모델입니다.
외부 작업 상태
다른 이름: 요청 기록됨 · External Operation Requested State
유효한 업무 의도와 멱등 키를 우리 저장소에 기록했지만 외부 접수는 아직 확인하지 못한 상태입니다.
외부 작업 상태
다른 이름: 접수됨 · External Operation Accepted State
공급자가 요청을 받아 추적 식별자를 주었지만 최종 업무 결과는 아직 정해지지 않은 상태입니다.
외부 작업 상태
다른 이름: 처리 중 · External Operation Processing State
공급자가 작업을 진행 중이며 Polling·External Integration Callback·Webhook 같은 완료 신호를 기다리는 상태입니다.
외부 작업 상태
다른 이름: 성공 확정 · External Operation Succeeded State
외부 결과가 우리 업무의 성공 조건을 충족했다고 증거로 확인한 최종 상태입니다.
외부 작업 상태
다른 이름: 실패 확정 · External Operation Failed State
외부 효과가 성공하지 않았거나 안전한 보상까지 끝났음을 증거로 확인한 최종 상태입니다.
외부 작업 상태
다른 이름: 결과 불명 · 결과 모름 · Unknown Outcome State
응답 유실이나 관측 단절 때문에 외부 효과가 성공했는지 실패했는지 아직 확정할 수 없는 상태입니다.
정합성 문제
다른 이름: 상태 불일치 · Provider Drift · State Drift
우리 저장소의 외부 작업 상태와 공급자가 소유한 현재 사실이 서로 달라진 상태입니다.
복구 과정
다른 이름: 상태 정합성 대조 · Reconciliation
공통 외부 ID로 Provider의 현재 사실과 우리 기록을 비교해 누락·중복·불일치를 갱신하거나 보상하는 복구 과정입니다. 단순 대조는 차이를 보는 데 그칠 수 있지만 Reconciliation은 차이를 분류하고 수렴시키는 행동까지 포함합니다.
실패 경계
다른 이름: 시간 초과 · 대기 제한 · Timeout
호출자가 정한 시간까지만 응답을 기다리고 더 늦은 결과와 무관하게 기다림을 끝내는 제한입니다.
복구 행동
다른 이름: 재시도 · Retry
일시적 실패로 분류한 같은 업무 의도를 정한 횟수와 시간 안에서 다시 수행하는 행동입니다.
재시도 정책
다른 이름: 지수 백오프 · Exponential Backoff
Retry할 때마다 대기 간격을 지수적으로 늘려 장애 중인 의존성에 가는 압력을 줄이는 대기 정책입니다. 고정·선형 대기 방식도 있으므로 모든 Retry 대기가 지수 Backoff인 것은 아닙니다.
재시도 정책
다른 이름: 재시도 분산 · Retry Jitter
여러 요청의 Retry 시각이 겹치지 않도록 대기 시간에 무작위 변화를 더하는 방식입니다. Jitter만 쓰면 Media 도착 시각의 원치 않는 흔들림도 뜻할 수 있습니다.
HTTP 제어
다른 이름: 재시도 대기 HTTP Header · HTTP Retry-After Header
서버가 제한이나 일시 장애 뒤 호출자가 언제 다시 요청할 수 있는지 알리는 HTTP Header입니다.
용량 정책
다른 이름: 사용 한도 · 쿼터 · Service Quota
공급자가 계정·기간·자원별로 허용하는 요청 수나 사용량의 상한입니다.
운영 계약
다른 이름: 공급자 SLA · 공급자 서비스 수준 협약 · Provider Service Level Agreement
외부 Provider가 가용성·응답·지원 같은 Service 수준과 측정·보상 조건을 약속한 계약입니다. SLA만으로 부르면 우리 제품이 고객에게 약속한 Product SLA와 구분되지 않습니다.
회복 패턴
다른 이름: 회로 차단기 · Circuit Breaker
외부 실패가 임계치를 넘으면 호출을 잠시 막고 제한된 복구 확인으로 재개 여부를 판단하는 패턴입니다.
회복 전략
다른 이름: 기능 저하 모드 · Degraded Mode
부가 의존성이 실패해도 핵심 흐름을 유지하도록 일부 기능을 숨기거나 보관한 결과·기본값으로 제한해 운영하는 상태입니다. Degraded는 단순히 성능이나 상태가 나빠졌다는 형용사일 수도 있어 축소 운영과 같은 이름으로 쓰지 않습니다.
실패 정책
다른 이름: 안전 차단 · Fail-closed
검증이나 의존성이 실패했을 때 잘못 허용하는 피해를 피하려고 해당 행동을 기본 거절하는 정책입니다.
실패 정책
다른 이름: 장애 시 허용 · Fail-open
검증이나 의존성이 실패해도 가용성을 위해 제한된 행동을 허용하는 명시적 위험 결정입니다.
회복 전략
다른 이름: 대체 동작 · 대체 경로 · Fallback
주 경로나 의존성이 실패할 때 미리 정한 더 단순한 결과나 다른 경로를 제공하는 동작입니다.
메시지 식별자
다른 이름: 사건 식별자 · Event Identifier
같은 외부 사건의 중복 전달을 식별하도록 공급자나 우리 시스템이 부여한 안정적인 값입니다.
전달 확인
다른 이름: Webhook 확인 응답 · Webhook Acknowledgement
Webhook 수신자가 필요한 최소 사건을 안전하게 저장한 뒤 공급자에게 성공 HTTP 응답으로 접수를 알리는 동작입니다.
데이터 제약
다른 이름: 데이터 지역 요구 · 데이터 저장·처리 지역 요구 · Data Residency
데이터를 저장하거나 처리할 수 있는 물리적·법적 지역을 정하는 Requirement입니다. 단순한 현재 저장 위치가 아니라 Backup·Log·하위 처리자까지 허용 범위를 판정하는 규정·계약상 제약입니다.
업무 객체
다른 이름: 주문 · Purchase Order
사용자가 어떤 상품을 어떤 가격·통화·조건으로 구매하려는지 우리 서비스가 소유하는 업무 기록입니다.
금전 값
다른 이름: 결제 금액 · Payment Amount
구매 주문이 요구하고 공급자에 전달·대조할 돈의 크기입니다. 화면 입력값이 아니라 서버가 계산한 구매 주문이 원본입니다.
금전 단위
다른 이름: 통화 · Payment Currency
금액이 어느 화폐 체계와 단위로 표시되는지 정하는 돈의 종류입니다. 숫자가 같아도 Currency가 다르면 같은 돈이 아닙니다.
대한민국 원 · 미국 달러
금전 식별 코드
다른 이름: 통화 코드 · 화폐 코드 · Payment Currency Code
결제 API와 저장소에서 Currency를 식별하기 위해 사용하는 표준화된 문자 코드 값입니다. KRW는 대한민국 원을 가리키는 구체 코드이며 Currency 개념 전체의 다른 이름은 아닙니다.
KRW · USD
금액 표현 규칙
다른 이름: 최소 화폐 단위 · Currency Minor Unit
결제 API가 금액을 정수로 주고받을 때 사용하는 Currency의 가장 작은 단위입니다.
금전 작업
다른 이름: 결제 · Payment
주문 대가의 승인·취소·환불·정산을 외부 결제 공급자의 돈 장부에서 처리하는 작업과 기록입니다.
상태 원천
다른 이름: 공급자 장부 · 결제 장부 · Payment Provider Ledger
승인·취소·환불·수수료·정산 같은 금전 사실을 결제 공급자가 기록하는 원천입니다.
상태 원천
다른 이름: 주문·권리 장부 · 서비스 장부 · Business Ledger
주문 주체·상품·서버 계산 금액·상태와 제공할 이용 권리를 우리 서비스가 기록하는 원천입니다.
업무 식별자
다른 이름: 주문 ID · Purchase Identifier
우리 서비스의 한 구매 의도와 주문 기록을 안정적으로 식별하는 값입니다.
결제 생명주기
다른 이름: 결제 시도 · Payment Attempt
한 구매 주문의 돈 효과를 만들기 위해 시작한 개별 생명주기 기록입니다.
외부 식별자
다른 이름: 결제 ID · 외부 Payment ID · Payment Identifier
결제 공급자의 돈 장부에서 한 결제 작업과 현재 상태를 찾는 안정적인 식별값입니다.
금전 상태
다른 이름: 결제 승인 상태 · Payment Approval
결제 Provider가 금액·통화·결제 수단 조건을 확인해 돈 효과의 성공 사실을 자기 장부에 기록한 상태입니다. Approved는 공급자가 이 상태를 표현할 때 사용할 수 있는 값의 예입니다.
Approved
금전 상태
다른 이름: 승인 취소 · Payment Cancellation
결제 Provider가 이전 승인 효과를 확정 전 단계에서 되돌렸다고 기록하는 금전 작업입니다. 공급자 API의 취소 명령이나 상태값은 제품별 표현이므로 일반 취소 전체의 공통 이름으로 두지 않습니다.
업무 권리
다른 이름: 이용권 · 업무 권리 · Entitlement
결제나 계약 결과로 사용자가 얻게 되는 콘텐츠 접근·예약 확정·기능 사용 같은 제품 권리입니다.
결제 경계
다른 이름: 서버 결제 확인 · 서버 결제 Confirm · Server-side Payment Confirmation
Server가 Payment ID의 승인 사실과 구매 주문 소유자·금액·통화·중복을 직접 검증해 우리 구매 주문과 권리 장부에 반영하는 단계입니다. 문맥 없는 Server Confirm은 다른 업무 확인도 뜻할 수 있습니다.
금전 과정
다른 이름: 정산 · Payment Settlement
승인된 금액이 취소·환불·수수료 등을 반영해 실제 지급 장부와 맞춰지는 과정입니다.
금전 보상
다른 이름: Refund · Payment Refund
이미 생긴 결제 효과의 전부나 일부를 공급자의 별도 비동기 작업으로 사용자에게 돌려주는 행동입니다.
복구 행동
다른 이름: Compensation · 외부 보상 · Compensating Action
이미 확정되어 Rollback할 수 없는 외부 효과의 불일치를 반대 업무 효과로 해소하는 별도 행동입니다.
중의적 경로 용어
다른 이름: 채널 · Context-dependent Channel Term
정보·신호·미디어가 이동하는 논리적 경로나 매체를 여러 시스템 문맥에서 부르는 말입니다. 알림 전달망·실시간 데이터 통로·오디오 구성처럼 문맥마다 단위와 보장이 다릅니다.
제품 기능
다른 이름: 사용자 알림 · Notification
올바른 사용자에게 필요한 때 허용된 알림 전달 경로로 정보를 보내 기대 행동을 돕는 제품 기능입니다. 메시지 발송은 이 기능을 실행하는 한 행동이고, Email·SMS·푸시 알림은 외부 전달망을 빌릴 수 있지만 In-app 알림처럼 제품 안에서 제공할 수도 있습니다.
전달 경로
다른 이름: 전달 채널 · Notification Channel
Email 알림·SMS 알림·푸시 알림처럼 메시지가 사용자에게 도달하는 매체와 전달망의 종류입니다.
알림 채널
다른 이름: 이메일 알림 · Email · Email Notification
전자우편 주소로 길고 다시 찾을 수 있는 메시지를 보내는 알림 채널입니다.
알림 채널
다른 이름: 문자 알림 · SMS · Short Message Service Notification
전화번호로 앱 설치 없이 짧은 문자 메시지를 전달하는 유료 알림 채널입니다.
알림 채널
다른 이름: 푸시 알림 · Push Notification
Push Provider가 App 설치본의 Device Token으로 운영체제 알림을 전달하는 알림 Channel입니다. Push만으로 부르면 Git Push처럼 다른 원격 전송 작업과 혼동될 수 있습니다.
전달 주소
다른 이름: 기기 토큰 · Push Token · Push Device Token
Push 공급자가 특정 앱 설치본에 부여하며 재설치·기기 변경·정책에 따라 바뀌거나 폐기되는 임시 전달 주소입니다.
사용자 허가
다른 이름: 알림 수신 동의 · Notification Consent
사용자가 특정 목적과 Channel의 메시지를 받도록 허락한 현재 상태와 그 변경 이력입니다. Consent만으로 부르면 개인정보 수집·약관 동의 같은 다른 허가와 구분되지 않습니다.
사용자 설정
다른 이름: 수신 선호 · 채널 선호 · Notification Preference
사용자가 알림 종류·채널·시간대별로 원하는 전달 방식을 선택한 설정입니다.
알림 주소 상태
다른 이름: 발송 금지 목록 · Suppression List
수신 거부·영구 주소 오류·Spam Complaint 때문에 더 보내면 안 되는 목적지와 이유를 관리하는 목록입니다. 사용자 Consent 철회뿐 아니라 기술적·전달망 신호도 함께 반영합니다.
콘텐츠 구조
다른 이름: 알림 메시지 Template · Notification Template
알림의 제목·본문·버튼 구조를 알림 Channel·언어·개정본별로 관리하는 검증된 메시지 틀입니다. Template만으로 부르면 화면·문서·코드 생성 틀과 구분되지 않습니다.
콘텐츠 데이터
다른 이름: 알림 Template 변수 · Notification Template Variable
알림 Template의 허용된 위치에 발송마다 검증해 삽입하는 제한된 값입니다. 프로그램의 모든 변수가 알림 내용에 넣도록 허용된 값은 아닙니다.
Email 실패
다른 이름: 영구 반송 · Hard Bounce
존재하지 않는 주소처럼 다시 시도해도 해결되지 않는 영구적인 Email 전달 실패입니다.
Email 실패
다른 이름: 일시 반송 · Soft Bounce
메일함 용량이나 수신 서버의 일시 문제처럼 나중에 회복될 수 있는 Email 전달 실패입니다.
Email 사용자 신호
다른 이름: 스팸 신고 · Spam Complaint
수신자가 받은 Email을 원치 않는 Spam으로 신고했다는 전달망의 사용자 피드백입니다.
사용자 선택
다른 이름: 수신 거부 · Unsubscribe
사용자가 특정 목적이나 채널의 앞으로 올 메시지를 받지 않겠다고 선택하는 행동과 상태입니다.
실패 저장소
다른 이름: DLQ · 실패 격리 Queue · Dead Letter Queue
자동 Retry 정책을 끝낸 메시지를 원인과 본문 참조와 함께 격리해 조사와 선별 복구를 가능하게 하는 Queue입니다. 격리된 개별 메시지는 한 항목이고 DLQ는 그런 항목들을 보관하는 Queue입니다.
발송 정책
다른 이름: 알림 냉각 시간 · 발송 간격 제한 · Notification Cooldown
같은 사용자·사건·기간에 허용할 알림 횟수를 제한해 중복 사건과 버튼 연타의 폭주를 막는 정책입니다.
상태 모델
다른 이름: 알림 전달 상태 · Notification Delivery State
Provider의 전달 진행과 제품의 표시·읽음 증거를 섞지 않고 각각 기록해 알림에서 무엇이 확인됐고 실패하거나 불명인지 나타내는 상태 모델입니다. In-app 표시·읽음처럼 외부 작업이 아닌 단계도 포함합니다.
알림 상태
다른 이름: 알림 전송 · Notification Sent State
공급자가 메시지를 외부 통신망이나 대상 기기로 내보냈다고 보고한 상태입니다.
알림 상태
다른 이름: 알림 도달 · Notification Delivered State
전달망이 목적지 서버나 기기에 메시지가 도착했다고 제공한 상태입니다.
알림 상태
다른 이름: 알림 표시 · Notification Displayed State
앱이나 운영체제가 사용자 화면에 알림을 표시했다고 별도 사건으로 확인한 상태입니다.
알림 상태
다른 이름: 알림 읽음 · Notification Read State
제품이 사용자의 명시적 열람 행동을 별도 사건으로 확인했을 때만 기록하는 상태입니다.
알림 상태
다른 이름: 알림 실패 · Notification Failed State
주소·정책·공급자 결과로 전달 실패가 확정되고 이유와 재시도 가능성이 분류된 상태입니다.
통신 방식
다른 이름: 원격 프로시저 호출 · Remote Procedure Call
다른 프로세스의 기능을 네트워크를 건너 함수처럼 호출하는 통신 방식입니다.
RPC 구현 체계
다른 이름: 지알피시 · gRPC Remote Procedure Calls
Protocol Buffers 계약과 생성 코드, HTTP/2 기반 전송을 주로 사용하는 RPC 구현 체계입니다.
전송 계약
다른 이름: 메시지 스키마 · Message Schema
통신 메시지의 필드·타입·식별자와 호환 규칙을 정한 계약입니다.
Protocol Buffers schema
메시지 형식
다른 이름: Protobuf · 프로토버프 · Protocol Buffers
메시지 schema와 필드 번호, binary 인코딩 규칙을 정의하는 데이터 직렬화 형식입니다.
gRPC 클라이언트
다른 이름: 클라이언트 Stub · gRPC Client Stub
proto 계약에서 생성되어 원격 메서드 호출을 언어별 함수 모양으로 제공하는 클라이언트 코드입니다.
gRPC 연결
다른 이름: gRPC 채널 · gRPC Channel
gRPC 클라이언트가 서버 대상과 연결 상태를 재사용하도록 관리하는 통로입니다.
gRPC 서버
다른 이름: gRPC 서버 구현체 · gRPC Servicer
proto에 선언된 RPC 메서드를 서버에서 실제로 수행하는 구현입니다.
API 경계
다른 이름: 공개 API · Public Application Programming Interface
조직 밖의 다양한 호출자가 사용하도록 공개하고 장기 호환성을 약속한 API입니다.
API 경계
다른 이름: 내부 서비스 API · Internal Service Application Programming Interface
조직이 배포와 호환 범위를 관리하는 서버 간 API 계약입니다.
전달 방식
다른 이름: 데이터 스트림 · 순차 조각 스트림 · Data Stream
전체 결과를 한 번에 주고받지 않고 시간 순서에 따라 자료 조각을 계속 전달·처리하는 방식입니다. 시스템 전체의 넓은 데이터 흐름을 모두 뜻하지 않습니다.
RPC 형태
다른 이름: 호출 개수 모양 · Remote Procedure Call Cardinality
RPC 하나에서 요청과 응답이 각각 몇 개인지 나타낸 호출 모양입니다.
RPC 형태
다른 이름: 1→1 RPC · Unary Remote Procedure Call
하나의 요청을 보내고 하나의 최종 응답을 받은 뒤 끝나는 RPC입니다.
RPC 형태
다른 이름: 1→N RPC · Server Streaming Remote Procedure Call
클라이언트가 요청 하나를 보내고 서버가 응답 여러 개를 순서대로 보내는 RPC입니다.
RPC 형태
다른 이름: N→1 RPC · Client Streaming Remote Procedure Call
클라이언트가 요청 여러 개를 보내고 서버가 최종 응답 하나를 보내는 RPC입니다.
다른 이름: 양방향 Streaming · N↔N RPC · Bidirectional Streaming Remote Procedure Call
클라이언트와 서버가 서로의 송신 횟수에 묶이지 않고 메시지를 계속 보내는 RPC입니다.
Data Stream 단위
다른 이름: 메시지 조각 · 전송 스트림 조각 · Message Chunk
큰 데이터 흐름을 순서대로 전송·처리하도록 나눈 작은 메시지 단위입니다.
Protobuf 호환성
다른 이름: proto 필드 번호 · Protocol Buffers Field Number
Protocol Buffers 전송 바이트에서 필드의 의미를 식별하는 안정적인 숫자 태그입니다.
Protobuf 호환성
다른 이름: reserved 선언 · 예약 선언 · Protocol Buffers Reserved Declaration
삭제한 Protobuf 필드의 번호나 이름을 다른 뜻으로 재사용하지 못하게 스키마에 남기는 선언입니다. 삭제된 필드 자체가 아니라 재사용 금지 목록입니다.
reserved 3; · reserved "legacy_role";
계약 산출물
다른 이름: 생성 코드 · Generated Source Code
schema compiler가 계약에서 자동으로 만드는 메시지·클라이언트·서버 보조 코드입니다.
다른 이름: 하위 호환성 · 구버전 호환 · Backward Compatibility
새 버전이 이전 버전의 입력·데이터·호출을 깨뜨리지 않고 계속 처리하는 성질입니다.
변경 계약
다른 이름: 호환성 파괴 변경 · 비호환 변경 · Backward-incompatible Change
기존 소비자가 코드·설정·데이터를 바꾸지 않으면 이전처럼 동작할 수 없게 만드는 계약 변경입니다.
흐름 제어
다른 이름: 역압 · 흐름 압력 · Backpressure
소비 속도보다 생산 속도가 빠를 때 대기열과 생산 속도를 제한해 자원 고갈을 막는 제어입니다.
프로세스 수명주기
다른 이름: 안전한 종료 · 우아한 종료 · Graceful Shutdown
새 작업을 막고 진행 작업에 제한된 정리 시간을 준 뒤 프로세스를 끝내는 절차입니다.
통신 계층
다른 이름: 전송 수단 · 통신 수단 · Transport
메시지를 한 프로그램에서 다른 프로그램으로 실제로 옮기는 통신 수단입니다.
프로토콜
다른 이름: 웹소켓 · raw WebSocket · WebSocket Protocol
한 번 연결한 뒤 클라이언트와 서버 양쪽이 메시지를 보낼 수 있는 지속 양방향 통신 프로토콜입니다.
라이브러리·응용 프로토콜
다른 이름: 소켓아이오 · Socket.IO
Event·처리 확인·실시간 방·재연결 기능과 자체 packet 규칙을 제공하는 실시간 통신 라이브러리와 프로토콜입니다.
연결 시작
다른 이름: WebSocket 연결 핸드셰이크 · WebSocket Opening Handshake
WebSocket 연결을 열기 전에 프로토콜·브라우저 출처·인증·버전 조건을 확인하는 시작 단계입니다.
연결 상태
다른 이름: 연결 생존 신호 · Connection Heartbeat
연결이나 프로세스 양쪽이 아직 응답할 수 있는지 주기적으로 확인하는 작은 신호입니다.
WebSocket Ping/Pong
메시지 계약
다른 이름: 이벤트 봉투 · Event Envelope
이벤트의 종류·버전·식별자·순서·범위·업무 내용을 일관된 형식으로 담는 메시지 계약입니다.
처리 확인
다른 이름: Event Ack · 이벤트 처리 확인 · Event Acknowledgement
상대가 메시지를 약속한 수신·저장·업무 처리 단계까지 다루었음을 알리는 확인입니다.
상태 복구
다른 이름: 상태 Snapshot · 전체 상태 복구본 · State Snapshot
특정 시점의 현재 상태 전체를 한 번에 재구성할 수 있게 만든 복구 자료입니다.
상태 복구
다른 이름: 상태 변경분 · 상태 차이 · State Delta
기준 상태 이후에 바뀐 부분만 표현한 작은 상태 조각입니다.
상태 복구
다른 이름: 이벤트 재생 · 누락 이벤트 복구 · Event Replay
저장해 둔 이벤트를 Cursor 이후부터 순서대로 다시 전달하는 복구 과정입니다.
연결 수명주기
다른 이름: 재연결 · Reconnect
네트워크 단절 뒤 새 연결을 만들고 인증과 상태를 다시 맞추는 복구 과정입니다.
전달 범위
다른 이름: 실시간 Room · 실시간 방 · Realtime Room
같은 이벤트를 받을 권한이 확인된 실시간 연결의 애플리케이션 수준 논리 묶음입니다.
짧은 수명의 상태
다른 이름: 실시간 온라인 상태 · 실시간 접속 상태 · Realtime Presence
사용자나 기기가 현재 연결되어 있는지 나타내는 짧은 수명의 상태입니다.
이벤트 전달
다른 이름: 실시간 다수 전달 · 이벤트 Broadcast · Realtime Event Broadcast
하나의 이벤트를 정한 수신자 묶음에 복제해 전달하는 동작입니다.
연결 라우팅
다른 이름: Sticky routing · 연결 고정 · Sticky Session
같은 클라이언트나 세션의 후속 트래픽을 같은 서버 인스턴스로 보내는 라우팅 방식입니다.
메시지 전달
다른 이름: Publish-Subscribe · 발행·구독 · Publish/Subscribe
발행자가 topic에 이벤트를 보내면 구독한 여러 소비자가 각자 받는 전달 방식입니다.
저장 상태
다른 이름: 영속 상태 · 저장된 업무 상태 · Persistent State
연결이 끊기거나 프로세스가 재시작해도 복구해야 하는 업무 상태입니다.
미디어 기술 묶음
다른 이름: 웹 실시간 통신 · Web Real-Time Communication
브라우저와 기기 사이에서 음성·영상·데이터를 낮은 지연으로 전송하는 표준과 API 묶음입니다.
연결 제어
다른 이름: WebRTC 신호 교환 · 연결 제어 메시지 교환 · WebRTC Signaling
WebRTC 연결 상대·SDP·ICE 후보·세션 상태를 합의하기 위해 주고받는 제어 메시지 과정입니다.
미디어 전송
다른 이름: 미디어 경로 · WebRTC Media Path
WebRTC 협상 뒤 실제 음성·영상 패킷이 통과하는 네트워크 경로입니다.
미디어 압축
다른 이름: 코덱 · Coder-Decoder
음성이나 영상을 저장·전송하기 위해 압축하고 다시 푸는 규칙입니다.
Opus · H.264
브라우저 미디어
다른 이름: WebRTC 미디어 Track · 미디어 트랙 · MediaStreamTrack
브라우저에서 마이크 음성이나 카메라 영상 하나의 지속적인 미디어 소스를 나타내는 객체입니다.
브라우저 미디어
다른 이름: 미디어 스트림 · MediaStream
브라우저에서 함께 다룰 오디오·비디오 Media Track 여러 개를 묶은 객체입니다.
오디오 Track과 비디오 Track의 묶음
브라우저 API
다른 이름: PeerConnection · 피어 연결 객체 · WebRTC Peer Connection
WebRTC의 Media Track 전송, SDP·ICE 협상, 연결 상태와 통계를 관리하는 브라우저 객체입니다.
미디어 협상
다른 이름: 세션 기술 프로토콜 · Session Description Protocol
WebRTC 세션이 지원하는 codec·미디어 방향·연결·보안 조건을 기술하는 협상 형식입니다. Session Description은 이 형식으로 표현한 한 설명 인스턴스입니다.
미디어 협상
다른 이름: SDP Offer · WebRTC 협상 제안 · WebRTC Offer
WebRTC 피어 한쪽이 가능한 미디어·연결 조건을 SDP로 먼저 제안한 메시지입니다.
미디어 협상
다른 이름: SDP Answer · WebRTC 협상 응답 · WebRTC Answer
Offer를 받은 WebRTC 피어가 자신이 받아들일 조건을 골라 SDP로 돌려주는 메시지입니다.
네트워크 주소 변환
다른 이름: 네트워크 주소 변환 · Network Address Translation
공유기 같은 네트워크 경계 장비가 내부 IP 주소·포트 번호와 외부에서 보이는 주소·포트 번호를 대응시켜 패킷을 전달하는 방식입니다.
네트워크 경로 선택
다른 이름: 아이스 · 연결 경로 탐색 · Interactive Connectivity Establishment
WebRTC 피어가 사용할 수 있는 네트워크 후보를 모아 실제 연결 가능성을 시험하고 통신 경로를 고르는 절차입니다.
네트워크 경로
다른 이름: 아이스 후보 · 연결 경로 후보 · Interactive Connectivity Establishment Candidate
ICE가 실제 연결 가능성을 시험할 host·server-reflexive·peer-reflexive·relay 유형의 전송 주소와 조건입니다.
ICE 도움 서비스
다른 이름: 스턴 · Session Traversal Utilities for NAT
NAT 뒤의 피어가 인터넷에서 자신이 어떤 전송 주소로 보이는지 알아내게 돕는 프로토콜과 서버입니다.
데이터 패킷 중계
다른 이름: 턴 · Traversal Using Relays around NAT
직접 경로가 막혔을 때 relay 서버가 미디어·DataChannel 같은 피어 사이 데이터 패킷을 대신 전달하게 하는 프로토콜과 서버 역할입니다.
미디어 패킷
다른 이름: 실시간 전송 프로토콜 · Real-time Transport Protocol
음성·영상의 순서와 재생 시간 정보를 담아 실시간으로 운반하는 패킷 형식입니다.
데이터그램 보안
다른 이름: 데이터그램 TLS · Datagram Transport Layer Security
순서·전달이 보장되지 않는 데이터그램 통신에 기밀성·무결성·상대 인증을 제공하도록 만든 TLS 계열 프로토콜입니다.
미디어 보안
다른 이름: Secure RTP · 보안 RTP · Secure Real-time Transport Protocol
RTP 미디어 본문을 암호화하고 패킷 무결성과 재전송 공격 방지 기능을 제공하는 프로토콜입니다.
미디어 서버
다른 이름: 선택 전달 서버 · Selective Forwarding Unit
송신자가 올린 미디어를 섞지 않고 각 수신자에게 필요한 스트림을 골라 전달하는 서버입니다.
미디어 서버
다른 이름: 미디어 혼합 서버 · Multipoint Control Unit
여러 사용자의 압축 미디어를 풀어 혼합한 뒤 다시 압축해 하나의 스트림으로 전달하는 서버입니다.
브라우저 API
다른 이름: WebRTC Stats API · WebRTC 연결 통계 API · RTCPeerConnection.getStats
RTCPeerConnection의 Packet Loss·Media Jitter·RTT·전송률·ICE Candidate 같은 통계를 읽는 API입니다.
미디어 품질
다른 이름: 패킷 지터 · 도착 간격 흔들림 · Packet Delay Variation
미디어 패킷의 도착 간격이 고르지 않아 재생 시각이 흔들리는 정도입니다.
네트워크 품질
다른 이름: 패킷 손실 · Packet Loss
보낸 네트워크 패킷 중 수신자에게 도착하지 못한 비율이나 개수입니다.
네트워크 지연
다른 이름: 왕복 시간 · round-trip time · Round-Trip Time
패킷이 상대에게 갔다가 응답으로 돌아오기까지 걸린 왕복 시간입니다.
데이터 이관 작업
다른 이름: Backfill · 백필 · Database Backfill
새 구조나 규칙에 맞게 이미 저장된 기존 데이터를 채우거나 변환하는 데이터 이관 작업입니다. 작은 처리 묶음으로 나누는 것은 운영 안전을 위한 실행 전략이지 Backfill 자체의 뜻은 아닙니다.
변경 기록
다른 이름: Migration History · 마이그레이션 이력 · Database Migration History
어떤 DB 변경 파일이 어느 순서와 결과로 적용되었는지 데이터베이스에 남기는 버전 기록입니다. 스키마 이력 테이블은 이 기록을 저장하는 한 구현 예입니다.
스키마 이력 테이블
마이그레이션 단계
다른 이름: Expand Phase · Expand · DB 확장 단계 · Database Migration Expand Phase
옛 코드가 계속 동작하도록 기존 구조를 유지한 채 새 열·표·인덱스 같은 호환 구조를 먼저 더하는 단계입니다.
마이그레이션 단계
다른 이름: Contract Phase · Contract · DB 축소 단계 · Database Migration Contract Phase
모든 소비자가 새 구조로 전환했다는 증거 뒤에 옛 열·표·제약과 호환 코드를 제거하는 단계입니다.
배포 호환
다른 이름: N-1 Compatibility · 직전 버전 DB 호환 · N Minus One Database Compatibility
현재 버전 N과 직전 버전이 배포 중 같은 DB 계약으로 함께 동작할 수 있는 성질입니다.
이관 방식
다른 이름: 이중 쓰기 · Dual Write
이관 기간에 하나의 업무 변경을 옛 저장 위치와 새 저장 위치 양쪽에 기록하는 방식입니다.
처리 방식
다른 이름: 작은 묶음 반복 처리 · Chunked Batch Processing
한 큰 작업을 크기와 완료 경계가 정해진 여러 작은 처리 묶음으로 나누어 반복 실행하는 방식입니다. 비대화형 작업을 한꺼번에 처리하는 넓은 Batch Processing 전체가 아니라, 장기 작업의 실행·복구 단위를 의도적으로 작게 나누는 방식입니다.
DB 복구 기록
다른 이름: Transaction Log · Database Transaction Log
DB가 확정된 변경과 복구·복제에 필요한 순서를 내부적으로 기록하는 지속 로그입니다. 일반 애플리케이션 변경 로그와는 다릅니다.
DB 운영 지표
다른 이름: Replica Lag · Replication Lag · Database Replica Lag
복제본이 원본 데이터베이스의 확정된 변경을 아직 따라잡지 못한 시간이나 변경량입니다.
변경 검증
다른 이름: Migration Validation · 마이그레이션 검증 · Database Migration Validation
빈 DB와 이전 버전 DB에 변경을 적용하고 호환 API·데이터 의미·실행 시간·잠금을 확인하는 검증입니다. 운영과 비슷한 DB에서 하는 변경 리허설은 이 검증의 한 방법입니다.
운영 유사 DB 변경 리허설
SQL 종류
다른 이름: 데이터 정의어 · Data Definition Language
표·열·인덱스·제약처럼 데이터 구조를 만들거나 바꾸거나 제거하는 SQL 명령 종류입니다. 스키마 변경 SQL은 DDL의 한 사용 맥락이지 별도 동의어가 아닙니다.
복구 방식
다른 이름: 역방향 DB 마이그레이션 · Down Migration
적용한 DB 구조 변경을 이전 모양으로 되돌리도록 미리 작성한 역방향 변경입니다.
DB 변경 복구 방식
다른 이름: 앞으로 고치는 DB 변경 · 수정 마이그레이션 · Forward-fix Database Migration
이미 적용된 안전한 DB 변경과 현재 데이터를 유지하고 새 DB 마이그레이션을 추가해 일관된 다음 상태로 바로잡는 방식입니다. 백업과 트랜잭션 로그를 재적용해 데이터 복구 시점으로 전진하는 방식과는 이름이 비슷하지만 다른 배포 변경 전략입니다.
객체 저장 단위
다른 이름: 스토리지 객체 · 파일 저장 객체 · Object Storage Object
객체 저장소에서 고유 객체 키로 찾는 파일 바이트와 부가 정보의 저장 단위입니다.
저장 식별자
다른 이름: 객체 키 · Object Storage Key
버킷이나 저장 공간 안에서 저장 객체를 유일하게 찾는 문자열 식별자입니다. 파일을 저장할 때 자주 쓰지만 파일 이름 자체와 같은 값은 아닙니다.
전달 시스템
다른 이름: 콘텐츠 전송망 · Content Delivery Network
원본 서버의 파일 복사본을 사용자 가까운 엣지에 캐시해 지연과 원본 부하를 줄이는 분산 전달망입니다.
CDN 원본
다른 이름: CDN 원본 · Content Delivery Network Origin
CDN이 Cache Miss 때 파일을 가져오는 Object Storage나 원본 서버입니다.
캐시 결과
다른 이름: 캐시 미스 · Cache Miss
요청에 맞는 사용 가능한 복사본이 캐시에 없어 원본 서버나 다음 저장 계층에서 결과를 가져오는 상태입니다. 복사본이 물리적으로 전혀 없을 때뿐 아니라 만료됐거나 요청에서 계산한 캐시 식별값과 맞지 않을 때도 발생합니다.
캐시 결과
다른 이름: 캐시 히트 · 복사본 적중 · Cache Hit
요청과 같은 캐시 키의 유효한 복사본을 찾아 원본 서버 조회 없이 응답하는 상태입니다.
제한된 요청 권한
다른 이름: 사전 서명 URL · Pre-signed Request URL
기존 권한으로 특정 요청 방식·저장 객체·만료 조건을 서명해 잠시 실행할 수 있게 한 요청 주소입니다. 단순히 수명이 짧은 Storage URL과 같지 않습니다.
업로드 상태
다른 이름: 업로드 티켓 · 업로드 접수표 · File Upload Ticket
직접 업로드 전에 소유자·예상 파일 조건·객체 키·만료·처리 상태를 DB에 기록한 업무 식별자입니다. 후속 작업이 참조할 수 있지만 작업 실행 단위 자체는 아닙니다.
업로드 검증
다른 이름: 업로드 확인 · Direct Upload Confirmation
직접 업로드 뒤 서버가 저장 객체의 존재·크기·검사합·소유자를 검증하고 업무 상태를 전진시키는 단계입니다.
무결성 값
다른 이름: 검사합 · Data Checksum
같은 알고리즘으로 계산한 byte 요약값을 비교해 전송·보관 중 내용이 달라졌는지 확인하는 값입니다. 파일 지문이라는 비유만으로 계산 알고리즘과 대상 byte 범위를 생략하면 안 됩니다.
CDN 복사본 식별
다른 이름: CDN 캐시 키 · Content Delivery Network Cache Key
CDN에서 두 요청이 같은 복사본을 함께 사용해도 되는지 가르는 URL·Query·Header 등의 조합입니다.
내용 기반 식별
다른 이름: 내용 Hash · 콘텐츠 해시 · Content Hash
파일 byte에서 계산한 Hash를 이름이나 URL에 넣어 내용이 달라지면 새 버전 주소가 생기게 하는 값입니다.
캐시 운영
다른 이름: 캐시 무효화 · CDN Invalidation · CDN Cache Invalidation
CDN에 남은 특정 경로나 캐시 키의 복사본을 원래 만료 시각보다 일찍 제거하라고 요청하는 작업입니다.
HTTP 응답 캐시 계약
다른 이름: 응답 Cache-Control · HTTP 응답 캐시 제어 Header · HTTP Response Cache-Control Header
HTTP 응답의 Cache-Control Header로 브라우저·공유 캐시가 응답 복사본을 저장·재사용·재검증할 조건을 전달하는 계약입니다. 요청의 Cache-Control 지시어나 애플리케이션·CDN 설정까지 포함하는 전체 캐시 정책과는 범위가 다릅니다.
CDN 지표
다른 이름: CDN 캐시 적중률 · Content Delivery Network Cache Hit Ratio
정한 관측 구간과 집계 대상에서 CDN Edge의 유효한 복사본으로 처리한 양이 전체 집계량에서 차지하는 비율입니다. 요청 수를 세는 지표와 전송 byte를 세는 지표는 서로 다른 값이며, 비캐시 요청·오류·재검증을 분모나 적중에 넣는 규칙도 공급자와 제품 지표마다 다릅니다.
요청 수 기반 캐시 적중률 · 전송 byte 기반 캐시 적중률
네트워크 비용
다른 이름: 외부 전송량 · 반출 Traffic · Network Data Egress
시스템·조직·공급자처럼 먼저 정한 네트워크 비용 경계 밖으로 나가는 데이터 양입니다. 경계와 방향을 정해야 같은 전송을 중복 계산하지 않습니다.
HTTP 전달
다른 이름: HTTP 부분 범위 요청 · HTTP Range Request
한 URL이 가리키는 파일에서 필요한 byte 범위를 Range 요청 Header로 지정하고 부분 응답으로 받아 Media Seek와 전송 재개를 가능하게 하는 요청 방식입니다.
Range Header를 사용한 byte 범위 요청
계산 방식의 범주
다른 이름: AI · Artificial Intelligence
분류·예측·생성·의사결정처럼 보통 지능이 필요하다고 여기는 과업을 컴퓨터가 수행하게 하는 기법과 시스템의 큰 범주입니다. 학습 모델은 그 구현 방식 중 하나이며 AI가 스스로 제품 책임을 지는 주체라는 뜻은 아닙니다.
AI 계산
다른 이름: AI 모델 · Artificial Intelligence Model
학습으로 정해진 Parameter를 사용해 입력을 예측·생성·분류 같은 출력으로 바꾸는 계산 구조입니다. 학습됐다는 상태 설명을 개념의 별도 이름으로 쓰지 않습니다.
AI 학습 과정
다른 이름: AI 모델 학습 · Artificial Intelligence Model Training
예시 데이터와 목표를 사용해 AI Model의 Parameter 값을 조정하는 과정입니다.
AI 실행 과정
다른 이름: AI 모델 추론 · AI 모델 실행 · Artificial Intelligence Model Inference
학습된 AI Model의 Parameter에 실제 입력을 넣어 예측·텍스트·음성·Vector 같은 출력을 계산하는 과정입니다.
AI 제공 주체
다른 이름: AI 서비스 제공자 · Artificial Intelligence Service Provider
AI 모델 실행 주소와 용량·도구·운영 기능을 제공하는 내부 조직이나 외부 서비스 주체입니다. AI 모델만 제공하는 좁은 역할로 한정되지 않습니다.
AI 업무 계약 단위
다른 이름: AI 능력 · AI 업무 기능 · Artificial Intelligence Capability
요약 생성·음성 인식·음성 합성·벡터 변환처럼 제품이 요구하며 고유한 입력·출력·상태·품질·비용 조건을 가진 AI 업무 기능 단위입니다.
AI 모델 종류
다른 이름: 대규모 언어 모델 · Large Language Model
대규모 텍스트 자료에서 언어의 통계적 관계를 학습해 문맥에 이어질 토큰을 예측하고 텍스트나 구조를 생성하는 언어 모델 종류입니다. 모든 언어 모델을 뜻하지 않습니다.
AI 능력
다른 이름: 음성 인식 · Speech Recognition · Speech-to-Text
음성 신호를 시간과 언어 문맥에 맞는 텍스트로 변환하는 AI 기능입니다.
AI 능력
다른 이름: 음성 합성 · Speech Synthesis · Text-to-Speech
텍스트를 선택한 Voice와 속도·형식 조건에 맞는 재생 가능한 음성으로 변환하는 AI 기능입니다.
AI 모델 종류
다른 이름: 임베딩 모델 · Embedding Model
텍스트·이미지 같은 입력을 서로 비교할 수 있는 Vector 좌표계에 배치하도록 학습된 AI 모델 종류입니다.
AI 실행 과정
다른 이름: 임베딩 · Embedding Transformation
Embedding Model을 입력에 실행해 비교 가능한 고정 길이 Vector를 만드는 변환 과정입니다. 텍스트 의미 Vector 생성은 한 주요 사용 사례지만 이미지 등 다른 입력에도 적용할 수 있습니다.
AI 출력 데이터
다른 이름: 임베딩 벡터 · Embedding Vector
Embedding Model을 입력에 실행한 Embedding 과정이 입력 특징을 정해진 순서와 길이의 숫자 배열로 표현한 결과입니다. 숫자 표현이나 의미 좌표는 성질을 풀이하는 말이지 개념의 정확한 다른 이름은 아닙니다.
Embedding 계약
다른 이름: 임베딩 차원 · 임베딩 벡터 차원 수 · Embedding Vector Dimension
한 Embedding Vector에 들어 있는 숫자의 고정 개수입니다. Vector 길이라는 표현은 수학적 벡터 크기와 혼동될 수 있어 숫자 개수라고 명시합니다.
Vector 크기 측정
다른 이름: Norm · 벡터 노름 · 벡터 크기 계산 · Vector Norm
Vector의 숫자들로 하나의 크기 값을 계산하는 규칙입니다. L2 Norm은 각 숫자의 제곱을 더한 뒤 제곱근을 계산하며, 숫자의 개수인 Embedding Dimension과 다릅니다.
AI 출력 계약
다른 이름: 구조화 출력 · Schema 출력 · Structured Model Output
자유 문장 대신 정해진 JSON Schema 같은 필드·타입 구조를 따르도록 요청한 AI 모델 출력입니다.
Embedding 변환
다른 이름: 임베딩 벡터 정규화 · 벡터 정규화 · Embedding Vector Normalization
Embedding Vector를 정한 Vector Norm 기준으로 재조정해 방향은 유지하면서 크기를 맞추는 변환입니다. 흔한 L2 정규화는 각 Vector의 L2 Norm을 1로 만들며, 각 차원의 분포를 바꾸는 표준화와 같은 말이 아닙니다.
AI 검증
다른 이름: AI 모델 평가 · Artificial Intelligence Model Evaluation
대표 입력과 기대 기준으로 AI Model의 품질·지연·안전·비용을 반복 가능하게 측정하고 비교하는 검증입니다.
소프트웨어 경계
다른 이름: 아키텍처 Port · Hexagonal Architecture Port
업무 코드가 외부 저장소·공급자·전송 능력에 기대하는 안정된 인터페이스 계약입니다. Provider Port는 외부 공급자 능력에 이 계약을 적용한 한 사례입니다.
Provider Port
구현 조립 경계
다른 이름: AI 공급자 Factory · AI 공급자 생성기 · Artificial Intelligence Provider Factory
설정과 AI Capability를 검증한 뒤 Architecture Port를 만족할 구체 AI Provider Adapter를 선택하고 의존성과 함께 생성하는 코드 경계입니다. 모든 객체 생성 방식을 뜻하는 일반 Factory가 아니라 이 강의의 공급자 구현 조립 역할에 범위를 한정합니다.
AI 안전 검증
다른 이름: AI 출력 검증 · Artificial Intelligence Output Validation
AI Model 결과의 Schema·Enum·길이·실재 ID·URL·권한·업무 규칙을 결정적 코드로 다시 검사하는 단계입니다. 일반적인 결과 검증 가운데 신뢰하지 않는 AI 출력의 채택 경계에 범위를 한정합니다.
AI 신뢰 방식
다른 이름: AI 응답 근거 연결 · Artificial Intelligence Response Grounding
AI Model의 답이 허용된 근거 자료에 연결되도록 문맥과 확인 가능한 출처 식별자를 제공하는 방식입니다. 검색 결과는 근거를 제공하는 한 경로이지 AI Response Grounding 전체의 다른 이름은 아닙니다.
AI 공격
다른 이름: 프롬프트 주입 · 지시문 주입 · Prompt Injection Attack
사용자 입력이나 검색 문서 속 문장이 AI 모델에게 기존 규칙·권한·도구 제한을 무시하도록 유도하는 공격입니다.
동시성 제어
다른 이름: CAS · 조건부 상태 갱신 · Compare-and-set State Update
현재 값이나 버전이 예상한 상태일 때만 새 값으로 바꾸는 원자적 갱신 방식입니다.
처리 흐름
다른 이름: 미디어 파이프라인 · Media Processing Pipeline
원본 업로드에서 검사·변환·게시·CDN 전달·실제 재생 검증까지 이어지는 비동기 처리 흐름입니다. 업로드부터 재생까지의 흐름은 이 서비스에서 다루는 구체 범위입니다.
미디어 파일 구성
다른 이름: 미디어 파일 트랙 · 컨테이너 미디어 트랙 · Container Media Track
미디어 파일 안에서 시간 순서가 있는 한 종류의 압축 오디오·영상·자막 데이터를 이루는 흐름입니다. 브라우저의 MediaStreamTrack 객체인 Media Track과 이름이 비슷하지만 파일 안의 압축 데이터 구성 단위입니다.
미디어 처리
다른 이름: Transcode · 트랜스코딩 · Media Transcoding
압축된 원본 미디어를 신호로 푼 뒤 다른 Codec과 품질 조건의 압축 미디어로 다시 만드는 처리입니다. 포장만 바꾸거나 부가 정보만 고치는 모든 미디어 변환을 뜻하지 않습니다.
재생 프로그램
다른 이름: 미디어 플레이어 · 미디어 재생기 · Media Player
Media Manifest나 HLS Media Playlist를 읽고 필요한 미디어 조각을 요청·Media Decoding해 화면과 소리를 재생하는 Client 프로그램입니다.
미디어 처리
다른 이름: 미디어 디코딩 · Media Decoding
Codec 규칙에 따라 압축된 오디오·영상 데이터를 재생하거나 다시 처리할 수 있는 신호로 푸는 과정입니다.
미디어 처리
다른 이름: 미디어 인코딩 · Media Encoding
오디오·영상 신호를 선택한 Codec·Media Bitrate·Video Resolution 설정의 압축 데이터로 만드는 과정입니다.
미디어 형식
다른 이름: 미디어 컨테이너 · 파일 포장 형식 · Media Container Format
코덱으로 압축된 여러 오디오·영상·자막 트랙과 부가 정보를 한 파일 구조에 담는 포장 형식입니다.
미디어 품질·전송
다른 이름: 미디어 비트레이트 · 미디어 비트 전송률 · Media Bit Rate
1초 동안 전달하거나 재생하는 미디어 데이터 양으로 품질·대역폭·저장 비용에 영향을 주는 비율입니다. 값에는 bit/s 같은 단위를 함께 적고, 파일 전체 byte 크기와 구분합니다.
영상 품질
다른 이름: 영상 해상도 · 화소 해상도 · Video Resolution
영상 한 장을 구성하는 가로와 세로 화소 수입니다. 물리적인 화면 크기나 파일 byte 크기와 같은 값이 아닙니다.
미디어 전달 방식
다른 이름: HTTP 라이브 스트리밍 · HTTP Live Streaming
HLS Media Playlist가 HLS Media Segment를 재생 순서로 연결해 HTTP로 전달하는 스트리밍 규격입니다. 여러 Media Rendition이나 대체 미디어 그룹을 제공하는 적응형 구성에서는 HLS Master Playlist가 각 HLS Media Playlist를 가리키지만, 단일 HLS Media Playlist 구성에 상위 목록이 반드시 필요한 것은 아닙니다. HLS가 내부 Codec이나 Media Container Format을 자동으로 정하는 것도 아닙니다.
HLS 전달 조각
다른 이름: HLS 미디어 조각 · HLS 미디어 시간 조각 · HTTP Live Streaming Media Segment
HLS Media Playlist가 재생 순서대로 가리키도록 연속 미디어를 짧은 시간 범위로 나눈 파일이나 byte 범위입니다. 한 HLS Media Segment가 전체 Media Rendition을 뜻하지 않습니다.
다른 이름: ABR · 적응형 비트레이트 스트리밍 · Adaptive Bitrate Streaming
Media Player가 추정한 네트워크 처리량·미리 받아 둔 재생 분량·기기 상태에 따라 재생 중 Media Rendition을 바꾸는 선택 방식입니다.
안전 상태
다른 이름: 격리 · 격리 상태 · Data Quarantine State
검사나 정합성이 확인될 때까지 대상의 사용자 접근과 일반 처리를 막고 증거를 보존하는 상태입니다.
사용자 품질
다른 이름: 미디어 사용자 경험 품질 · 재생 체감 품질 · Media Quality of Experience
시작 지연·Media Playback Stall·Media Seek·화질 전환·완주처럼 사용자가 실제 재생 과정에서 느끼는 서비스 품질입니다.
재생 동작
다른 이름: Seek · 재생 위치 이동 · 미디어 탐색 · Media Playback Seek
사용자가 재생 중 원하는 시간 위치를 선택하고 Media Player가 그 지점의 미디어를 찾아 다시 재생하는 동작입니다. 재생 위치 이동 성공에는 참조 정보·byte 요청·Media Decoding·화면 또는 소리 재개가 모두 포함됩니다.
재생 장애
다른 이름: 재생 멈춤 · Buffering Stall · Media Playback Stall
Media Player가 재생에 필요한 데이터를 제때 받거나 Media Decoding하지 못해 영상이나 음성이 멈추는 사용자 결과입니다.
AI 구조
다른 이름: 검색 증강 생성 · Retrieval-Augmented Generation
질문과 관련된 자료를 먼저 검색해 모델 입력 문맥에 근거로 추가한 뒤 답을 생성하는 구조입니다.
다른 이름: 정보 검색 · Information Retrieval
저장된 후보 가운데 질의와 관련 있는 항목을 찾고 순위를 매기는 기능입니다. 답을 생성하거나 사용자의 접근 권한을 부여하는 기능은 아닙니다.
모델 학습
다른 이름: 미세 조정 · 파인튜닝 · Model Fine-tuning
기존 모델을 추가 학습 데이터로 조정해 행동·형식·업무 패턴을 바꾸는 학습 방식입니다.
검색 전략
다른 이름: 키워드 검색 · Keyword Search
질의에 적은 단어나 토큰이 후보의 지정 필드·본문과 일치하는지를 중심으로 찾는 검색 전략의 넓은 이름입니다. 제품마다 정확 일치·부분 일치·토큰화 범위가 다르므로 실제 일치 계약을 함께 적어야 합니다.
검색 전략
다른 이름: 전문 검색 · Full-text Search
문서 본문을 토큰화하고 단어의 등장 정보를 검색용 색인에 기록해 질의와 문자적으로 잘 맞는 문서를 찾는 검색 전략입니다.
데이터 파이프라인
다른 이름: 문서 준비 파이프라인 · 문서 색인 파이프라인 · Document Ingestion Pipeline
원본 문서를 식별·버전·분할·Embedding해 검색 가능한 기록으로 만드는 반복 가능한 파이프라인입니다. 문서를 가져오는 수집 단계만을 뜻하지 않습니다.
검색 사본 식별
다른 이름: 원본 버전 · 검색 원본 버전 · Source Document Version
검색 기록을 만들 때 원본 업무 레코드의 현재 변경 번호나 수정 시각을 읽어 함께 복사한 버전 값입니다.
RAG 데이터 단위
다른 이름: 문서 조각 · RAG Chunk · Document Chunk
원본 문서를 검색과 모델 입력 문맥에 넣기 좋은 크기와 경계로 나눈 의미 단위입니다.
자료 표현
다른 이름: 벡터 · 수치 벡터 · Vector
비교할 대상을 정해진 순서와 차원의 숫자 배열로 표현한 값입니다. 차원·순서·비교 규칙을 함께 정해야 하며, Embedding Vector의 개별 좌표가 사람이 읽을 수 있는 뜻을 하나씩 가질 필요는 없습니다.
검색 버전
다른 이름: Index 세대 · 색인 세대 · Search Index Generation
동일한 Document Chunk·Embedding·Schema 규칙으로 함께 만든 검색 색인 전체를 구분하는 세대 식별자입니다.
검색 전략
다른 이름: 벡터 검색 · 벡터 유사도 검색 · Vector Similarity Search
질의 Vector와 후보 Vector 사이의 거리를 계산해 가까운 기록을 찾는 검색 전략입니다. 의미 검색에 자주 쓰이지만 이미지·수치 특징 Vector도 검색할 수 있으므로 둘은 같은 이름이 아닙니다.
Vector 비교
다른 이름: 코사인 유사도 · Cosine Similarity
두 Vector의 방향이 얼마나 비슷한지를 내적과 크기로 정규화해 표현한 유사도입니다.
Vector 거리
다른 이름: 코사인 거리 · Cosine Distance
두 Vector의 방향 차이를 거리로 표현해 작을수록 가깝게 판정하는 함수입니다. pgvector의 <=>는 이 거리를 계산하는 한 제품 연산자입니다.
pgvector <=> 연산자
검색 전략
다른 이름: 정확 Vector 검색 · Exact Vector Search
검색 범위의 모든 Vector 후보에 같은 거리 계산을 적용해 순서를 구하는 검색 전략입니다. 다른 종류의 정확 검색 전체를 뜻하지 않습니다.
검색 결과 크기
다른 이름: Top-K · 상위 K개 · Top K Results
정렬된 검색 후보 중 앞에서 K개만 반환하도록 정한 결과 크기입니다.
검색 전략
다른 이름: 근사 최근접 검색 · Approximate Nearest Neighbor
모든 후보 대신 가까울 가능성이 큰 일부를 탐색해 지연을 줄이는 근사 최근접 검색 전략입니다. 다른 종류의 근사 검색 전체를 뜻하지 않습니다.
ANN 지표
다른 이름: ANN 재현율 · 근사 검색 Recall@K · Approximate Nearest Neighbor Recall at K
같은 질의의 Exact 상위 K개 중 ANN 상위 K개에도 포함된 결과의 비율입니다.
다른 이름: 벡터 검색 지연 · Vector Query Latency · Vector Search Latency
Vector 검색 요청을 시작해 정렬된 후보 결과를 받을 때까지 걸린 시간입니다. RAG 답 생성이나 다른 검색 방식의 전체 지연을 뜻하지 않습니다.
ANN Index
다른 이름: HNSW Index · Hierarchical Navigable Small World
여러 층의 이웃 Graph를 따라 넓은 탐색에서 정밀 탐색으로 내려가는 ANN Index입니다.
ANN Index
다른 이름: IVF Flat · IVFFlat Index · Inverted File Flat
Vector를 중심별 List로 나누고 질의와 가까운 List 일부의 원본 Vector를 비교하는 ANN Index입니다.
HNSW 질의 설정
다른 이름: hnsw.ef_search · ef_search · HNSW Search Candidate List Size
pgvector의 HNSW 검색 중 유지할 동적 후보 목록의 크기를 정하는 질의별 탐색 폭 설정입니다.
IVFFlat 질의 설정
다른 이름: ivfflat.probes · IVFFlat Query Probes
pgvector의 IVFFlat 검색에서 질의 Vector와 가까운 중심별 List를 몇 개 열어볼지 정하는 질의별 탐색 폭 설정입니다.
검색 저장 역할
다른 이름: 벡터 저장소 · Vector Store
벡터와 식별자·부가 정보를 저장하고 거리 기반 검색을 제공하는 시스템 역할입니다. Vector Database는 이 역할을 제공하는 제품 범주일 수 있지만 역할 자체의 다른 이름은 아닙니다.
PostgreSQL Extension
다른 이름: Postgres Vector Extension · pgvector PostgreSQL Extension
PostgreSQL에 Vector 자료형·거리 연산·Exact 및 ANN Index를 추가하는 Extension입니다.
Vector Database
다른 이름: Qdrant Vector Database
Qdrant Collection·Qdrant Point·Qdrant Payload 모델과 Vector 검색 API를 제공하는 별도 Client–Server Vector Database입니다.
Qdrant 자료 구조
다른 이름: 벡터 Collection · Qdrant Collection
Qdrant Point를 공통 색인·데이터 분할 설정 아래 묶는 이름 있는 저장 범위입니다. 단일 Vector 구성이면 차원·거리 규칙을 공유하고, 여러 Vector 필드를 쓰면 필드마다 차원·거리 규칙을 따로 정할 수 있습니다.
Qdrant 자료 구조
다른 이름: Qdrant Vector Point · Qdrant Point
안정적 ID에 Vector와 선택적 Qdrant Payload를 연결한 Qdrant의 기본 저장·Upsert 단위입니다.
Qdrant 필터 데이터
다른 이름: Qdrant 필터 데이터 · Qdrant Point Payload
Qdrant Point에 함께 저장해 검색 조건을 표현하고 결과와 함께 반환할 수 있는 JSON 형태의 데이터입니다. 이 필드를 검색 조건으로 옮길 수는 있지만 사용자 권한 판정 자체는 서버의 인가 규칙이 맡습니다.
검색용 Vector Metadata
다른 이름: 검색 범위 Filter · 검색 범위 필터 · Retrieval Scope Filter
서버가 확정한 현재 사용자의 허용 범위를 SQL WHERE 절이나 Qdrant Payload 조건으로 실행하는 검색 조건입니다.
Qdrant Index
다른 이름: Payload Field Index · Payload 필드 Index · Qdrant Payload Index
Qdrant Payload의 특정 필드 조건으로 후보를 빠르게 좁히도록 만드는 필드별 Index입니다.
검색 전략
다른 이름: 하이브리드 검색 · 혼합 검색 · Hybrid Retrieval
Full-text·Sparse·Dense Vector 같은 서로 다른 검색 결과를 하나의 순위로 결합하는 검색 전략입니다.
순위 결합
다른 이름: 역순위 결합 · Reciprocal Rank Fusion
서로 다른 검색기의 점수 크기 대신 각 결과의 순위 역수를 합해 통합 순위를 만드는 방식입니다.
검색 후처리
다른 이름: 재순위화 · Search Result Reranking
1차 검색이 모은 후보를 질의와 다시 비교해 상위 순서를 재조정하는 과정입니다. 이 과정을 수행하는 규칙·모델·프로그램과 과정 자체를 같은 대상으로 부르지 않습니다.
RAG 데이터 역할
다른 이름: 검색 원본 · 사실 원본 · Search Source of Truth
검색 사본을 다시 만들 때 문서 내용·권한·삭제·버전의 최종 사실로 판정할 소유 시스템 역할입니다.
데이터 전달 패턴
다른 이름: Outbox · 트랜잭션 발신함 · Transactional Outbox Pattern
업무 변경과 외부 사본 갱신이 필요하다는 Event를 업무 DB의 같은 Transaction에 기록하는 패턴입니다.
데이터 쓰기
다른 이름: 멱등 Upsert · 멱등 삽입·갱신 · Idempotent Update or Insert
같은 안정적 ID·버전의 삽입 또는 갱신을 반복해도 최종 저장 상태가 한 번 처리한 것과 같게 되는 쓰기입니다.
검색 운영 지표
다른 이름: 검색 신선도 · Index Freshness · Search Index Freshness
Source of Truth의 변경이 검색 결과에 반영되기까지의 지연과 현재성을 나타내는 운영 특성입니다.
다른 이름: RAG 검색 권한 정책 · 검색 인가 정책 · Retrieval Authorization Policy
검증된 주체가 어느 원본·문서 조각·행동을 검색할 수 있는지 서버가 판정하는 인가 정책입니다. 접근 제어 목록은 이 정책을 표현하는 한 방식일 수 있지만 정책 전체의 다른 이름은 아닙니다.
접근 제어 목록 기반 검색 제한
보안 경계
다른 이름: 신뢰 경계 · 신뢰 수준 경계 · Trust Boundary
서로 다른 신뢰 수준 사이에서 데이터나 제어가 이동하며 입력 검증·인가·출력 제한 같은 재검증 책임이 시작되는 경계입니다.
RAG 검색 지표
다른 이름: 검색 Recall@K · 검색 근거 재현율@K · Retrieval Recall at K
질문의 정답 근거로 표시한 Document Chunk 중 상위 K 검색 결과에서 찾은 Document Chunk의 비율입니다.
RAG 검색 지표
다른 이름: 문맥 정밀도 · Context 정밀도 · RAG Context Precision
검색해 모델에 제공한 Document Chunk가 질문 해결에 유용하고 상위에 잘 배치되었는지 보는 지표입니다.
RAG 생성 지표
다른 이름: 근거 충실도 · Answer Faithfulness
생성 답변의 주장 중 제공된 근거로 뒷받침되는 주장의 비율로 운영 정의한 RAG 생성 지표입니다.
RAG 생성 평가
다른 이름: 답변 근거성 · 근거 기반성 · Answer Groundedness
답변이 제공된 자료에 근거하는 정도를 평가하는 넓은 이름입니다. 도구에 따라 주장 뒷받침 비율·근거와의 모순·출처 연결 등 포함 범위와 계산법이 다르므로 도구·버전·운영 정의를 점수와 함께 기록해야 합니다.
AI 기능 조합
다른 이름: 음성 AI · 음성 인공지능 · Voice Artificial Intelligence
음성 입력을 이해 가능한 표현으로 바꾸고 AI 결과를 음성으로 돌려주는 입출력 경로와 대화 수명주기를 묶은 기능입니다.
음성 수명주기
다른 이름: 음성 Session · 음성 대화 세션 · Voice Conversation Session
한 사용자와 음성 서비스의 연결·권한·여러 Turn·재연결 상태를 묶는 대화 범위입니다.
음성 처리 단위
다른 이름: 음성 대화 Turn · Voice Conversation Turn
사용자 말의 시작·종료부터 STT·답변 생성·TTS·재생 종료까지를 묶는 한 번의 대화 처리 단위입니다.
음성 데이터 단위
다른 이름: 오디오 프레임 · 음성 프레임 · Audio Frame
일정한 샘플 수나 짧은 시간 구간의 음성 신호를 처리하기 위해 묶은 데이터 단위입니다.
음성 분석
다른 이름: 음성 활동 감지 · Voice Activity Detection
짧은 Audio Frame에 사람의 말소리가 있는지 판정해 발화 활동 구간을 찾는 기능입니다.
Turn 경계 판정
다른 이름: 발화 종료 판정 · Turn Endpointing · Speech Endpointing
VAD·음소·문장 맥락·침묵 시간을 함께 보고 사용자의 한 발화 Turn이 끝났는지 판정하는 과정입니다.
음성 UX
다른 이름: 끼어들기 · 사용자 끼어들기 · Voice Barge-in
AI 응답이 생성 또는 재생 중일 때 사용자의 새 발화를 감지해 기존 Turn을 중단하고 새 Turn을 시작하는 동작입니다.
CI/CD 플랫폼
다른 이름: Actions · GHA · GitHub Actions
GitHub 저장소의 사건에 따라 CI Workflow를 실행해 검사·Build·Package·전달을 자동화하는 플랫폼입니다.
Workflow 실행 코드
다른 이름: 재사용 GitHub Action · GitHub Action
Workflow Step에서 특정 작업을 수행하도록 입력·출력·실행 코드를 패키지한 재사용 단위입니다.
Workflow Step 재사용
다른 이름: Composite GitHub Action · 복합 Action · GitHub Composite Action
한 CI Job 안에서 함께 반복하는 여러 Workflow Step을 입력·출력이 있는 GitHub Action 하나로 묶는 재사용 방식입니다.
Workflow 재사용
다른 이름: 호출형 Workflow · 재사용 Workflow · GitHub Actions Reusable Workflow
여러 CI Job·CI Runner·권한·Environment를 포함한 Workflow 전체를 명시한 입력과 출력으로 다른 Workflow에서 호출하는 재사용 경계입니다.
CI 실행 단계
다른 이름: Workflow 실행 단계 · GitHub Actions Workflow Step
CI Job의 같은 CI Runner 작업 폴더에서 명령줄 명령이나 GitHub Action 하나를 순서대로 실행하는 최소 단계입니다.
CI Runner
다른 이름: GitHub 호스팅 Runner · GitHub-hosted Runner
GitHub이 Job마다 관리된 실행 환경을 제공하고 Job 종료 후 폐기하는 Runner 유형입니다.
CI Runner
다른 이름: 자체 호스트 Runner · Self-hosted Runner
팀이 소유·설치·보안 갱신·격리하는 장비에서 CI Job을 실행하는 Runner 유형입니다.
CI 시작 조건
다른 이름: Workflow 시작 조건 · GitHub Actions Workflow Trigger
원격 변경·Pull Request·수동 요청·시간표 같은 저장소 사건이 Workflow Run을 생성하는 시작 규칙입니다.
on.push · on.pull_request · workflow_dispatch event
CI 실행 범위
다른 이름: Workflow 트리거 Filter · GitHub Actions Event Filter
Workflow Trigger가 받은 저장소 사건 중 Branch·Tag·Path 조건에 맞는 변경만 Workflow Run으로 만드는 선택 규칙입니다.
Branch Filter · Tag Filter · Path Filter
CI 동시성 제어
다른 이름: Actions 동시성 제어 · GitHub Actions Concurrency
같은 Branch·PR·배포 대상의 Job 또는 Workflow Run이 동시에 충돌하지 않게 대상별 묶음으로 대기·취소를 제어하는 규칙입니다.
concurrency.group · cancel-in-progress
CI 정책
다른 이름: 품질 Gate · 전달 관문 · Delivery Quality Gate
정한 Quality Check과 승인이 통과해야 Merge·Package·Deploy 다음 단계로 진행하도록 막는 전달 정책입니다.
산출물 저장
다른 이름: 산출물 Registry · Artifact Registry
버전·Artifact Digest·부가 정보가 있는 빌드 산출물을 저장하고 권한 있는 환경으로 전달하는 저장소입니다.
Container Image Registry · Package Registry
빌드 가속
다른 이름: 빌드 Cache · Build Cache
의존성·Compiler·컨테이너 Layer 같은 재생성 가능한 중간 결과를 키로 보관해 반복 Build 시간을 줄이는 Cache입니다.
Dependency Cache · Compiler Cache · Container Layer Cache
전달 식별
다른 이름: 릴리스 식별자 · Release Identity
Git Commit ID·Artifact Digest·Workflow Run·설정판 식별자를 연결해 운영 실행물의 출처를 되찾게 하는 식별 묶음입니다.
Git Commit ID + Workflow Run ID + Artifact Digest
다른 이름: Build Once Deploy Many · 한 번 Build해 승격 · Build Once and Promote Many
한 번 검증해 만든 불변 산출물을 다시 Build하지 않고 여러 환경으로 순차 승격하는 전달 원칙입니다.
CI 자격 정보
다른 이름: Actions Secret · GitHub Actions Secret
Workflow Run에 제한적으로 주입하도록 GitHub에 암호화해 저장한 민감한 실행 값입니다.
Organization Secret · Repository Secret · Environment Secret
다른 이름: Actions Variable · GitHub Actions Configuration Variable
Workflow에서 사용할 비민감 설정값을 저장소·조직·환경 범위로 저장한 값입니다.
Organization Variable · Repository Variable · Environment Variable
디버깅 산출물
다른 이름: 소스 맵 · Source Map
압축·변환된 JavaScript 위치를 원본 소스 파일·줄·열로 역변환하는 Build 산출물입니다.
app.js.map
실행 기반
다른 이름: Infra · 인프라 · Service Infrastructure
서비스 Process가 통신·실행·저장·확장·복구되도록 제공하는 연산·네트워크·저장·운영 자원 전체입니다.
Cloud 운영 모델
다른 이름: Cloud 공동 책임 모델 · Cloud Shared Responsibility Model
클라우드 공급자와 사용 팀이 물리 기반·Runtime·데이터·Identity·설정·복구 계층의 책임을 나누는 모델입니다.
Cloud 서비스
다른 이름: 관리형 서비스 · Cloud Managed Service
클라우드 공급자가 하드웨어·설치·보안 갱신·가용성 일부를 운영하고 사용 팀이 데이터·접근·Configuration을 담당하는 서비스입니다.
Cloud 지리 경계
다른 이름: 클라우드 리전 · Cloud Deployment Region
클라우드 공급자가 서비스를 제공하는 큰 지리·운영 범위로, 공급자와 서비스에 따라 하나 이상의 Availability Zone 또는 다른 장애 분리 범위를 포함할 수 있습니다.
Cloud 장애 경계
다른 이름: AZ · 가용 영역 · Availability Zone
하나의 Cloud Region 안에서 전력·네트워크·물리 장애가 다른 가용 영역으로 전파되지 않도록 분리한 운영 범위입니다.
Cloud 네트워크 비용
다른 이름: Cloud Data Egress · 클라우드 외부 전송 · Cloud Network Egress
클라우드 네트워크 경계 밖이나 다른 Cloud Region·Availability Zone·공급자로 나가는 데이터 전송과 그에 따른 비용입니다.
Container 실행 플랫폼
다른 이름: Docker 실행 엔진 · Docker Engine
컨테이너 이미지를 Build·저장하고 그 이미지를 격리된 컨테이너 프로세스로 실행하도록 요청 API와 백그라운드 관리 프로그램을 제공하는 플랫폼입니다.
Container Build 계약
다른 이름: Docker 이미지 빌드 파일 · Dockerfile
기준 컨테이너 이미지에 파일·의존성·실행 사용자·시작 명령을 순서대로 적용해 Docker 호환 컨테이너 이미지를 만드는 선언 파일입니다.
Container 실행 도구
다른 이름: Compose · Docker Compose
Compose 파일에 선언한 여러 격리 실행본의 이미지·네트워크·볼륨·포트·환경 설정·상태 확인 관계를 함께 실행하는 도구입니다.
compose.yaml
Container 네트워크
다른 이름: 컨테이너 네트워크 · Container Network
컨테이너별 네트워크 Interface·DNS 이름·연결 범위를 정해 서비스 사이 통신을 격리하는 가상 네트워크입니다.
Docker Network · Compose 기본 Network
Container 지속 저장
다른 이름: 컨테이너 Volume · Container Volume
소프트웨어 Container의 쓰기 가능한 Container Image Layer와 분리해 재생성·공유할 데이터를 그 실행본 수명 밖에 보존하는 저장 공간입니다.
Docker Volume
Container Build 패턴
다른 이름: 다중 단계 Build · Docker Multi-stage Build
Build Tool과 임시 파일을 사용하는 Stage와 최종 Runtime Stage를 나누어 필요한 산출물만 최종 Container Image에 복사하는 Build 패턴입니다.
Builder Stage · Runtime Stage
Proxy 대상
다른 이름: Upstream Server · 뒷단 서버 · Reverse Proxy Upstream
Reverse Proxy가 외부 요청을 전달할 내부 Application Server 또는 서비스 대상입니다.
배포 전략
다른 이름: Rolling Update · 순차 교체 · Rolling Deployment
기존 실행본을 일부씩 새 실행본으로 교체하며 트래픽 처리 용량을 유지하는 배포 전략입니다.
다른 이름: Blue/Green · 블루그린 배포 · Blue-green Deployment
현재 환경과 독립된 새 환경을 동등한 실행 계약과 전환 후 트래픽을 감당할 충분한 용량으로 준비·검증한 뒤 Reverse Proxy·Load Balancer의 트래픽 대상을 전환하는 배포 전략입니다.
다른 이름: 혼합 버전 호환성 · Mixed-version Compatibility
배포 중 새 버전과 하나 이상의 이전 버전이 동시에 실행될 때 API·DB·메시지·Job을 서로 안전하게 처리하는 능력입니다.
DB 배포 패턴
다른 이름: Expand-Contract · Expand/Contract · Expand and Contract Migration
새 DB 구조를 먼저 추가해 옛·새 코드가 공존하게 한 뒤 전환을 완료하고 예전 구조를 제거하는 변경 패턴입니다.
분산 작업 조정
다른 이름: Job Lease · 작업 임대 · Distributed Work Lease
작업 실행자가 제한된 기간 동안 특정 작업을 처리할 권한을 얻고 만료 전 갱신하는 시간 제한 소유권입니다.
분산 조정
다른 이름: Leader 선출 · 리더 선출 · Distributed Leader Election
복수 실행본 중 현재 한 실행본만 Scheduler·조정 작업을 담당하도록 임기와 신원을 합의하는 과정입니다.
Container 자원 계약
다른 이름: 컨테이너 자원 상한 · Container Resource Limit
소프트웨어 컨테이너가 사용할 수 있는 CPU·Memory 등의 최대 자원 범위를 Runtime에 설정한 계약입니다.
Container Memory Limit · Container CPU Limit
메모리 부족 상태
다른 이름: OOM · 메모리 부족 조건 · Out-of-Memory Condition
Process 또는 격리된 실행 경계가 요청한 메모리를 더 확보하지 못한 실행 조건입니다. 아직 특정 Process가 종료됐다는 뜻은 아닙니다.
운영체제 종료 동작
다른 이름: 메모리 부족 강제 종료 · Out-of-Memory Kill
OOM 조건에서 메모리를 회수하기 위해 운영체제가 선택한 Process를 강제로 끝내는 동작입니다.
Container 실패 상태
다른 이름: 컨테이너 메모리 강제 종료 상태 · Out-of-Memory Killed Container State
OOM Kill로 Process가 종료된 사실을 컨테이너 Runtime이 기록한 실패 결과 상태입니다.
서비스 용량 제어
다른 이름: 자동 확장 · 자동 용량 조절 · Service Autoscaling
요청 동시성·Queue 길이·지연 같은 포화 신호에 따라 서비스 실행본 수나 할당 용량을 정한 최소·최대 범위 안에서 자동 조절하는 방식입니다.
프로세스 메모리 영역
다른 이름: Application Heap · 애플리케이션 힙 · Application Process Heap
언어 Runtime이 애플리케이션 객체와 값의 할당·회수를 주로 관리하는 프로세스 메모리 영역입니다.
프로세스 메모리 측정
다른 이름: RSS · Resident Set Size · 프로세스 점유 메모리 · Process Resident Set Size
운영체제가 현재 물리 메모리에 올라와 있다고 보고하는 한 프로세스의 메모리 양입니다.
Cloud 네트워크
다른 이름: 가상 사설 Cloud · Virtual Private Cloud
클라우드에서 주소 범위·하위 네트워크 구간·Network Route·Firewall·전달 장치를 팀이 논리적으로 격리해 구성하는 가상 네트워크입니다.
네트워크 전달 규칙
다른 이름: 네트워크 라우팅 규칙 · Network Routing Rule
패킷의 목적지 주소 범위에 따라 다음 전달 장치·Interface·네트워크로 보낼 곳을 선택하는 규칙입니다.
VPC Route Table 항목
Network 연결 방향
다른 이름: Inbound 연결 · 인바운드 연결 · 들어오는 연결 · Inbound Network Connection
외부의 클라이언트나 네트워크가 우리 자원 쪽으로 새로 시작하는 연결 방향입니다.
Network 연결 방향
다른 이름: Outbound 연결 · 아웃바운드 연결 · 나가는 연결 · Outbound Network Connection
우리 실행본이 외부 API나 저장소 같은 바깥 목적지로 새로 시작하는 연결 방향입니다.
네트워크 주소 범위
다른 이름: CIDR 블록 · CIDR 주소 블록 · Classless Inter-Domain Routing Block
IP 주소와 접두 길이로 하나의 연속된 네트워크 주소 블록을 표현하는 표기입니다.
10.0.0.0/24
Cloud Subnet
다른 이름: 공개 Subnet · Public Subnet
Internet Gateway로 가는 Network Route를 가지고 정책이 허용하면 공개 주소로 Internet 통신이 가능한 Subnet입니다.
Cloud Subnet
다른 이름: 비공개 Subnet · Private Subnet
Internet Gateway에서 새 연결이 직접 들어오는 Network Route를 두지 않고 내부·NAT Gateway·Private Endpoint 경로를 사용하는 Subnet입니다.
Cloud Firewall
다른 이름: SG · 보안 그룹 · Cloud Security Group
클라우드 자원에 연결해 프로토콜·포트·출발지·목적지 기준으로 인·아웃 트래픽을 허용하는 상태 기반 Firewall 규칙 묶음입니다.
Network Firewall
다른 이름: 네트워크 접근 제어 목록 · Stateless Network Access Control List
연결 상태를 기억하지 않고 출발지·목적지·통신 규칙(번호)·포트별 패킷 허용·거절을 각 방향에서 따로 판정하는 네트워크 규칙 목록입니다.
Cloud 네트워크 게이트웨이
다른 이름: 네트워크 주소 변환 Gateway · Network Address Translation Gateway
Private Subnet의 여러 자원이 공용 Public Address를 통해 Internet 연결을 먼저 시작하도록 주소·포트를 변환하는 Gateway입니다.
Infrastructure 관리 방식
다른 이름: Infrastructure Code · 인프라 코드화 · Infrastructure as Code
네트워크·연산·Identity·저장 자원의 원하는 상태를 버전 관리·Review·적용 계획·적용 가능한 코드로 관리하는 방식입니다.
Infrastructure 상태 차이
다른 이름: 인프라 설정 Drift · 인프라 표류 · Infrastructure Configuration Drift
실제 Infrastructure 상태가 버전 관리에 선언한 원하는 상태와 수동 변경·자동 조정·실패로 달라진 차이입니다.
운영 설계 목표
다른 이름: 고가용성 · High Availability
일부 실행본·Zone·의존성이 실패해도 서비스를 사용 가능한 상태로 유지하려는 운영 설계 목표입니다.
복구 계획
다른 이름: 재해 복구 · Disaster Recovery
리전 손실·대규모 데이터 손상·장기 중단 같은 큰 장애 후 정한 RPO·RTO 안에 별도 절차로 서비스를 복구하는 계획입니다.
관측 신호
다른 이름: 메트릭 · 지표 데이터 · Telemetry Metric
요청 수·오류율·지연·메모리 같은 시스템 상태를 시간과 Label 차원으로 집계한 숫자 신호입니다.
관측 신호
다른 이름: Log · 로그 · 애플리케이션 로그 · Application Log
특정 시점에 일어난 사건과 서비스·환경·Release·HTTP Request 문맥을 남긴 기록으로, 자유 문장 또는 구조화된 필드 형태일 수 있습니다.
관측 신호
다른 이름: 분산 Trace · 요청 추적 · Distributed Trace
한 요청이 Proxy·서비스·DB·Queue·외부 API를 지나며 만든 Span을 하나의 인과 흐름으로 연결한 기록입니다.
Trace 단위
다른 이름: 트레이스 구간 · Operation Span · Trace Span
Trace 안에서 한 Operation의 시작·종료·상태·속성·Parent 관계를 기록한 실행 구간입니다.
오류 운영 체계
다른 이름: Error Monitoring · 에러 추적 · Application Error Tracking
같은 예외를 하나의 오류 묶음으로 묶고 Stack·Release·Environment·영향 범위를 연결해 반복 오류를 관리하는 체계입니다.
관측 표준·도구
다른 이름: OTel · 오픈텔레메트리 · OpenTelemetry
Metric·Application Log·Trace를 생성·문맥 전파·수집·전송하는 Vendor-neutral API·SDK·Semantic Convention·OpenTelemetry Collector 생태계입니다.
Telemetry 전송 프로토콜
다른 이름: OpenTelemetry Protocol
OpenTelemetry 신호와 부가 정보를 SDK·OpenTelemetry Collector·관측 Backend 사이에서 전송하는 gRPC·HTTP 기반 프로토콜입니다.
Telemetry 프로세스
다른 이름: OTel Collector · OpenTelemetry Collector
여러 신호를 OTel Receiver로 받아 배치·필터·속성 추가·표본 선택 후 OTel Exporter로 관측 Backend에 전달하는 프로세스입니다.
관측 생성
다른 이름: Telemetry 계측 · Telemetry 인스트루멘테이션 · Telemetry Instrumentation
Application·Library·Runtime에서 언제 어떤 Metric·Log·Span을 어떤 속성으로 생성할지 코드와 설정으로 정하는 활동입니다.
분산 관측 계약
다른 이름: 분산 문맥 전파 · Distributed Context Propagation
W3C Trace Context의 부모 관계·추적 선택 정보와 허용한 OpenTelemetry Baggage를 HTTP·gRPC·메시지 경계에서 전달·복원하는 메커니즘입니다.
traceparent header · baggage header
분산 추적 전달 형식
다른 이름: 분산 추적 문맥 · W3C Trace Context
분산 Trace 식별값·부모 Span 식별값·추적 선택 정보를 HTTP Header로 전달하는 표준 문맥 형식입니다.
traceparent · tracestate
분산 문맥 키–값
다른 이름: 분산 문맥 Baggage · OpenTelemetry Baggage
서비스 경계를 넘어 함께 전달하도록 애플리케이션이 선택한 추가 키–값 문맥입니다. 자동 인증·권한 부여나 안전한 비밀 저장소가 아닙니다.
Telemetry 식별 속성
다른 이름: OpenTelemetry 자원 속성 · OpenTelemetry Resource Attributes
OpenTelemetry Resource가 나타내는 서비스·환경·Release·리전·Instance 같은 생성 주체의 정체성을 신호에 공통으로 부여한 속성 모음입니다.
service.name · deployment.environment.name · service.version
Collector Component
다른 이름: OpenTelemetry Receiver · OpenTelemetry Collector Receiver
OpenTelemetry Collector에서 OTLP·Prometheus·Log 등의 신호를 특정 Protocol·Format으로 받는 입력 Component입니다.
Collector Component
다른 이름: OpenTelemetry Exporter · OpenTelemetry Collector Exporter
OpenTelemetry Collector에서 처리한 신호를 OTLP·Vendor API·Storage 형식으로 관측 Backend에 보내는 출력 Component입니다.
Metric 시스템
다른 이름: 프로메테우스 · Prometheus
수집 대상의 Metric Endpoint를 주기적으로 Scrape해 시계열로 저장하고 PromQL 질의·경보 규칙 평가를 제공하는 시스템입니다.
Metric 수집
다른 이름: Prometheus Metric Scrape · Prometheus Scrape
Prometheus가 설정된 Target의 HTTP Metric Endpoint를 주기적으로 읽어 샘플과 Metric Label을 시계열로 저장하는 수집 동작입니다.
Metric 유형
다른 이름: Metric Counter · 메트릭 누적 계수기 · Monotonic Metric Counter
Process 수명 동안 보통 증가만 하고 Reset 전후의 증가량으로 요청·오류·작업 수를 측정하는 Metric 유형입니다.
Metric 유형
다른 이름: Metric Gauge · 게이지 메트릭
현재 Queue 길이·메모리·온도·실행 수처럼 증감할 수 있는 시점 상태를 표현하는 Metric 유형입니다.
현재 Queue 길이 · 현재 메모리 사용량
Metric 유형
다른 이름: Metric Histogram · 메트릭 히스토그램
지연·크기 같은 여러 관측값의 분포를 집계하는 Metric 유형입니다. 이 강의의 Prometheus Classic Histogram은 설정한 Bucket의 누적 개수와 전체 개수·합으로 그 분포를 노출합니다.
Metric 차원
다른 이름: Metric Dimension · 메트릭 차원 · 메트릭 레이블 · Metric Label
하나의 Metric을 Method·Route·Status·리전 같은 유한한 분류별 시계열로 나누는 키–값 속성입니다.
method=GET · status=200
Metric 비용 특성
다른 이름: Metric 시계열 조합 수 · 메트릭 카디널리티 · Metric Time-series Cardinality
Metric 이름과 모든 Label 키–값의 고유 조합이 만드는 시계열의 수입니다. 한 Label에서 서로 다른 값의 개수만 세는 Label Cardinality와 분모가 다릅니다.
Log 형식
다른 이름: 구조화 Log · Structured Log
Event·Level·Timestamp·서비스·Release·Trace ID·허용된 문맥을 고정 필드와 Type으로 기록한 Log입니다.
고정 필드의 JSON object로 인코딩한 Log
Trace 비용 제어
다른 이름: Trace 표본 추출 · Distributed Trace Sampling
모든 요청의 Trace 전체를 보존하지 않고 정한 규칙으로 일부를 선택해 비용과 조사 가능성을 조절하는 방식입니다.
Trace Sampling
다른 이름: Head-based Sampling · 시작 표본 추출 · Head-based Trace Sampling
Trace 시작 시점의 확률·주체·Route 정보로 해당 Trace를 기록할지 먼저 결정하는 Sampling 방식입니다.
Trace Sampling
다른 이름: Tail-based Sampling · 종료 표본 추출 · Tail-based Trace Sampling
Trace의 Span과 오류·지연 결과를 일시 모은 뒤 전체 결과로 보존 여부를 결정하는 Sampling 방식입니다.
Monitoring 판정 규칙
다른 이름: 운영 경보 규칙 · Operational Alert Rule
관측 질의·경계·지속 시간과 발생할 Alert의 심각도·설명·Runbook 연결을 버전 관리한 설정입니다.
운영 통지
다른 이름: 운영 경보 · Operational Alert
Alert Rule의 조건이 충족되어 사용자 영향 확인과 조치가 필요함을 담당자·심각도·Runbook 문맥과 함께 알리는 상태 또는 통지입니다.
관측 실패 상태
다른 이름: No Data · 데이터 없음 · No Data State
서비스 값이 0인 것이 아니라 Prometheus Scrape·관측 질의·OpenTelemetry Collector·데이터 소스에서 평가할 시계열·샘플이 없는 상태입니다.
신뢰성 측정
다른 이름: 서비스 수준 지표 · Service Level Indicator
성공률·지연·신선도·정확성처럼 사용자 경험의 신뢰성을 정량화한 측정 정의와 값입니다. 이 강의에서는 정한 기준을 만족한 Good Event를 유효한 Event로 나눈 비율형 SLI를 사용합니다.
신뢰성 목표
다른 이름: 서비스 수준 목표 · Service Level Objective
특정 기간에 정의한 SLI가 달성해야 할 목표 비율·경계·시간 창입니다.
신뢰성 협약
다른 이름: 고객 서비스 수준 협약 · Product Service Level Agreement
서비스 제공자와 고객 사이에 제공 수준·측정·예외·미달성 보상을 포함해 정한 외부 약속입니다.
신뢰성 판단
다른 이름: 오류 예산 · 신뢰성 예산 · Service Error Budget
SLO 목표 기간에 허용한 전체 불량 Event 비율·시간에서 이미 사용한 분량을 뺀 남은 신뢰성 여유입니다.
SLO 경보 지표
다른 이름: 오류 예산 소진 속도 · Error Budget Burn Rate
현재 불량 Event가 SLO 기준으로 허용된 Error Budget을 정상 소진 속도보다 몇 배 빠르게 소비하는지 나타낸 값입니다.
운영 사건
다른 이름: 운영 장애 · 서비스 Incident · Service Incident
서비스 사용자 영향이 발생해 탐지·완화·복구·소통·사후 학습을 조정해야 하는 운영 사건입니다.
운영 절차
다른 이름: 운영 절차서 · 운영 대응 절차 · Operational Runbook
특정 Alert·Incident 또는 반복 운영 작업에서 영향 확인·안전한 진단·완화·에스컬레이션·종료 증거를 순서대로 적은 운영 절차서입니다.
Incident 학습
다른 이름: Incident 사후 분석 · 장애 회고 · Incident Postmortem
Incident의 영향·시간 순서·탐지·완화·시스템 요인·소유자와 기한이 있는 개선 작업을 비난 없이 정리한 학습 기록입니다.
운영 실패 패턴
다른 이름: 경보 피로 · Alert Fatigue
조치 불가·중복·잦은 오탐 Alert가 지속되어 담당자가 중요한 신호에 느리게 반응하거나 무시하게 되는 운영 상태입니다.