컴플라이언스
GenD 컴플라이언스 기능은 데이터 거버넌스 규정 준수 상태를 체계적으로 관리합니다. GDPR, 개인정보보호법, 금융규제 등 다양한 컴플라이언스 프레임워크에 대한 평가를 수행하고 준수 현황을 대시보드로 제공합니다.
주요 기능
- 프레임워크 관리: GDPR, PIPA 등 컴플라이언스 프레임워크와 통제 항목을 관리합니다
- 평가(Assessment) 실행: 프레임워크 기반으로 자동/수동 평가를 실행합니다
- 자동 검사: PII 탐지, 보존 정책, 접근 통제 등 자동 검증 가능한 항목을 자동으로 검사합니다
- 대시보드: 전체 프레임워크별 준수율과 위험 항목을 한눈에 파악합니다
- 평가 리포트: 평가 결과를 리포트 형태로 생성하여 감사에 활용합니다
- 변경 이력 (ChangeLog): 헤더 우측 변경 이력 버튼으로 컴플라이언스 mutation 호출을 사이드 패널에서 조회합니다 (자세히)
핵심 개념
| 개념 | 설명 |
|---|---|
| Framework | 컴플라이언스 규정 체계 (GDPR, PIPA 등) |
| Control | 프레임워크 내 개별 통제 항목 |
| Assessment | 특정 시점의 준수 상태 평가 |
| Check Result | 각 통제 항목의 검사 결과 (pass/fail/manual) |
대시보드 화면 읽기
대시보드 상단 카드와 프레임워크 카드의 숫자·색상 의미입니다.
요약 카드 (상단 3개)
| 카드 | 값의 의미 | 데이터 소스 |
|---|---|---|
| 전체 준수율 | is_active=true 프레임워크의 최신 평가 점수 단순 평균 | ComplianceDashboardResponse.overall_score |
| 프레임워크 | 활성 프레임워크 수 (is_active=true) | total_frameworks |
| 총 평가 | 모든 ComplianceAssessment 레코드 수 (이력 포함) | total_assessments |
전체 준수율은 각 프레임워크의 최신 평가 1건씩 의 산술 평균입니다. 평가 이력이 없는 프레임워크는 평균 계산에서 제외됩니다.
프레임워크 카드
각 카드는 해당 프레임워크의 가장 최근 평가 만 보여 줍니다.
- 큰 숫자 (예:
40%) —latest_score(최신 평가의compliance_score) - 상태 배지 (예:
진행 중) —latest_status(completed/in_progress/draft/not_assessed) 4/10 준수—compliant_items / total_items(해당 평가의 통제 항목 중 통과 건수)평가 실행버튼 — 새 평가를 생성하고 자동 점검을 실행 (자세히)- 카드 배경/숫자 색상 —
latest_score의 구간 (아래 표)
색상 임계값
점수 텍스트·진행률 바·카드 배경 모두 동일한 임계값을 사용합니다.
| 점수 구간 | 색상 | 의미 |
|---|---|---|
≥ 90% | 🟢 초록 | 양호 |
≥ 70% | 🔵 파랑 | 보통 |
≥ 50% | 🟡 노랑 | 주의 |
< 50% | 🔴 빨강 | 위험 |
상태 배지 색상은 점수와 무관하게 평가의 진행도를 나타냅니다.
| 배지 라벨 | Assessment status | 배경 색 |
|---|---|---|
| 완료 | completed | 초록 |
| 진행 중 | in_progress | 파랑 |
| 초안 | draft | 회색 |
| 미평가 | not_assessed | 회색 |
점수 산식·상태 판정 규칙·자동 점검 키 목록은 평가 실행 가이드 의 "동작 원리" 섹션을 참조하세요.
API 엔드포인트
| Method | Path | Description |
|---|---|---|
| GET | /api/v1/compliance/frameworks | 프레임워크 목록 조회 |
| GET | /api/v1/compliance/frameworks/{framework_id} | 프레임워크 상세 조회 |
| POST | /api/v1/compliance/assessments | 평가 생성 |
| GET | /api/v1/compliance/assessments | 평가 목록 조회 |
| POST | /api/v1/compliance/assessments/{id}/run | 자동 검사 실행 |
| GET | /api/v1/compliance/dashboard | 대시보드 조회 |
| GET | /api/v1/compliance/changelog | 변경 이력 (mutation only, admin) |
AI Agent Chat으로 수행하기
이 페이지의 작업을 AI에게 자연어로 요청할 수 있습니다. 페이지 상단의 AI에게 요청 버튼을 클릭하거나, AI 에이전트 채팅에서 직접 질문하세요.
예시:
- "컴플라이언스 준수율 현황 보여줘"
- "GDPR 프레임워크 상태 확인해줘"
자세한 내용은 AI Agent Chat 가이드를 참조하세요.