용어 사전 &para;

객체 object

프로그램 안의 데이터 덩어리다. 속성과 기능(메서드)을 함께 가진다.

검증 validation

들어온 값이 스키마에 맞는지 확인하는 일. 안 맞으면 거절한다. HTTP에서는 보통 422(Unprocessable Entity: 형식은 맞지만 내용이 규칙에 안 맞음)로 돌려준다.

겉 설명서

바깥(여기서는 LLM과 vLLM)에 "이런 모양으로 보내라"고 알려 주는 JSON Schema.

경계

코드·이름 → 면 모양. 예: 행정동 코드 → 동 경계.

공식 API(OpenAPI)

기관이 "이렇게 불러 쓰라"고 공개한 주소. 형식이 잘 안 바뀐다.

공식 계약 API contract

문서로 약속해서 함부로 바꾸지 않는 API. 반대로 인프라 주소는 약속이 아니라 바뀔 수 있다.

공통 키(조인 키)

서로 다른 표에 똑같이 들어 있는 값이다. 구 코드, H3 칸 번호, 시작 시각이 그렇다.

관계 따라가기

user.favorites처럼 속성에 접근하면 JOIN이나 추가 SELECT를 알아서 보낸다.

관계형 DB

데이터를 표(행과 열)로 두는 DB다. PostgreSQL, MySQL이 대표적이다.

권한 permission

"제안 승인", "문의 답변" 같은 행동 하나.

역할 기반 권한 RBAC

끊기면 처음부터

와이파이가 끊기거나 탭을 닫으면 이어 받기가 안 된다.

ㄴ 2

내부 규칙

서버가 실제로 검사할 때 쓰는 모델(pydantic 클래스 등).

논블로킹 I/O non-blocking: 기다리느라 멈추지 않음

요청을 보내 놓고 바로 다음 일로 넘어간다. 응답이 오면 알림을 받는다.

ㄷ 7

다운로드 관리자

브라우저에 들어 있는 다운로드 담당 기능. 페이지와 따로 돈다. 다운로드 표시줄, 일시정지, 이어받기를 맡는다.

단계(노드·태스크)

라인의 기계 하나. 예: "강우 원천을 읽어 정규화하기".

데이터베이스

서로 완전히 분리된 공간이다. 한 연결은 한 데이터베이스에만 붙는다. 그래서 기본적으로 다른 데이터베이스의 표와 JOIN하지 못한다.

도구 호출 파서 tool call parser

모델이 쓴 글을 OpenAI 형식 tool_calls JSON으로 옮기는 서빙 엔진(vLLM 등) 안의 부품.

도구(프레임워크·라이브러리)

그 역할을 실제로 만드는 재료. 예: Next.js, Express, FastAPI.

동기화 sync

다른 시스템의 정보를 우리 표에 맞춰 옮기는 일. 여러 번 반복한다.

동시성 concurrency

여러 일을 번갈아 진행하는 것이다. 일꾼 하나로도 된다.

ㄹ 3

러너 runner: 작업을 실제로 돌리는 임시 서버

실행마다 새로 만들어지고 끝나면 사라진다. 그래서 저장소에 올라온 것만 들고 시작한다.

로그(log)

프로그램이 한 일을 시간순으로 한 줄씩 남긴 기록. 파일에 쓰거나 표준 출력(stdout: 프로그램이 화면으로 내보내는 출력)으로 내보낸다.

룩업(번역 표)

사람이 고른 말을 공통 키 값으로 바꾸는 표다. app.region_code가 "역삼1동"을 1168064000으로 바꾼다.

ㅁ 7

마이그레이션 migration

표 구조 변경을 번호 붙은 SQL 파일로 남기고 순서대로 DB에 적용한다.

지오코딩과 참조 데이터 매칭 · 데이터 원천 간 엔티티 매칭

매칭 키

두 표에 똑같이 들어 있어서 둘을 잇는 값. 강우 예에서는 강우계 이름이다.

맥락 끊김

입력을 조각으로 나눠 따로 처리하면, 각 처리는 다른 조각을 모른다.

메타데이터

데이터에 대한 데이터. 표 이름, 기간, 지역 기준 같은 "설명"이다.

멱등 idempotent: 여러 번 해도 결과가 같음

적재를 두 번 돌려도 줄이 두 배가 되지 않는 성질.

모델 Gemma 등

도구 호출도 "글"로 쓴다.

모듈 module

파이썬 파일 하나. 예: models.py.

ㅂ 11

바뀌는 값(파생 값)

데이터가 늘 때마다 달라진다. 예: 행 수, 보유 기간(가장 이른·늦은 날짜), 마지막 갱신 시각.

반복 상한

한 턴에 최대 10번(앱은 20번).

반복 실패 감지 _first_repeated_failure

이미 실패한 호출과 이름·인자가 글자 하나까지 같으면 턴을 끊는다. 이때 422 "The assistant repeated a failing tool call."이 나간다.

배포 이름과 import 이름

설치할 때 이름과 코드에서 부르는 이름은 다를 수 있다. 오늘은 저장소가 dhub2-manager이고, import 이름은 dhub2다.

백엔드

서버 컴퓨터에서 도는 코드다. 이용자는 결과만 받는다.

범용 API

특정 화면이 아니라 여러 서비스를 위한 API. 여기서는 dhub2-manager다.

베셀(Bessel) 타원체

옛 한국 측지계. 옛 좌표계(5174, 2097 등)가 쓴다.

변경 추적 change tracking

객체 값만 바꾸고 save()하면, 무엇이 바뀌었는지 보고 UPDATE를 만든다.

병렬성 parallelism

여러 일을 정말 같은 순간에 하는 것이다. CPU 코어가 여럿 있어야 한다.

브랜치 branch

커밋 줄기에 붙인 이름표. 보통 main.

블로킹

비교할 쌍을 미리 줄이는 일

ㅅ 18

사용량 한도

구독이든 API든 일정 기간 쓸 수 있는 양이 정해져 있다. 큰 작업이 한도를 먼저 써 버리면 실패하거나 다른 작업이 막힌다.

사전 /semantic/dictionaries

열 값의 정식값·라벨·동의어.

상태(status)

작업이 어디까지 왔는지. 보통 queued(대기) → running(처리 중) → done(완료) 또는 failed(실패).

생산자(producer)

큐에 작업을 넣는 쪽. 여기서는 BFF(Next.js 서버)다.

서명 쿠키 signed cookie

서버만 아는 비밀 키로 서명한 쿠키. 사용자가 내용을 바꾸면 서명이 안 맞아 거절된다.

서버(클러스터)

PostgreSQL 프로그램 하나가 관리하는 데이터베이스 묶음이다. 쿠버네티스의 "클러스터"와는 다른 뜻이다.

세션 session: 로그인 상태를 요청마다 이어 가는 방법

그 토큰을 받은 뒤에 정한다.

스레드 thread

코드를 한 줄씩 실행하는 일꾼 하나다.

스크래핑(scraping)

HTML(웹 페이지 원문)에서 필요한 값을 뽑아내는 일.

LLM 도구 호출(function calling) 흐름 · PostgreSQL 데이터베이스와 스키마 · 스키마 기반 입력 검증과 타입 변환

스키마 schema: 인자 양식

어느 칸에 어떤 타입이 들어가는지. JSON Schema(JSON 구조를 설명하는 표준 문법)로 쓴다.

스키마 정의

표 구조를 코드로 적는다.

스테이징 staging, git add

다음 커밋에 넣을 변경을 골라 두는 대기 칸.

스트리밍(streaming)

끝이 정해지지 않은 데이터를 생기는 대로 흘려보내는 방식.

시드 데이터 seed data: 씨앗 데이터

서비스가 동작하려면 처음부터 있어야 하는, 사람이 정해 넣는 기본 값. 예: 재난 종류 목록, 관리자 그룹.

시맨틱 테이블 /semantic/tables

열(라벨, 동의어, 거르기·묶기 가능 여부), 지표, 이름 붙인 필터, 조인.

식별자(ID)

원천 안에서만 레코드를 구분하는 번호. 원천마다 체계가 다르다.

신원 위임

받은 Authorization 헤더를 그대로 다음 단계에 넘기는 것. 그래서 두 경로 모두 같은 신원으로 질의한다.

실행(run)

파이프라인을 한 번 처음부터 끝까지 돌리는 것. 실행마다 기록(언제, 성공했나)이 남는다.

ㅇ 21

앱 서버(애플리케이션 서버)

요청을 받아 규칙대로 처리하는 프로그램이다. 로그인 확인, 권한 확인, SQL 조립, 결과 합치기를 한다. 그날 구조에서는 Next.js 서버가 이 일을 맡는다.

업서트 upsert: update + insert

"있으면 고치고 없으면 넣기". 멱등하게 만드는 흔한 방법이다.

에어갭 air-gap: 외부 인터넷이 끊긴 폐쇄망

이미지·차트·실행 파일을 미리 한 묶음(번들)으로 싸 가야 한다.

에이전트 agent

모델 호출 → 도구 실행 → 결과 전달을 반복하는 프로그램이다.

엔티티

기억해야 할 대상. 보통 표 하나가 된다(사람, 데이터셋, 즐겨찾기).

ERD 관계와 카디널리티(1:N)

엔티티 매칭

서로 다른 원천의 레코드가 같은 엔티티인지 판정해 짝짓는 일. record linkage(레코드 연결), entity resolution이라고도 한다.

엔티티(entity)

데이터가 가리키는 현실의 대상 하나. 건물 한 동, 교량 하나.

열 저장(OLAP)

[1,2,3], [강남,서초,강남], [3,5,2]처럼 열 단위로 둔다. "구별 건수 합계"는 두 열만 읽으면 된다. 같은 값이 이어져 압축도 잘 된다.

우리 것

plan, items, payload, nullable 같은 칸 이름과 중첩 구조.

JSON Schema 규약과 해석

워커(worker)

큐에서 작업을 꺼내 실제로 처리하는 프로그램. 항상 떠 있다.

원격 저장소 remote

다른 곳(GitHub, 사내 서버)에 있는 같은 저장소. 로컬에는 별명과 주소만 등록한다. 관례상 별명은 origin.

데이터 쓰기 방식: 전체 교체·파티션 교체·append·upsert

원천 source: 바깥에서 수집해 온 데이터

지나간 시점의 값은 다시 가져올 수 없는 경우가 많다. 그래서 이력을 지키는 책임이 여기 있다.

원천(source)

데이터를 내놓는 시스템. 예: FMS(시설물통합정보관리시스템), 건축HUB 건축물대장, GIS건물통합정보, 안전정보 통합공개.

위치 사전

ID → 점 좌표. 예: 강우계 이름 → 위도·경도.

의존성 dependency

내 프로젝트가 돌려면 필요한 다른 패키지.

이벤트 루프 event loop

할 일 목록을 계속 돌면서 준비된 일을 하나씩 처리하는 반복문이다. 테이블을 순회하는 웨이터와 같다.

이용 데이터 트랜잭션 데이터라고도 함

사람이 서비스를 쓰면서 생기는 기록. 예: 즐겨찾기, 문의.

인가 Authorization

"당신은 이걸 해도 되는가"를 정하는 일. 관리자 여부, 데이터 권한 등.

인벤토리 inventory

어느 서버에, 어떤 값으로 적용할지 적은 파일.

인증 Authentication

"당신은 누구인가"를 확인하는 일. OIDC가 하는 일이다.

입력 표 / 출력 표

단계가 읽는 표와 결과를 쓰는 표.

ㅈ 17

자원을 오래 붙잡음

플랫폼 SQL 창구가 한 번에 1,000행까지라, 50만 행이면 호출이 500번이다.

작업(job)

해야 할 일 하나. 예: "강남구 2020~2025 침수흔적 CSV 만들기".

잠금 파일 lock file: uv.lock 등

실제 설치된 정확한 버전을 기록한 파일.

잠금(lock)

"내가 고치는 동안 다른 사람은 기다려"라는 표시. PG의 SELECT … FOR UPDATE가 행 하나를 잠근다.

저장소 repository, repo

파일과 그 변경 이력을 함께 담은 단위.

전송 압축 HTTP Content-Encoding: gzip

보내는 동안만 압축하고, 받는 쪽에서 풀린다. 디스크에는 원래 크기로 남는다.

정적인 값

한 번 정하면 거의 안 바뀐다. 예: 11680 = 강남구, "대피시설은 norm_civil_shelter 표에 있다", 열 설명.

제약(constraint)

DB가 직접 지키는 규칙. PK(기본 키: 행을 하나로 구별하는 열), UNIQUE(중복 금지), FK(외래 키: 다른 표의 행을 가리키는 열) 등이 있다.

CLI headless 실행과 claude -p

종료 코드 exit code: 끝날 때 남기는 숫자

0이면 성공, 아니면 실패다. 스크립트는 이 숫자로 다음 단계를 정한다.

주의 분산

긴 입력에서 모델은 앞부분과 끝부분을 잘 쓰고 중간이나 뒤쪽을 덜 반영하는 경향이 있다. 연구에서는 "lost in the middle"이라고 부른다.

중간 계층 경유

앱 → API 서버 → 질의 엔진 → DB. 이름은 API 게이트웨이, BFF, 플랫폼 매니저 등 다양하다.

중간 장치의 시간 제한

Ingress·로드밸런서·프록시는 보통 60초 안팎에서 연결을 끊는다.

지리 좌표계

지구 위 위치를 각도(위도·경도, 단위 도)로 나타낸다. 예: EPSG:4326(WGS84 위경도). GPS가 쓰는 방식이다.

지연 로딩 lazy loading

실제로 접근하는 순간에 읽는다. 편하지만 N+1 문제(목록 1번 + 항목마다 1번씩 질의가 나감)의 원인이 된다.

지오코딩(geocoding)

주소·지명 같은 글자를 좌표로 바꾸는 일이다. 반대로 좌표 → 주소는 역지오코딩이다.

직접 질의

앱 → 질의 엔진 → DB. 앱이 SQL을 그대로 보낸다.

진행률·재시도 불가

"40% 진행"을 보여 줄 수 없고, 실패하면 전부 다시 해야 한다.

ㅊ 3

참조 데이터 reference data: 기준이 되는 목록

다른 표가 가리키는 코드표. 예: "11680 = 강남구". 외부 기준 자료에서 한 번 옮겨 온다.

채팅 템플릿 chat template

반대 방향 번역기. 대화와 도구 정의를 모델이 학습한 프롬프트 형식으로 바꾼다. 그 모델의 표기 규칙이 적힌 공식 문서 역할도 한다.

초기 적재 initial load

빈 DB에 처음으로 데이터를 넣는 일 전체. 시드 + 참조 데이터 + 첫 동기화.

ㅋ 5

카디널리티

한쪽 표의 한 줄에 다른 쪽 표의 줄이 몇 개 붙나.

ERD 관계와 카디널리티(1:N)

카탈로그

데이터셋마다 한 줄씩, 무엇이고 어디에 있고 어떻게 거르는지 적은 목록 표다. 대시보드에서는 app.dataset 표다.

커밋 commit

그 시점 파일 상태의 스냅숏(사진)과 메시지, 작성자, 이전 커밋을 묶은 기록 하나.

쿠키 cookie: 서버가 브라우저에 맡겨 두는 작은 값

같은 사이트로 가는 요청마다 브라우저가 알아서 붙인다. <a href>, <img>, 주소창 이동도 마찬가지다.

큐(queue)

작업을 줄 세워 두는 곳. Redis 같은 전용 서버를 쓰기도 하고, DB 표 하나로 대신하기도 한다.

ㅌ 6

타입 변환 coercion: 값을 맞는 타입으로 바꿔 주는 일

"2" → 2처럼 뜻이 분명할 때만 한다.

타입 보존

정수, 실수, 시각, 문자열, NULL(값 없음)을 구분해 저장한다.

타입 복원 type coercion: 값을 원하는 타입으로 바꾸기

글자로 온 값을 스키마에 맞춰 숫자·참거짓으로 고치는 단계.

턴 turn

사용자 질문 하나에 답하기까지의 한 묶음. 그 안에서 모델을 여러 번 부른다.

턴 누적

대화형·에이전트 작업은 턴마다 앞 내용 전체를 다시 입력으로 넣는다. 턴이 늘면 처리 시간과 사용량이 계속 커진다.

투영 좌표계

둥근 지구를 평면에 펼친 뒤 미터 단위 x·y로 나타낸다. 거리·면적 계산이 쉬워 한국 공공데이터가 많이 쓴다.

데이터 쓰기 방식: 전체 교체·파티션 교체·append·upsert

ㅍ 12

파생 결과 derived: 원천을 계산해 만든 데이터

원천만 있으면 언제든 다시 만들 수 있다.

파일 예

대화 기록 ~/.claude/projects/*.jsonl

파일 압축

파일 자체가 압축된 상태. Parquet은 안에서 ZSTD·Snappy 같은 방식으로 이미 압축돼 있다.

패키지 package

모듈을 묶은 폴더. 예: dhub2/cores/resourceplan/.

패턴(pattern)

자주 쓰이는 설계 방식에 붙인 이름. "무슨 역할을 하는 서버인가"를 말한다. 예: BFF, 프록시, 작업 큐.

페이지의 JS

지금 열린 웹페이지에서 도는 자바스크립트. 보안 때문에 샌드박스(바깥과 격리된 실행 공간) 안에서 돈다.

표준

그릇(OpenAI 형식의 tools, parameters)과 문법(type, properties, items).

JSON Schema 규약과 해석

푸시다운(pushdown)

거르는 조건을 데이터가 있는 DB로 보내서 거기서 거르게 하는 방식이다.

푸터 footer: 파일 끝 정보

스키마(열 이름과 타입)와 열별 통계(최솟값·최댓값 등)를 담는다.

프록시 대신 요청해 주는 서버

BFF는 프록시 역할을 포함하지만, 조합·저장·권한 확인까지 하므로 더 넓다.

프론트엔드

이용자 브라우저에서 도는 코드다. 화면을 그리고 클릭을 받는다. 누구나 개발자 도구로 내용을 볼 수 있다.

플레이북 playbook

어떤 작업을 어떤 순서로 할지 적은 YAML 파일.

ㅎ 3

합쳐 예

즐겨찾기 여부 표시

행 저장(OLTP)

디스크에 [1,강남,3] [2,서초,5] [3,강남,2]처럼 줄 단위로 둔다. 한 줄을 읽고 고치기 쉽다.

화면용 내부 주소

웹 화면이 쓰려고 만든 주소. 공개 약속이 아니라 예고 없이 바뀐다.

A 5

ADR Architecture Decision Record

설계 결정과 이유를 남긴 문서. 오늘 근거는 ADR-0224였다.

ADR-0125 (값 정합)

사람이 입력한 값(오타·동의어)을 사전의 정식값에 맞춘다. 값 추측은 금지이고, 애매하면 답하지 않는다.

API

Gemma 경로

API 게이트웨이

모든 서비스 앞에 서는 공용 입구. 인증·속도 제한·경로 나누기를 한다. 특정 화면을 위한 맞춤 일은 하지 않는다.

aud audience

이 토큰을 받을 대상 앱.

B 3

BFF Backend For Frontend

프론트엔드를 위한 백엔드

Blob Binary Large Object: 큰 바이트 덩어리

JS에서 "바이트 덩어리 하나"를 담는 객체. 안에 든 게 CSV든 이미지든 Parquet이든 그냥 바이트 나열로 다룬다.

Business Intelligence 도구

대시보드·보고서 도구

C 5

CORS Cross-Origin Resource Sharing

다른 주소 사이의 요청 허용 규칙

데이터 파이프라인 실행과 갱신 · cron 예약 실행과 클라우드 실행

cron 돌림

유닉스·리눅스의 전통적인 예약 실행 도구다. crontab(cron 표: 언제 무엇을 돌릴지 적은 목록)에 한 줄씩 적는다.

cron 식

0 18 * * *처럼 칸 다섯 개로 시각을 적는다. 순서는 분·시·일·월·요일이다. 이 예는 "매일 18시 0분"이다.

CSV Comma-Separated Values: 쉼표로 나눈 값

한 줄이 한 행, 쉼표로 칸을 나누는 텍스트 파일.

Ctrl+C

터미널에서 실행 중인 명령을 멈추는 키. 로그 보기만 멈추고, 앱은 그대로 돈다.

D 4

DB DBMS

데이터를 보관하고 SQL 질문에 답하는 프로그램

DE-9IM

Dimensionally Extended 9-Intersection Model(차원 확장 9교차 모델).

DE-9IM 공간 관계 판정

Docker

이미지를 받고 컨테이너를 띄우는 프로그램.

Docker Compose 로컬 개발환경

docker-compose.yml

컨테이너 여러 개의 설정(이미지, 포트, 환경 변수, 저장 공간)을 한 파일에 적은 것. docker compose up 한 줄로 전부 띄운다.

Docker Compose 로컬 개발환경

E 4

Egress

외부 인터넷

EPSG:4326

위도·경도 좌표계 번호. H3는 이 좌표만 입력으로 받는다.

escape 이스케이프

특수 문자를 다른 글자 조합으로 적는 규칙

ETL

Extract 추출 · Transform 변환 · Load 적재

F 4

FastAPI

웹 서버

fetch

원격의 새 커밋을 받아 오기만 한다. 내 작업 줄기는 안 바꾼다.

field_validator

"칸", mode="before"

FusionDB

Delta Lake 기반

G 5

git clone <주소>

원격을 통째로 복사해 온다. origin이 자동으로 등록된다. 그래서 clone으로 시작한 사람은 "commit하면 당연히 올라갈 곳이 있다"고 느끼기 쉽다.

git init

빈 로컬 저장소만 만든다. remote가 없다. 오늘 경우가 이것이다.

git 폴더

이력이 실제로 저장되는 숨은 폴더. 커밋은 모두 여기 들어 있다.

GitHub Actions

GitHub가 제공하는 자동 실행 서비스다. 저장소 안 .github/workflows/*.yml에 적으면 GitHub 서버가 돌려 준다.

GRS80 / WGS84

오늘날 기준. 둘은 사실상 같은 위치를 준다(차이 수 mm 수준).

지오코딩과 참조 데이터 매칭 · DE-9IM 공간 관계 판정

H 4

H3

지구를 육각형 칸으로 나눈 격자 체계. h3_r9는 해상도 9의 칸 번호다.

HCL

HashiCorp 설정 언어

HTTP

브라우저(클라이언트)와 서버가 주고받는 약속. 요청 하나에 응답 하나가 온다.

HttpOnly

JS가 쿠키를 읽지 못하게 막는 속성. 토큰 탈취 공격(XSS)에 강해진다.

I 3

IdP Identity Provider: 신원 제공자

로그인을 맡는 쪽. 여기서는 dhub2-manager.

import "server-only"

이 줄이 있는 파일이 브라우저 쪽에 섞이면 빌드가 실패한다. 토큰·SQL 코드가 새지 않게 막는 안전장치다.

iss issuer

누가 발급했나. hub-dev인지 운영인지 구분된다.

J 1

JWT

서명된 JSON 문자열

K 3

k8s 쿠버네티스

컨테이너를 띄우고 관리하는 플랫폼

kubelet

각 노드에서 컨테이너를 관리하는 프로그램

Kubernetes 배포판, CNI

파드끼리 통신하게 하는 네트워크 플러그인

데이터 쓰기 방식: 전체 교체·파티션 교체·append·upsert

L 6

Lake

Parquet 파일 위에 버전 기록을 얹은 표 형식

LangChain

어시스턴트 코드

launchd

macOS의 공식 예약·상주 실행 관리자다. Mac에서도 cron이 돌긴 하지만 Apple은 launchd를 권한다. 설정은 ~/Library/LaunchAgents/의 plist(XML 설정 파일)에 적는다.

lax 모드 기본

바꿀 수 있으면 바꿔 준다. "true" → True, "10" → 10.

Linux

방화벽 포트, 호스트 이름

LLM

Claude, Gemma 등

M 2

manifest(수집 기록)

무엇을 언제 받았는지 남긴 목록. "바뀐 것만 받기"에 쓴다.

mirror

내려받기 사본

N 2

Next.js 기본 실행 방식

빌드 결과에 Node.js 서버 프로그램이 들어 있다. 그 서버가 화면 파일도 보내고 API도 처리한다.

Node

JavaScript를 실행하는 스레드가 하나다. 기다리는 일은 운영체제와 libuv(Node 안에서 I/O를 맡는 라이브러리)의 스레드 풀에 넘긴다.

O 11

OAuth 2.0

남의 서비스에 "내 대신 이걸 해도 된다"는 권한을 넘기는 표준.

Object URL

URL.createObjectURL(blob)이 만드는 blob:https://… 모양의 임시 주소. 메모리 속 Blob을 가리킨다.

OIDC 로그인 흐름 · SSO 로그인과 쿠키 세션 유지

OFFSET 페이지네이션

LIMIT 1000 OFFSET 40000처럼 "앞에서 4만 개 건너뛰고 1,000개".

데이터 규모 증가와 확장성

OIDC OpenID Connect

OAuth 2.0 위에 "누구인지"를 알려 주는 기능을 얹은 표준.

OLAP Online Analytical Processing

온라인 분석 처리

OLTP Online Transaction Processing

온라인 거래 처리

on-premise 온프렘

고객 건물 안 서버

origin/main

"마지막으로 확인한 원격 main의 위치"를 로컬에 적어 둔 표시.

ORM

Object-Relational Mapping(객체-관계 매핑)의 줄임말이다.

output

'export'`

overwrite

통째 교체

P 13

Parquet

Apache 재단의 오픈소스 열 지향(columnar: 같은 열의 값을 붙여 저장) 이진(사람이 바로 읽을 수 없는 바이트) 형식.

PKCE

코드 가로채기를 막는 확인 절차

PNU(필지고유번호)

땅 한 필지를 가리키는 19자리 국가 표준 번호. 시군구 5 + 법정동 5 + 산 여부 1 + 본번 4 + 부번 4자리다.

CLI headless 실행과 claude -p

PostGIS

PostgreSQL의 공간 확장

DE-9IM 공간 관계 판정

predicate 술어

참/거짓을 돌려주는 판정 함수

DE-9IM 공간 관계 판정

process 프로세스

실행 중인 프로그램 하나

provider

클라우드·Kubernetes·Helm 같은 대상과 대화하는 플러그인.

public 스키마

데이터베이스를 만들면 기본으로 생기는 칸막이다. 스키마 이름을 생략하면 보통 여기로 간다.

pull

fetch 한 뒤 내 줄기에 합친다(merge 등).

push

원격에 없는 내 커밋을 보낸다.

PyPI

공개 패키지 저장소

pyproject.toml

프로젝트 정보와 의존성을 적는 표준 설정 파일.

Python

GIL(Global Interpreter Lock: 한 프로세스 안에서 한 번에 한 스레드만 Python 코드를 실행하게 하는 잠금)이 있다. 스레드를 늘려도 계산은 한 번에 하나씩이다. I/O를 기다리는 동안에는 GIL을 내려놓는다.

R 3

React만 예: Vite로 만든 앱

결과물은 HTML·JS 정적 파일뿐이다. 서버가 없으니 비밀을 숨길 곳도, DB에 붙을 곳도 없다. 백엔드를 따로 만들어야 한다.

remote

원격 저장소 연결

Route Handler app/api//route.ts

GET·POST 함수를 내보내면 그대로 HTTP API가 된다. Express의 app.get(...)과 같은 역할이다.

S 15

SameSite

다른 사이트에서 시작된 요청에 쿠키를 실을지 정하는 속성.

schedule 트리거

Actions에서 cron 식으로 시각을 정하는 방법이다. 시각은 UTC(세계 표준시) 기준이다. 한국 18시는 UTC 9시다.

search_path

스키마 이름을 생략했을 때 어느 스키마부터 찾을지 정한 순서다.

secret

로그인 서버에 앱임을 증명하는 비밀값

Secrets

토큰 같은 비밀값을 저장소 설정에 숨겨 두고 실행 때만 넣어 주는 기능이다.

Server Component 서버에서 미리 그리는 화면 조각, page.tsx의 기본

화면을 그리기 전에 서버에서 PG를 직접 읽는다. 별도 API를 거치지 않는다.

sha256

파일 내용으로 만든 지문. 내용이 한 글자만 달라도 값이 바뀐다.

site-packages

가상 환경 안에서 설치된 패키지가 복사되는 폴더.

SSH

원격 접속 규약

OIDC 로그인 흐름 · SSO 로그인과 쿠키 세션 유지

SSO Single Sign-On

한 번 로그인으로 여러 서비스를 쓰는 것.

state 파일

자기가 만든 리소스와 그 속성을 적어 둔 장부. "지금 무엇이 있나"의 기준이다.

stateless 세션

세션 내용을 서명 쿠키 안에 담아, 서버가 따로 세션 저장소를 두지 않는 방식. 서버(파드)가 몇 대든, 재시작되든 상관없다.

StorageClass

디스크를 어떤 방식으로 만들어 줄지 정한 설정

strict 모드 strict=True

바꾸지 않고 거절한다. "true"가 오면 Input should be a valid boolean.

sub subject

사람마다 다르고 바뀌지 않는 고유 ID. dhub2에서는 사용자 ID 그 자체다.

U 1

upsert

있으면 고치고 없으면 추가

V 1

VIP

가상 대표 IP

# 6

-f / --follow

출력을 끝내지 않고 새 내용을 계속 따라가라는 옵션.

1정규형

칸 하나에 값 하나. "즐겨찾기1, 즐겨찾기2" 같은 반복 열을 두지 않는다.

DB 정규화와 연결 표

2·3정규형

키가 아닌 열이 키에만 의존하게 한다. 태그 이름은 dataset_tag의 키가 아니라 태그에 딸린 정보이므로 tag 표로 뺀다.

DB 정규화와 연결 표

3계층 구조

화면(프레젠테이션) → 처리(애플리케이션) → 저장(데이터)으로 나누는 가장 흔한 구조다.