# Web Portal - Kubernetes 배포 가이드

## 📁 프로젝트 구조

```
k8s-portal/
├── backend/
│   ├── main.py          # FastAPI 백엔드 (전체 API)
│   ├── requirements.txt
│   └── Dockerfile
├── frontend/
│   ├── index.html       # 싱글 페이지 앱 (SPA)
│   ├── nginx.conf       # Nginx 설정 (API 프록시 포함)
│   └── Dockerfile
├── k8s/
│   ├── 01-namespace.yaml    # web-portal 네임스페이스
│   ├── 02-postgres.yaml     # PostgreSQL + PVC + Service
│   ├── 03-secrets.yaml      # DB 패스워드, JWT 시크릿
│   ├── 04-backend.yaml      # FastAPI Deployment + Service
│   └── 05-frontend.yaml     # Nginx Deployment + NodePort(30080)
├── build-and-deploy.sh  # 원클릭 빌드 & 배포
├── cleanup.sh           # 전체 삭제
└── README.md
```

## 🚀 설치 및 실행

### 전제 조건
- Docker Desktop 설치 및 실행
- Docker Desktop > Settings > Kubernetes > Enable Kubernetes ✅

### 배포 (원클릭)
```bash
chmod +x build-and-deploy.sh
./build-and-deploy.sh
```

### 접속
브라우저에서: **http://localhost:30080**

## 🔑 기본 계정

| 구분 | ID | Password |
|------|-----|----------|
| 관리자 | `admin` | `admin1234` |
| 일반사용자 | `user1` | `user1234` |

## ✨ 기능 설명

### 일반 사용자
- 로그인 후 **본인에게 할당된 웹페이지 목록** 확인
- 카드 클릭 시 **새 탭에서 해당 URL로 이동**

### 관리자
일반 사용자 기능 + 추가:
- **페이지 관리**: 웹페이지 추가/수정/삭제
- **사용자 관리**: 계정 생성/삭제
- **권한 설정**: 사용자별 접근 가능 페이지 체크박스로 지정

## 🔧 운영 명령어

```bash
# 전체 리소스 상태 확인
kubectl get all -n web-portal

# 백엔드 로그 확인
kubectl logs -n web-portal deployment/backend -f

# 프론트엔드 로그 확인
kubectl logs -n web-portal deployment/frontend -f

# 재시작
kubectl rollout restart deployment/backend -n web-portal
kubectl rollout restart deployment/frontend -n web-portal

# 전체 삭제
./cleanup.sh
```

## 🔐 운영 시 보안 설정

`k8s/03-secrets.yaml`에서 반드시 변경:
```yaml
stringData:
  db-password: "강력한패스워드로변경"          # PostgreSQL 패스워드
  jwt-secret: "64자이상의랜덤문자열로변경"     # JWT 서명 키
```

## 🏗️ 아키텍처

```
브라우저
  │
  ▼ :30080 (NodePort)
[Nginx Frontend] ─── 정적 HTML/JS 제공
  │ /api/* 프록시
  ▼
[FastAPI Backend] ─── JWT 인증, REST API
  │
  ▼
[PostgreSQL] ─── 사용자, 페이지, 권한 데이터
```