chore/feat: GHCR-based CI/CD + admin metrics dashboard

[imhyunho99]

chore/feat: CI/CD pipeline (GHCR + EC2) + admin metrics dashboard

Summary

두 트랙 묶은 PR.

1. CI/CD 파이프라인 — PR build/test, dev 머지 시 GHCR push + EC2 SSH deploy
2. 운영 대시보드 — /admin/dashboard에 회원/문의/검색/인기 칵테일 등 8개 위젯

---

1. CI/CD 파이프라인

CI (.github/workflows/ci.yml)

• 트리거: PR 열림/업데이트 (target dev or main) + feature 브랜치 push
• dev/main 직접 push는 트리거 안 됨 (그건 CD 담당)
• 단계: JDK 17 setup → ./gradlew clean build (테스트 포함) → JAR artifact 업로드 / 실패 시 test report 업로드
• 테스트 실패 시 워크플로우 실패 (이전 -x test 제거)

CD (.github/workflows/cd.yml)

• 트리거: dev 푸시 (PR 머지 후) + main 수동 (workflow_dispatch)
• 단계:
  1. JDK 17, ./gradlew bootJar -x test
  2. Docker Buildx + GHCR 로그인 (GITHUB_TOKEN)
  3. 이미지 빌드 + 푸시: ghcr.io/mobileonz/cocktail-api:{latest, <sha>}, linux/amd64, registry cache
  4. EC2 SSH (appleboy/ssh-action):
     • docker login ghcr.io (전달된 토큰)
     • docker compose pull api-server
     • docker compose up -d api-server
     • docker system prune -f
     • docker logout
• docker compose v2/v1 자동 감지 fallback 포함

docker-compose.yml 변경

• api-server에 image: ghcr.io/mobileonz/cocktail-api:${COCKTAIL_API_TAG:-latest} 추가
• build: . 도 유지 → 로컬 dev: docker compose up --build, 운영: docker compose pull && up -d
• 파일 상단에 두 워크플로우 설명 주석

사용된 시크릿 (이미 등록돼 있음)

• EC2_HOST, EC2_USERNAME, EC2_SSH_KEY (3개)
• GITHUB_TOKEN (자동 제공, GHCR push용)

머지 후 EC2 일회성 셋업

1. /root/cocktail-api/에 새 docker-compose.yml + 기존 .env 유지 (git pull 로직 제거됨)
2. (선택) GHCR 패키지 visibility를 public으로 토글: https://github.com/orgs/MobileOnz/packages
3. (선택) main 자동 배포 활성화: cd.yml의 push.branches에 main 추가

---

2. 관리자 대시보드 (/onz/admin/dashboard)

기존 placeholder 메뉴 페이지 → 실제 운영 메트릭 대시보드.

8개 위젯

#	위젯	데이터
1	오버뷰 카드 4개	총 회원수, 오늘 가입, 7일 활성 디바이스, 미답변 문의
2	30일 가입자/활성 디바이스 라인 차트	member.created_at + monitoring
3	소셜 로그인 비율 도넛	member.social_login GROUP BY
4	인기 칵테일 Top 10	recommend_count + bookmark count 합산
5	인기 검색어 Top 10	search_history.query_text 카운트
6	최근 가입자 10명	member ORDER BY created_at DESC
7	문의 상태 카드 3개	NEW/READ/REPLIED 카운트 (클릭 시 필터링된 inquiry 페이지로)
8	(보너스) JSON /admin/dashboard/data	AJAX refresh / 외부 모니터링

기술

• domain/admin/service/AdminDashboardService.java — JPA + 네이티브 쿼리 (generate_series for 30d 시리즈)
• domain/admin/controller/AdminViewController — Model 채워서 dashboard 렌더 + JSON 엔드포인트
• templates/admin/dashboard.html — 기존 메뉴 4개 보존 + 위젯 그리드 + Chart.js CDN
• 의존성 추가 0건

데이터 nuance

• monitoring에 last-seen 컬럼 없어 COALESCE(updated_at, created_at) 사용
• cocktail_bookmark 테이블 비어있어 인기 칵테일 점수는 사실상 recommend_count. 데이터 쌓이면 자동 반영
• search_history.user_id로 비회원 검색 포함. 회원만 카운트하려면 WHERE user_id IS NOT NULL 추가

검증 결과

• /admin/dashboard 200, /admin/dashboard/data 200
• 실데이터 노출 확인: {"totalMembers":14,"todaySignups":0,"last7dSignups":1,"activeDevicesAllTime":75,"unansweredInquiries":9}
• 4개 메뉴 링크 (칵테일/태그/가이드/문의) 보존됨

---

변경 파일

.github/workflows/ci.yml       (rewritten)
.github/workflows/cd.yml       (rewritten — GHCR/SSH)
docker-compose.yml             (image: + build: 둘 다)
src/main/java/com/application/domain/admin/service/AdminDashboardService.java  (NEW)
src/main/java/com/application/domain/admin/controller/AdminViewController.java (modified)
src/main/resources/templates/admin/dashboard.html  (rewritten)

보안

• 시크릿 평문 0건. GHCR 인증은 GITHUB_TOKEN (워크플로우 자동), EC2 SSH 인증은 GitHub Secrets 3개 (이미 등록된 것).
• Dockerfile / 운영 스크립트에 자격증명 하드코딩 없음.

🤖 Generated with Claude Code