Projects
📖
Glossary
오픈소스조직·팀이 실제로 쓰는 용어를 함께 정리하는 셀프호스팅 용어집 관리 플랫폼. 사람은 검색하고, 도구는 API로 표기를 조회합니다.
Next.js 16TypeScriptPostgreSQLpgvectorDrizzle ORMDockerApache-2.0
Overview
사내 용어는 엑셀과 컨플루언스에 흩어지고, 같은 개념이 Auto Exposure · AE · 자동노출처럼 여러 표기로 떠돕니다. 엑셀 용어집이 무너지는 이유는 한 행이 개념이자 표기이기 때문입니다.
Glossary는 개념(Term)과 표기(Surface)를 분리해, 표준 표기를 몰라도 검색으로 도달하고 등록 시점에 중복을 잡습니다. AI-Lint 같은 도구는 OpenAPI로 표기 목록을 조회해 문서를 검증하고, 발견한 미등록 후보는 사람이 검토해 다시 용어집으로 환류합니다.
Apache-2.0 라이선스로 공개된 오픈소스 프로젝트입니다. 한국어를 모국어로 쓰며 기술 용어를 영어와 함께 쓰는 한국 기업 환경에 맞춰져 있고, Docker 이미지로 셀프호스팅합니다.
Features
- 단일 사전 — 정규화된 표기 키로 등록 시점 중복 검사, 동음이의어는 도메인 태그로 구분
- 표기 조회 API — OpenAPI 3.1, 한 번에 최대 500개 표기 조회, Bearer 토큰 인증
- 위키형 문서 — 마크다운·이미지·Mermaid·수식, 모든 수정은 리비전으로 남기고 되돌리기
- 관계도와 Confluence 임베드 — 담당자·Type·업무 분류·주제로 맥락 탐색
- 용어집 근거 챗봇 — Gemini·OpenAI 호환·Ollama, 대화로 용어 등록·수정안 검토
- RAG 검색 — pgvector Embedding과 선택형 Reranker로 하이브리드 의미 검색
- 함께 정리 작업 공간 — 정리 대기 표, AI 검토 큐, 중복 정리, 엑셀 가져오기
- 사내 계정 로그인 — OIDC/OAuth 2.0 설정, JWKS 서명·Issuer·Audience·Nonce 검증
How It Works
1
등록
이름과 한줄 정의를 적고, 같은 뜻의 약어·별칭을 표기로 연결합니다. 중복은 등록 시점에 걸러집니다.
2
검색
낯선 약어나 별칭으로 검색해도 정규화된 표기 키로 같은 개념에 도달합니다.
3
조회
문서 검사 도구가 API로 표기를 조회해 대표 표기와 비권장·금지 표기를 판단합니다.
4
환류
미등록 후보와 수정 제안을 사람이 검토해 용어집에 반영하고, 모든 변경은 이력으로 남습니다.
Tech Stack
- Next.js 16 (App Router) + React 19 — 웹 UI와 REST API
- PostgreSQL 16 + pg_trgm + pgvector — 검색·유사도·Embedding 저장
- Drizzle ORM — 스키마와 마이그레이션
- Turborepo + pnpm — engine · db · web 모노레포
- Docker Hub 이미지 — 셀프호스팅 배포