용어 카탈로그
용어 카탈로그에서는 회사에서 사용하는 약어, 설비명과 업무 용어를 시스템 코드에 연결합니다. 사용자의 자연어를 올바른 엔터티와 코드로 해석하도록 돕되, 검토되지 않은 제안은 실제 조회에 사용하지 않습니다.
개요
용어는 테넌트별로 분리해 저장되고 proposed, approved 등의 상태를 가집니다. 서비스 조회에는 approved 상태만 사용되며, 상태나 대상 코드를 바꾸면 해당 테넌트의 메모리 캐시가 무효화됩니다.
목록 항목
| 항목 | 설명 |
|---|---|
| Tenant ID | 용어가 적용되는 회사 범위입니다. |
| Term | 사용자가 입력하는 약어 또는 자연어 표현입니다. |
| Entity Type | 품목, 설비, 공정 등 연결할 업무 엔터티입니다. |
| Target Codes | 용어가 가리키는 실제 시스템 코드 목록입니다. |
| Source | 용어를 제안한 시스템 또는 담당자입니다. |
| Status | proposed, approved 등 검토 상태입니다. |
| Updated At | 마지막 변경 시각입니다. |
용어 등록
- 적용할 Tenant ID와 Entity Type을 확인합니다.
- 실제 현장에서 사용하는 표현을 Term에 입력합니다.
- 연결할 Target Codes가 현재 시스템에 존재하는지 확인합니다.
- 출처와 검토 근거를 기록합니다.
- proposed 상태로 저장합니다.
- 담당자가 의미와 코드를 확인한 뒤 approved로 변경합니다.
승인 기준
같은 용어가 여러 코드를 뜻할 수 있으면 무조건 하나로 승인하지 말고 사용 문맥이나 추가 조건을 정합니다. 철자가 비슷하지만 다른 설비·품목인 경우 별도 용어로 관리합니다. 운영에서 더 이상 쓰지 않는 표현은 코드를 재사용하지 말고 상태를 변경합니다.
사용자 입력 해석
카탈로그 조회는 입력 문장에서 승인된 용어를 찾아 대상 코드 후보를 반환합니다. 용어가 발견되지 않으면 모델이 임의의 코드를 만들지 않도록 원본 질문과 검색 결과를 확인해야 합니다. 코드 후보가 여러 개면 사용자에게 범위를 다시 물어보는 흐름이 안전합니다.
캐시와 반영
변경 작업은 테넌트 캐시를 무효화하므로 다음 조회부터 승인 결과가 반영됩니다. 다른 테넌트의 캐시는 영향을 받지 않습니다. 변경 후 대표 문장으로 실제 Resolve 결과를 확인하십시오.
문제 해결
- 승인했지만 검색되지 않으면 Tenant ID와 Entity Type을 확인합니다.
- 잘못된 코드가 반환되면 Target Codes와 상태를 확인합니다.
- 중복 제안은 기존 용어의 코드와 비교해 병합 여부를 결정합니다.
- DB 연결 오류가 나면 용어를 다시 등록하기보다 저장소 연결을 먼저 복구합니다.