# TK 안전관리 - 개발 가이드

## 로컬 개발 환경 설정

### 1. 의존성 설치
```bash
cd ~/docker/tk-safety
npm install
```

### 2. DB 실행 (Docker)
```bash
docker-compose up db -d
```

### 3. DB 마이그레이션
```bash
npx drizzle-kit push
```

### 4. 개발 서버 실행
```bash
npm run dev
```
→ http://localhost:3000

## 주요 패턴

### Server Actions
모든 CRUD 작업은 `src/actions/` 디렉토리의 Server Actions로 구현됩니다.
- `risk-assessment.ts` — 위험성평가 + 유해위험요인
- `checklists.ts` — 템플릿 + 점검 + NCR
- `rag.ts` — 문서 업로드/처리 + 대화

### AI API 라우트
SSE 스트리밍이 필요한 AI 기능은 `src/app/api/ai/` 라우트로 구현됩니다.
- `chat/route.ts` — RAG Q&A (SSE)
- `suggest-hazards/route.ts` — 위험요인 추천 (JSON)
- `suggest-controls/route.ts` — 감소대책 제안 (SSE)
- `suggest-checklist/route.ts` — 점검항목 생성 (JSON)

### SSE 스트리밍
클라이언트에서는 `src/hooks/use-streaming.ts` 훅을 사용합니다.
```tsx
const { isStreaming, content, sources, error, streamChat, reset } = useStreaming();
await streamChat("/api/ai/chat", { question, conversationId });
```

### 인증 시스템
- HMAC 기반 쿠키 세션 (7일 유효)
- `src/lib/auth.ts` — 세션 생성/검증
- `src/middleware.ts` — 라우트 보호
- `src/app/(authenticated)/layout.tsx` — 서버사이드 인증 확인

## DB 스키마 수정

1. `src/lib/db/schema.ts` 수정
2. 마이그레이션 생성: `npx drizzle-kit generate`
3. 마이그레이션 적용: `npx drizzle-kit push`

## 새 컴포넌트 추가

### shadcn/ui 컴포넌트
```bash
npx shadcn@latest add [component-name]
```

### 커스텀 컴포넌트
기능별 디렉토리에 배치:
- `src/components/risk-assessment/` — 위험성평가 관련
- `src/components/rag/` — RAG/채팅 관련
- `src/components/checklists/` — 체크리스트 관련
- `src/components/dashboard/` — 대시보드 관련

## 코드 컨벤션

- TypeScript strict 모드
- Drizzle ORM 타입 추론 (`InferSelectModel<typeof table>`)
- Server Actions에서 `revalidatePath()` 호출
- 한국어 UI 텍스트 (상수는 `src/lib/constants.ts`에 정의)