401db0cb9e41c18b78e69f3277bd6e7bcbf992c2
- build2.png → 고양이 집·햇볕 데크·장터·창고 일러스트 적용 - nature.png → 나무 3종(보드=소나무, 외곽=3종 순환)·데이지·튤립·밀· 버섯·바위·꽃덤불 — 캔버스 나무/장식 이모지 제거 - icons.png → 생선·목재·돌·구이·발바닥 코인·망치·땀·접시·잠·화남·팬·하트 판자 배지(아이콘+숫자), 말풍선(생산·식사·수면·파업·회수), HUD pill 적용 - 캔버스 이모지 렌더링이 브라우저/OS 폰트에 따라 깨지던 문제 해결 - 원본 3장 assets-src 보관, 이모지는 이미지 로드 실패 시 폴백으로 유지 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
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
- 환경변수:
.env.local(gitignore 대상,.env.example참고) - DB 연결 확인: http://localhost:3000/api/health
배포
dev-pilots 교육 파이프라인을 그대로 사용한다. main 브랜치에 push하면
Gitea Actions(.gitea/workflows/deploy.yml)가 자동으로:
- Docker 이미지 빌드 → Harbor push (
harbor.wace.me/dev-pilots/jskim) deploy/docker-compose.yml로 컨테이너 교체 (web+pgnet네트워크, Traefik 라벨, 포트 3000)- Traefik이
jskim.vexplor.comHTTPS 라우팅
운영 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 표준)
언어
TypeScript
96.1%
CSS
3%
Shell
0.3%
JavaScript
0.3%
Dockerfile
0.3%