Toogeduler

사람들의 일정을 안전하게 공유하고, 모두가 만날 수 있는 시간을 찾는 공유 캘린더입니다.

구성

• web: Next.js 16 + TypeScript 프론트엔드
• api: Spring Boot 3 + Spring Security + JPA API
• PostgreSQL 16

빠른 시작

1. 데이터베이스

docker compose up -d db

2. API

JDK 21 이상과 Maven이 필요합니다.

cd api
./mvnw spring-boot:run

API는 http://localhost:8080에서 실행됩니다. 처음 실행할 때 데모 계정과 일정이 자동 생성됩니다.

3. 웹

cd web
cp .env.example .env.local
npm install
npm run dev

웹은 http://localhost:3000에서 실행됩니다.

데모 로그인: [email protected] / password123!

주요 API

• /api/auth/* 회원가입·로그인
• /api/events/* 일정 CRUD 및 공개 URL
• /api/groups/* 그룹·초대 링크·그룹 캘린더
• /api/groups/{id}/availability 전원 및 후보 가능 시간 계산
• /api/notifications/* 알림 목록·읽음 처리

Google·Kakao 소셜 로그인 설정

애플리케이션 코드는 준비되어 있으며, 발급받은 키는 저장소에 작성하지 않고 실행 환경변수로 전달합니다.

Google

Google Cloud Console의 OAuth 2.0 클라이언트에 다음 URI를 등록합니다.

• 승인된 JavaScript 원본: http://localhost:3000
• 승인된 리디렉션 URI: http://localhost:8080/login/oauth2/code/google

Kakao

Kakao Developers의 [앱] → [플랫폼 키] → [REST API 키]에서 Redirect URI와 Client Secret을 설정하고, 동의 항목에서 닉네임을 활성화합니다. Toogeduler는 서버 REST API 방식이므로 JavaScript 키는 사용하지 않습니다. 이메일 권한이 없는 일반 앱에서도 카카오 고유 회원번호로 가입할 수 있습니다.

• Redirect URI: http://localhost:8080/login/oauth2/code/kakao
• REST API 키를 KAKAO_CLIENT_ID로 사용
• Client Secret을 활성화한 경우 KAKAO_CLIENT_SECRET으로 사용

.env 작성

cd api
cp .env.example .env

api/.env 파일의 아래 항목에 발급값을 입력합니다.

GOOGLE_CLIENT_ID=발급값
GOOGLE_CLIENT_SECRET=발급값
KAKAO_CLIENT_ID=발급값
KAKAO_CLIENT_SECRET=발급값

이후 API를 실행하면 Spring Boot가 .env를 자동으로 읽습니다.

./mvnw spring-boot:run

운영 환경에서는 WEB_URL과 OAUTH_REDIRECT_BASE_URL도 각각 실제 웹·API HTTPS 주소로 지정합니다.

Railway + Vercel 배포

Railway에 Spring Boot API와 PostgreSQL을, Vercel에 Next.js 웹을 배포하는 전체 절차는 배포 가이드를 참고하세요.

운영 배포에서 반드시 설정해야 하는 값:

위치	변수	설명
Railway	JWT_SECRET	openssl rand -base64 48. 기본값이면 서버가 시작을 거부합니다
Railway	SEED_DEMO=false	데모 계정 생성 차단. true면 서버가 시작을 거부합니다
Railway	WEB_URL	운영 웹 HTTPS 주소
Vercel	NEXT_PUBLIC_OAUTH_URL	운영 API 주소. 없으면 소셜 로그인 버튼이 숨겨집니다
Vercel	NEXT_PUBLIC_SHOW_DEMO=false	데모 계정 안내 숨기기

모바일 앱 (iOS · Android)

web은 Capacitor 네이티브 셸을 포함합니다. 빌드 시 운영 주소를 반드시 지정합니다.

cd web
CAPACITOR_SERVER_URL=https://app.<도메인> npm run mobile:sync
npm run mobile:ios

• 빌드 절차: 모바일 배포 가이드
• 앱스토어 제출 절차와 심사 대응: App Store 가이드