Glossary

용어집

용어	쉬운 설명
Access Token	API 요청자가 누구인지 짧은 시간 동안 증명하는 JWT
Adapter	외부 시스템의 차이를 내부 공통 인터페이스로 감싸는 계층
Agent	Context와 Workflow를 이용해 업무 후보를 만드는 AI 보조 기능
Agent Router	여러 Agent 버전으로 트래픽을 나누는 구성요소
Audit Log	누가 언제 무엇을 생성·수정·승인했는지 남긴 기록
Blue/Green	기존 버전과 신규 버전을 동시에 준비해 안전하게 전환하는 배포 방식
CORS	허용된 웹 Client 주소만 API를 호출하도록 브라우저 접근을 제한하는 규칙
Context Pack	Agent가 업무를 이해할 때 주입받는 검증된 지식 묶음
DTO	API·계층 사이에서 필요한 값만 전달하는 데이터 객체
E2E	로그인부터 최종 완료까지 전체 사용자 흐름을 검사하는 테스트
Epic	여러 하위 Issue를 하나의 큰 목표로 묶은 항목
Flyway	버전이 붙은 SQL로 DB 구조 변경을 재현하는 도구
Golden Scenario	제품 가치를 가장 잘 보여주는 대표 사용자 흐름
Idempotency	같은 요청이 재시도돼도 업무가 중복 생성되지 않는 성질
JSON Schema	JSON 필드·자료형·필수값을 검사하는 규칙
JWT	인증 정보를 서명해 전달하는 Token 형식
Liveness	서버 프로세스가 살아 있는지 확인하는 상태 검사
LM Studio	로컬 모델과 Prompt를 실험하는 개발 도구. 최종 데모 의존성이 아님
Masking	값 일부를 별표 등으로 가려 전체 정보가 보이지 않게 하는 처리
Migration	DB 테이블·컬럼 변경을 순서와 버전으로 기록한 작업
Milestone	여러 Issue의 일정과 완료율을 묶는 GitHub 기능
MVP	핵심 가치를 검증할 수 있는 최소 기능 제품
Multi-tenancy	여러 사업장이 한 서버를 쓰되 서로의 데이터를 볼 수 없게 분리하는 구조
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 변경을 함께 성공하거나 함께 실패시키는 처리 단위
Vertical Slice	API·DB·AI·배포를 포함한 한 사용자 흐름을 끝까지 완성하는 방식
Worker Link	근로자가 로그인 없이 제한된 안내·응답만 수행하는 만료 링크
Workflow	업무가 초안·검토·승인·대기·완료로 이동하는 규칙
Workflow Catalog	업무 유형별 필수정보·상태·승인·완료 기준 모음

FOWOCO에서 특히 중요한 구분

AI 분석과 HR 승인

AI 분석 성공은 업무 승인이나 발송을 뜻하지 않습니다. 서버가 검증한 후보를 HR이 승인해야 다음 단계로 이동합니다.

LM Studio와 데모 배포

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

근로자 로그인과 Worker Link

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

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

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