| Frontend | Next.js 16, React 19, TypeScript, Tailwind CSS v4, three.js, React Three Fiber |
| Backend | Kotlin, Spring Boot 4, Spring Data JPA, Flyway, Testcontainers |
| Database | PostgreSQL 17 |
| Infra | Vercel, AWS Lightsail, Docker Compose, Caddy, GitHub Actions |
flowchart LR
user["브라우저"] --> web["Next.js<br>Vercel"]
web -->|"/api 프록시"| caddy["Caddy<br>Lightsail"]
caddy --> api["Spring Boot"]
api --> db[("PostgreSQL")]
api <-->|로그인| google["Google OAuth"]
gha["GitHub Actions"] -.->|배포| web
gha -.->|배포| api
이렇게 만들었어요
- 픽셀 무대: three.js 장면을 고정된 가로 픽셀 수로 그려서, 화면 크기가 달라도 도트 밀도가 같아요.
- 빠른 첫 화면: 무대는 글자와 버튼이 뜬 뒤 따로 불러와요.
- 장면 관리: 장면은 코드가 아니라 DB에 버전별로 저장해요. 새 장면은 초안으로 들어가고 관리자 화면에서 검수해요.
- 연속 장면: 다음 장면은 전체 장면 순서를 그대로 따라가요. 예고 문구와 묶음은 장면 데이터로 정해요.
- 효과음: 음원 파일 없이 Web Audio로 그때그때 만들어요.
- 공유 카드: 장면과 결과마다 Open Graph 이미지를 코드로 그려요.
- 지표: 크롤러와 자동화 브라우저는 이용 지표에서 빼요.
프로젝트 구조
.
├── frontend/src/
│ ├── app/ # Next.js 라우트, 폰트, 전역 스타일
│ └── features/ # 기능별 코드
│ ├── scene/ # 장면 플레이
│ ├── stage/ # 픽셀 무대와 캐릭터
│ ├── landing/ # 홈, 데모, 장면 목록
│ ├── typetest/ # 유형 테스트
│ ├── collection/ # 표현 모음
│ ├── review/ # 오늘의 복습
│ ├── rewards/ # 보상 물건
│ ├── account/ # 로그인, 내 정보, 아지트
│ ├── share/ # 공유 카드
│ └── site/ # 머리줄, 전체 메뉴, 화면 틀
├── backend/src/main/
│ ├── kotlin/com/nuanci/ # scene, account, reward, streak, review, event, metrics, admin ...
│ └── resources/db/migration/ # Flyway 마이그레이션
├── scripts/ # 로컬 실행, 배포, 장면 업로드
├── compose.yaml # 로컬 PostgreSQL
└── compose.prod.yaml # 운영 서버 구성






