Glossary

Also known as: API · endpoint contract · API agreement

An agreement that makes a provider and its consumers interpret inputs, outputs, authorization, errors, and state in the same way. It owns the observable boundary rather than a screen or implementation shape.

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

Also known as: idempotent · duplicate request safety · retry safety

The property that repeated processing of the same intent converges on the same observable business state as one processing. It limits duplicate effects instead of pretending retries do not happen.

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

Also known as: SSOT · source ownership · one authoritative source

A principle that gives one authoritative source the meaning and write authority for a fact while treating other representations as derived state. It clarifies ownership and synchronization boundaries; it does not mean copies never exist.

notes/ · courses/ · apps/console/sql/

Also known as: DB migration · schema migration · DDL change

A versioned change that moves operational data structures or constraints from one state to the next. Successful SQL syntax is a separate judgment from compatibility and recoverability.

CREATE INDEX CONCURRENTLY · forward fix

Also known as: rate limiting · request quota · call limit

A policy that limits request volume by time, subject, or route to protect resources and external spend. The contract includes the exceeded response and retry guidance, not just a number.

60 requests / minute · HTTP 429

Also known as: caching · cache hit · cache miss

A way to store a reusable copy of a result to reduce latency and source load. A cache hit proves speed, not freshness, authorization, or consistency.

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

Also known as: SSE · EventSource · server events

A contract where a server keeps an HTTP connection open and sends text events to a client in one direction. Separate the wake-up signal from business data and define a reconnect cursor.

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

Also known as: TURN cost gate · video chat cost gate · WebRTC spend gate

A rule that separates WebRTC feature code from operational entry points and keeps expensive TURN, SFU, and video paths disabled until an explicit configuration and cost approval exist.

WEBRTC_VOICE_ENABLED=false · TURN·SFU·video disabled

Also known as: Fixture · test setup data · repeatable test state

A small bundle of input, state, and doubles prepared so one test can be reproduced under the same conditions. It differs from an evaluation dataset that represents an operational distribution.

seeded PostgreSQL row · temporary upload file

Also known as: S3 · object store · object storage

A system that stores large file bytes under an object key with metadata. Storage success is not the same as business completion or authorization verification.

bucket/object-key · presigned URL

Also known as: capability file · Tauri permission · Tauri capability

An explicit boundary that groups the commands and permissions available to a Tauri window. It grants only the needed capabilities instead of opening a local server or filesystem broadly for convenience.

core:default · block localhost:8000

Also known as: 개발 주기 · 개발 루프

사용자 문제를 정하고 변경을 검증·전달·관찰한 뒤 그 증거로 다음 개선을 고르는 반복 과정입니다. 운영 증거가 다음 판단으로 돌아온다는 점에서는 학습 루프처럼 작동하지만, 모든 학습 활동과 같은 뜻은 아닙니다.

Also known as: 사용자 문제

특정 사용자가 어떤 상황에서 겪는 불편과 줄이려는 결과를 관찰 가능한 말로 표현한 것입니다. 문제를 찾아 표현하는 문제 정의 활동 전체와 그 결과인 사용자 문제를 같은 대상으로 부르지 않습니다.

Also known as: 요구 · 요구사항

사용자나 사업이 시스템에 기대하는 가치·행동·제약을 표현한 합의 대상입니다.

Also known as: 기능 계약 · 개발 계약

입력·출력·권한·오류·상태와 호환 조건을 제공자와 소비자가 같은 뜻으로 해석하도록 정한 약속입니다.

Also known as: 완료 조건 · 인수 기준 · 인수 조건

누가 어떤 상황에서 행동했을 때 무엇이 관찰되어야 완료인지 정상·거절·경계 결과로 적은 조건입니다.

Also known as: ID · Identifier · 식별값 · 식별자

자료나 요청처럼 시스템이 다루는 한 대상을 다른 대상과 구분하고 다시 찾도록 부여한 안정적인 값입니다.

Also known as: Spec · 스펙 · 명세

문제·범위·구체 예·입출력·오류·권한·비기능 조건과 검증 증거를 구현 전에 합의한 기록입니다.

Also known as: Specification-Driven · 명세 주도 개발 · SDD

검증 가능한 명세를 먼저 구체화하고 작업·코드·테스트를 그 완료 기준에 계속 연결하는 개발 방식입니다.

Also known as: Test-Driven · 테스트 주도 개발 · TDD

작은 기대 행동의 실패 테스트를 먼저 확인하고 최소 구현과 안전한 구조 개선을 짧게 반복하는 개발 방식입니다.

Also known as: 실패 단계 · Red

새 기대 행동을 나타내는 테스트가 구현 부족 때문에 올바른 이유로 실패하는지 확인하는 단계입니다.

Also known as: 통과 단계 · Green

현재 실패 테스트를 통과시키는 가장 단순한 구현을 만들어 행동 증거를 확보하는 단계입니다.

Also known as: Refactor · 리팩터링

외부에서 관찰되는 동작을 유지하면서 이름·중복·책임과 구조를 더 이해하기 쉽게 바꾸는 활동입니다.

Also known as: 행동 변경 · 기능 변경

사용자나 다른 시스템이 관찰하는 입력·출력·규칙·상태 중 하나를 바꾸는 변경입니다.

Also known as: 수직 슬라이스 · 수직 절단

가장 작은 사용자 결과가 화면·서버·데이터 경계를 끝까지 통과하도록 기능을 얇게 나누는 방식입니다.

Also known as: 수평 분할 · 계층별 작업

화면이나 데이터베이스처럼 한 기술 계층의 변경을 먼저 크게 묶는 작업 방식입니다.

Also known as: Unit Test · 단위 테스트

작은 규칙이나 객체의 입력과 결과를 빠르고 격리된 조건에서 확인하는 테스트입니다.

Also known as: Integration Test · 통합 테스트

데이터베이스·API·외부 어댑터처럼 둘 이상의 실제 경계가 같은 계약으로 동작하는지 확인하는 테스트입니다.

Also known as: E2E · End-to-End · 종단 간 테스트 · End-to-End Test · E2E Test

사용자 진입점에서 시작해 핵심 업무 결과까지 여러 실제 계층을 통과하는 흐름을 확인하는 테스트입니다.

Also known as: 테스트

주어진 조건에서 시스템이 기대 행동을 보이는지 반복 가능하게 판정하는 증거입니다.

Also known as: 검증문 · 기대값 검증 · Assertion

테스트에서 실제 결과가 기대한 값이나 조건과 맞는지 비교하고, 다르면 그 테스트를 실패시키는 한 개의 판정문입니다.

Also known as: 테스트 우선 · Test-first

구현 전에 호출 방법과 기대 결과를 테스트로 먼저 표현해 설계 피드백을 일찍 얻는 방식입니다.

Also known as: 구현 후 테스트 · Test-after

구현하거나 탐색한 행동을 나중에 테스트로 고정해 회귀를 막고 기존 코드를 안정화하는 방식입니다.

Also known as: JS · 자바스크립트 · JavaScript

브라우저와 서버 프로그램에서 데이터·규칙·입출력 동작을 표현하는 프로그래밍 언어입니다.

Also known as: Node.js Runtime · Node.js

JavaScript 파일과 내장 모듈·테스트 러너를 브라우저 밖에서 실행하는 프로그램입니다. 터미널의 node는 이 실행 프로그램을 호출하는 명령입니다.

node

Also known as: 파이썬 · Python 언어 · Python

데이터 처리·자동화·서버 프로그램의 규칙과 동작을 표현하는 프로그래밍 언어입니다.

Also known as: Python Interpreter · Python 3 실행기

Python 3 언어로 작성한 소스 파일과 표준 라이브러리를 읽어 실행하는 프로그램으로, 이 과정에서는 터미널의 python3 명령으로 호출합니다.

python3

Also known as: 시험 대역 · 테스트 대역

테스트에서 느리거나 통제하기 어려운 실제 협력자를 대신해 정해진 행동을 제공하는 객체의 상위 개념입니다.

Also known as: 모의 객체 · Mock

예상한 호출·인자·순서를 기록하고 검증하도록 만든 테스트 대역입니다.

Also known as: 가짜 구현 · Fake

실제 시스템보다 단순하지만 같은 소유 계약을 실행해 성공·실패 상태를 통제할 수 있는 구현입니다.

Also known as: 요구 추적성 · 추적성

요구나 명세 항목이 어느 작업·코드 변경·테스트·운영 증거로 이어졌는지 되찾는 능력입니다.

Also known as: Build · 빌드

소스와 의존성을 검사·컴파일·묶어 실행하거나 배포할 수 있는 결과를 만드는 과정입니다.

Also known as: Artifact · 산출물 · 빌드 산출물

빌드가 만든 실행 파일·브라우저 번들·배포 묶음처럼 저장하고 환경으로 옮길 수 있는 결과물입니다.

Also known as: 변경 불가 산출물 · 불변 산출물

한 번 식별된 뒤 내용을 바꾸지 않고 같은 바이트를 여러 환경으로 승격하는 산출물입니다.

Also known as: 내용 Digest · 콘텐츠 다이제스트 · Content Digest

정확히 정한 바이트 범위와 알고리즘에서 계산하는 고정 길이 요약값입니다. 내용 동일성 판단의 강도는 선택한 알고리즘과 검증 계약에 달려 있으며, 값만으로 작성 주체나 출처를 증명하지는 않습니다.

Also known as: 산출물 내용 해시 · 산출물 Digest

빌드 산출물의 정확한 바이트 범위에서 계산해 내용 동일성을 확인하는 Content Digest입니다.

Also known as: Deploy · 디플로이 · 배포

선택한 Build Artifact를 특정 실행 환경에 놓고 Process로 실행해 서비스가 요청을 받을 수 있게 하는 사건입니다.

Also known as: Release · 기능 공개 · 릴리스

이미 배포되었거나 준비된 기능·버전을 사용자나 소비자가 실제로 사용할 수 있게 여는 사건입니다.