# TK 안전관리 - 기능 가이드

## 1. 위험성평가 (Risk Assessment)

### 평가 작성
1. 대시보드 또는 위험성평가 페이지에서 "새 평가" 클릭
2. 기본 정보 입력 (제목, 부서, 장소, 평가자)
3. 평가 생성 후 유해위험요인 추가

### 유해위험요인 등록
- **수동 입력**: "위험요인 추가" 버튼 → 분류, 작업, 위험요인, 중대성(1-5) × 가능성(1-5)
- **AI 추천**: "AI 추천" 버튼 → 작업 설명 입력 → AI가 위험요인 분석 → "추가" 클릭

### 위험성 매트릭스
- 5×5 매트릭스 자동 시각화
- 위험등급: 저위험(1-4), 보통(5-9), 고위험(10-16), 매우위험(17-25)

### AI 감소대책 제안
- 각 위험요인 행의 "대책 제안" 클릭
- 제거 → 대체 → 공학적 → 관리적 → PPE 계층별 제안

### 상태 워크플로
초안 → 검토 → 승인 → 보관

### 인쇄/내보내기
- "인쇄" 버튼으로 고용노동부 양식 기반 인쇄 페이지 열기
- 브라우저 인쇄(Ctrl+P)로 PDF 저장 가능

## 2. 안전 Q&A (RAG)

### 문서 업로드
1. "문서 관리" 탭 선택
2. 카테고리 선택 (산업안전보건법, KOSHA 가이드, 사내규정, 안전작업절차서, 기타)
3. 파일 선택 (PDF, HWP, DOCX 등)
4. 자동 처리: Tika 추출 → 청킹 → 임베딩 → Qdrant 저장

### 채팅
1. "채팅" 탭에서 "새 대화" 클릭
2. 질문 입력 (Enter 전송, Shift+Enter 줄바꿈)
3. AI가 업로드된 문서 기반으로 답변 (SSE 스트리밍)
4. 출처 배지로 참고 문서 확인

## 3. 점검 체크리스트

### 템플릿 관리
1. "새 템플릿" 클릭 → 이름, 유형(일상/정기/특별/장비), 설명 입력
2. 점검 항목 추가 (수동 또는 AI 생성)
3. **AI 항목 생성**: "AI 항목 생성" → 작업환경 설명 → AI가 항목 제안 → 개별 또는 전체 추가

### 점검 실행
1. "점검 실행" → 템플릿 선택, 점검자, 장소 입력
2. 각 항목별 합격/불합격/해당없음 선택 + 메모
3. 불합격 항목에서 NCR(부적합) 등록 가능
4. "점검 완료" 클릭

### 부적합 사항 (NCR) 추적
- 상태 흐름: 미조치 → 시정조치 중 → 확인 중 → 종결
- "부적합" 탭에서 전체 NCR 현황 관리

## 4. 대시보드

- **통계 카드**: 총 평가 수, 점검 수, 미조치 NCR, RAG 문서 수
- **위험등급 분포 차트**: 전체 위험요인의 등급별 분포 (막대 차트)
- **부적합 현황 차트**: NCR 상태별 분포 (파이 차트)
- **빠른 실행**: 새 위험성평가, 안전 Q&A, 점검 실행 바로가기

## 5. 설정

- **테마**: 라이트/다크 모드 전환
- **서비스 연결 상태**: Ollama, Embedding, Qdrant, Tika 연결 확인
- **시스템 정보**: 버전, 프레임워크, 모델 정보