kjs그리고Claude Fable 5 a4c6764731 튜토리얼 하이라이트: 눌러야 할 곳을 노란 점선 펄스로 안내
- DOM 버튼: 입양·상점·구매(부두/벌목장/부엌)·배치·증축하기·입양 선택
  버튼에 점선 아웃라인이 커졌다 작아졌다 (tut-pulse 애니메이션)
- 캔버스 건물: 부두·벌목장·회관 풋프린트 둘레에 행진하는 점선 다이아몬드
  (크기 펄스 + 골드 글로우)
- 단계·패널 상태에 따라 타깃 자동 전환 (상점 열면 구매 버튼으로,
  건물 패널 열면 배치 버튼으로 이동)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-13 18:06:12 +09:00

jskim.vexplor.com

Next.js(App Router, TypeScript) + PostgreSQL 개인 프로젝트.

스택

  • 프론트/백엔드: Next.js 15 (React 19, API Routes로 Node.js 백엔드 겸용)
  • DB: PostgreSQL 17 — THREEDEV 서버(211.115.91.140) pg-jskim 컨테이너, DB/계정 jskim
  • 배포: Gitea Actions → Harbor(harbor.wace.me/dev-pilots/jskim) → Docker + Traefik(HTTPS, jskim.vexplor.com)

로컬 개발

DB가 방화벽 뒤에 있어 SSH 터널이 필요하다.

# 터미널 1: DB 터널 (localhost:5436 -> pg-jskim)
./scripts/db-tunnel.sh

# 터미널 2: 개발 서버
npm run dev

배포

dev-pilots 교육 파이프라인을 그대로 사용한다. main 브랜치에 push하면 Gitea Actions(.gitea/workflows/deploy.yml)가 자동으로:

  1. Docker 이미지 빌드 → Harbor push (harbor.wace.me/dev-pilots/jskim)
  2. deploy/docker-compose.yml로 컨테이너 교체 (web + pgnet 네트워크, Traefik 라벨, 포트 3000)
  3. Traefik이 jskim.vexplor.com HTTPS 라우팅

운영 DATABASE_URL과 Harbor 인증(HARBOR_USER/HARBOR_SECRET)은 저장소 Secrets로 이미 등록되어 있다.

구조

src/
  app/              # App Router 페이지
    api/health/     # DB 연결 헬스체크
  lib/db.ts         # pg Pool (DATABASE_URL 사용)
scripts/db-tunnel.sh
Dockerfile              # standalone 빌드, node:20-alpine
deploy/docker-compose.yml  # 배포 정의 (Traefik 라벨, 앱 포트)
.gitea/workflows/deploy.yml  # CI/CD (dev-pilots 표준)
S
설명
제공된 설명이 없습니다
Readme
47 MiB
언어
TypeScript 96.1%
CSS 3%
Shell 0.3%
JavaScript 0.3%
Dockerfile 0.3%