Glossary

용어집

용어	쉬운 설명
Access Token	API 요청자가 누구인지 짧은 시간 동안 증명하는 JWT
ADR	아키텍처 선택·이유·대안·결과를 남기는 결정 기록
Adapter	외부 시스템의 차이를 내부 공통 인터페이스로 감싸는 계층
Agent	Context와 Workflow를 이용해 업무 후보를 만드는 AI 보조 기능
Agent Router	여러 Agent 버전으로 트래픽을 나누는 구성요소
AI Run	AI 요청의 queue·실행·검증·재시도·실패 상태를 DB에 보존하는 비동기 실행 단위
Async / 비동기	요청을 저장한 뒤 즉시 식별자를 반환하고 실제 처리를 이어서 수행하는 방식
Audit Log	누가 언제 무엇을 생성·수정·승인했는지 남긴 기록
Blue/Green	기존 버전과 신규 버전을 동시에 준비해 안전하게 전환하는 배포 방식
Bulkhead	AI 호출 자원 한도를 분리해 장애가 서버 전체로 번지지 않게 하는 장치
Circuit Breaker	반복 장애 때 외부 호출을 잠시 멈추고 빠르게 실패시키는 장치
CORS	허용된 웹 Client 주소만 API를 호출하도록 브라우저 접근을 제한하는 규칙
Context Pack	Agent가 업무를 이해할 때 주입받는 검증된 지식 묶음
DTO	API·계층 사이에서 필요한 값만 전달하는 데이터 객체
Domain Event	Domain에서 이미 일어난 중요한 사실을 다른 처리에 알리는 message
E2E	로그인부터 최종 완료까지 전체 사용자 흐름을 검사하는 테스트
Epic	여러 하위 Issue를 하나의 큰 목표로 묶은 항목
Event Publication Registry	Transaction과 함께 event 발행 상태를 저장하고 실패·재시작 뒤 재처리하는 기록소
Flyway	버전이 붙은 SQL로 DB 구조 변경을 재현하는 도구
Golden Scenario	제품 가치를 가장 잘 보여주는 대표 사용자 흐름
HITL	Human-in-the-loop. AI 결과를 중요한 행동 전에 사람이 검토·승인하는 구조
Idempotency	같은 요청이 재시도돼도 업무가 중복 생성되지 않는 성질
JSON Schema	JSON 필드·자료형·필수값을 검사하는 규칙
JWT	인증 정보를 서명해 전달하는 Token 형식
Liveness	서버 프로세스가 살아 있는지 확인하는 상태 검사
LM Studio	로컬 모델과 Prompt를 실험하는 개발 도구. 최종 데모 의존성이 아님
Masking	값 일부를 별표 등으로 가려 전체 정보가 보이지 않게 하는 처리
Migration	DB 테이블·컬럼 변경을 순서와 버전으로 기록한 작업
Milestone	여러 Issue의 일정과 완료율을 묶는 GitHub 기능
MVP	핵심 가치를 검증할 수 있는 최소 기능 제품
Multi-tenancy	여러 사업장이 한 서버를 쓰되 서로의 데이터를 볼 수 없게 분리하는 구조
Observability	Metric·log·trace로 시스템 내부 상태와 장애 원인을 이해하는 능력
OpenTelemetry	여러 서비스의 trace·metric·log를 표준 방식으로 수집·전달하는 도구 모음
Optimistic Lock	version을 비교해 동시 수정이 서로의 값을 덮는 것을 막는 방식
Outbox	Business 변경과 event record를 같은 DB Transaction에 저장하는 유실 방지 pattern
P0 / P1 / P2	최우선 핵심 / 중요 / 보완 우선순위
Provider	OpenAI, Gemini처럼 모델 API를 제공하는 외부 시스템
Readiness	DB 등 의존성을 포함해 실제 요청을 받을 준비 상태인지 확인하는 검사
Refresh Token	Access Token을 다시 발급받기 위한 장기 Token
Rollback	문제가 생긴 배포를 이전 정상 버전으로 되돌리는 작업
Runbook	실행·점검·장애 복구 절차를 순서대로 적은 문서
Secret	API Key, DB 비밀번호처럼 공개하거나 Git에 저장하면 안 되는 값
Smoke Test	배포 직후 핵심 기능이 최소한 동작하는지 빠르게 확인하는 검사
Structured Output	모델이 자유 설명 대신 정해진 JSON 구조로 답하는 방식
Sub-issue	Epic 아래에서 실제 구현하는 작은 Issue
Task / 업무카드	HR이 해야 할 일, 상태, 조건, 증빙을 구조화한 단위
Testcontainers	테스트 중 실제 PostgreSQL 같은 컨테이너를 자동 실행하는 도구
Token Hash	원본 Token을 복원하기 어렵게 변환해 DB에 저장한 값
Transaction	여러 DB 변경을 함께 성공하거나 함께 실패시키는 처리 단위
Trace / Trace ID	API·background event·외부 Provider의 한 요청 흐름을 이어 찾는 식별자
Vertical Slice	API·DB·AI·배포를 포함한 한 사용자 흐름을 끝까지 완성하는 방식
Worker Link	근로자가 로그인 없이 제한된 안내·응답만 수행하는 만료 링크
Workflow	업무가 초안·검토·승인·대기·완료로 이동하는 규칙
Workflow Catalog	업무 유형별 필수정보·상태·승인·완료 기준 모음

FOWOCO에서 특히 중요한 구분

AI Run, 후보 확정, HR 승인

AI Run 성공은 후보를 검토할 수 있다는 뜻입니다. HR이 후보를 실제 Task로 확정하고 현재 Task version을 승인해야 전달 단계로 이동합니다.

Retry와 가짜 Fallback

일시적 오류만 제한적으로 Retry합니다. 실패 시 Fake 결과를 진짜 AI 결과처럼 반환하지 않고 수동 입력·나중 재시도·담당자 검토처럼 실제 가능한 다음 행동을 제공합니다.

LM Studio와 데모 배포

LM Studio는 개발 실험용입니다. 최종 데모는 외부 LLM API 또는 클라우드 Endpoint를 사용합니다.

근로자 로그인과 Worker Link

근로자는 계정을 만들지 않습니다. 승인된 특정 업무에만 접근하는 만료·폐기 가능한 Worker Link를 사용합니다.

파일 자체와 파일 메타데이터

MVP는 서류 유형·상태·만료일 같은 메타데이터를 우선 관리합니다. 원본 파일 저장은 제한적으로 처리하고 FileStorage 경계로 분리합니다.