딕셔너리
AIMO 딕셔너리는 분류체계 내의 모든 유효한 코드의 권위 있는 목록입니다. 레이블, 설명 및 생명주기 정보를 포함하여 각 코드에 대한 완전한 정의를 제공합니다.
딕셔너리란
딕셔너리는 모든 AIMO 분류체계 코드의 완전한 기계 판독 가능 세트를 제공합니다. 포함된 내용:
- 8개 차원에 걸친 모든 91개 코드
- 레이블 및 정의 (언어 팩에서 번역 포함)
- 생명주기 메타데이터 (상태, 도입 버전, 폐기, 제거)
- 코드 사용에 대한 범위 노트 및 예시
딕셔너리가 가능하게 하는 것:
- 증거 템플릿: 코드는 AI 시스템을 분류하기 위해 EV 템플릿에서 사용됩니다
- 검증기: 검증기는 모든 코드가 딕셔너리에 존재하는지 확인합니다
- 커버리지 맵: 코드는 외부 프레임워크 및 규정에 대한 매핑을 가능하게 합니다
!!! info "단일 진실 공급원 (SSOT)" 딕셔너리의 SSOT는:
- **구조**: `data/taxonomy/canonical.yaml` (코드, 상태, 생명주기)
- **번역**: `data/taxonomy/i18n/*.yaml` (언어별 레이블, 정의)
CSV 파일은 배포를 위한 **생성된 산출물**입니다. 다운로드는 [릴리스](../../releases/index.md)를 참조하세요.
열 스키마
정본 딕셔너리는 18개 열(언어 중립 구조)을 사용합니다:
식별 열 (5개)
| # | 열 | 필수 | 설명 | 예시 |
|---|---|---|---|---|
| 1 | standard_id |
예 | 표준 식별자 | AIMO-STD |
| 2 | standard_version |
예 | SemVer 형식 | 0.1.0 |
| 3 | dimension_id |
예 | 2자리 차원 ID | FS, UC, DT |
| 4 | dimension_name |
예 | 차원 이름 | Functional Scope |
| 5 | code |
예 | 전체 코드 | UC-001 |
레이블 및 정의 열 (4개)
| # | 열 | 필수 | 설명 | 예시 |
|---|---|---|---|---|
| 6 | label |
예 | 코드 레이블 (최대 50자) | General Q&A |
| 7 | definition |
예 | 코드 정의 (1-2문장) | General question answering... |
| 8 | scope_notes |
아니요 | 사용 범위 명확화 | Low to medium risk... |
| 9 | examples |
아니요 | 파이프로 구분된 예시 | chatbot\|recommendation |
!!! note "번역"
정본 데이터 모델은 번역을 언어 팩(data/taxonomy/i18n/*.yaml)으로 분리합니다. 각 언어 팩은 현지화된 dimension_name, label 및 definition 값을 제공합니다. 자세한 내용은 현지화 가이드를 참조하세요.
생명주기 열 (6개)
| # | 열 | 필수 | 설명 | 예시 |
|---|---|---|---|---|
| 10 | status |
예 | active, deprecated, removed |
active |
| 11 | introduced_in |
예 | 추가된 버전 | 0.1.0 |
| 12 | deprecated_in |
아니요 | 폐기된 버전 | 1.2.0 |
| 13 | removed_in |
아니요 | 제거된 버전 | 2.0.0 |
| 14 | replaced_by |
아니요 | 대체 코드 | UC-015 |
| 15 | backward_compatible |
예 | true 또는 false |
true |
거버넌스 열 (3개)
| # | 열 | 필수 | 설명 | 예시 |
|---|---|---|---|---|
| 16 | references |
아니요 | 외부 참조 | ISO/IEC 42001 |
| 17 | owner |
아니요 | 책임 당사자 | AIMO WG |
| 18 | last_reviewed_date |
아니요 | 마지막 검토 (YYYY-MM-DD) | 2026-01-19 |
초기 항목
현재 딕셔너리 버전은 v0.1.0이며 다음을 포함합니다:
| 차원 | 이름 | 활성 코드 | 폐기됨 | 총계 |
|---|---|---|---|---|
| FS | 기능 범위 | 6 | 0 | 6 |
| UC | 사용 사례 분류 | 30 | 0 | 30 |
| DT | 데이터 유형 | 10 | 0 | 10 |
| CH | 채널 | 8 | 0 | 8 |
| IM | 통합 모드 | 7 | 0 | 7 |
| RS | 리스크 표면 | 8 | 0 | 8 |
| OB | 결과 / 혜택 | 7 | 0 | 7 |
| LG | 로그/이벤트 유형 | 15 | 0 | 15 |
| 총계 | 91 | 0 | 91 |
!!! note "완전한 코드 목록" 91개 코드의 완전한 목록은 생성된 CSV 산출물에서 이용 가능합니다. 이 문서 페이지는 열 정의 및 사용 지침을 제공합니다. 상세 코드 정의는:
- **다운로드**: 언어별 CSV 파일은 [릴리스](../../releases/index.md) 참조
- **언어별 CSV**: `artifacts/taxonomy/current/{lang}/taxonomy_dictionary.csv`
- **레거시 EN/JA 혼합 CSV**: `source_pack/03_taxonomy/legacy/taxonomy_dictionary_v0.1.csv` (동결, 이전 호환성 전용)
업데이트 정책
새 코드 추가
- 차원 내에서 다음 사용 가능한 번호 할당 (예:
UC-030다음UC-031) status를active로 설정introduced_in을 현재 버전으로 설정backward_compatible을true로 설정- 레이블 및 정의 제공 (언어 팩에 번역 추가)
기존 코드 수정
| 변경 유형 | 허용됨 | 버전 영향 |
|---|---|---|
| 정의 명확화 | 예 | PATCH |
| 범위 노트 업데이트 | 예 | PATCH |
| 레이블 변경 (의미 보존) | 예 | MINOR |
| 의미 변경 | 아니요 | 대신 새 코드 생성 |
코드 폐기
status를deprecated로 설정deprecated_in을 현재 버전으로 설정replaced_by를 새 코드로 설정 (해당하는 경우)- 코드는 이전 호환성을 위해 기능 유지
- scope_notes에 이유 문서화
코드 제거
- 먼저 최소 하나의 MINOR 버전 동안 폐기
status를removed로 설정removed_in을 현재 MAJOR 버전으로 설정- 코드는 더 이상 새 증거에 유효하지 않음
호환성 정책
| 조치 | 버전 영향 | 이전 호환 |
|---|---|---|
| 새 코드 추가 | MINOR | 예 |
| 코드 폐기 | MINOR | 예 |
| 정의 명확화 | PATCH | 예 |
| 코드 제거 | MAJOR | 아니요 |
| 코드 의미 변경 | 허용되지 않음 | - |
사용 방법
증거 템플릿에서
각 EV 템플릿에는 8차원 코드 테이블이 포함됩니다:
## AIMO 코드 (8개 차원)
| 차원 | 코드 | 레이블 |
| --- | --- | --- |
| **FS** | `FS-001` | 최종 사용자 생산성 |
| **UC** | `UC-001`, `UC-002` | 일반 Q&A, 요약 |
| **DT** | `DT-002`, `DT-004` | 내부, 개인 데이터 |
| **CH** | `CH-001` | 웹 UI |
| **IM** | `IM-002` | SaaS 통합 |
| **RS** | `RS-001`, `RS-003` | 데이터 유출, 컴플라이언스 위반 |
| **OB** | `OB-001` | 효율성 |
| **LG** | `LG-001`, `LG-002` | 요청 레코드, 검토/승인 레코드 |
검증기에서
검증기가 확인하는 것:
- 증거에서 참조된 모든 코드가 딕셔너리에 존재
- 코드 형식이 예상 패턴(
PREFIX-###)과 일치 - 폐기된 코드가 경고 트리거
- 제거된 코드가 거부됨
확장 지침
조직은 사용자 정의 코드로 딕셔너리를 확장할 수 있습니다(MAY):
확장 접두사:
X-<ORG>-<DIM>-<TOKEN>
예: ACME Corporation의 사용자 정의 사용 사례 코드로 X-ACME-UC-901.
확장 규칙:
- 사용자 정의 코드는 표준 코드와 충돌하면 안 됩니다(MUST NOT)
- 사용자 정의 코드는 로컬 확장 딕셔너리에 문서화되어야 합니다(SHOULD)
- 외부 당사자와 증거를 교환할 때는 표준 코드만 사용
다운로드
딕셔너리 및 관련 파일이 포함된 다운로드 가능 패키지는 릴리스를 참조하세요.