Ghost-Server

카트라이더 고스트 기능을 모티브로 한 러닝 앱 백엔드. 자세한 기능/API 스펙은 requirements.md, 개발 가이드는 CLAUDE.md 참조.

---

데모 모드 셋업

데모 단계에서는 로그인을 비활성화하고 클라가 매 호출에 userId(예: user_1)를 쿼리 파라미터로 전달합니다. 따라서 데모 시작 전 유저 row 시드가 필요합니다.

1) 시드 SQL 실행 (유저 15명 + 코스 2개)

전체 데모 데이터는 db/seed.sql 에 정리되어 있습니다. 앱이 한 번 이상 기동되어 스키마가 생성된 뒤 실행하세요.

# 로컬 MySQL
mysql -u root -p ghost < db/seed.sql

# EC2 MySQL (SSH 후)
scp db/seed.sql ec2-user@<EC2_HOST>:~/seed.sql
ssh ec2-user@<EC2_HOST>
mysql -u root -p ghost < ~/seed.sql

• 유저 PK 1~15 → 호출 시 userId=user_1 ~ userId=user_15
• 코스 PK 1, 2 → courseId=course_1 (성성호수 공원), course_2 (단대호수 공원)
• 재실행 안전: INSERT IGNORE + route points DELETE 후 재삽입
• PK 를 명시하므로 데모 전용 DB 에서만 사용 (운영 데이터 혼재 시 충돌 위험)

2) 프로필 이미지

main-server/src/main/resources/static/avatars/ 안의 파일은 Spring Boot가 자동으로 정적 리소스로 서빙합니다.

• 접근 URL: http://<host>:8080/avatars/bear.png (또는 chicken.png)
• 이미지 교체/추가는 같은 폴더에 파일을 넣고 서버를 재시작
• 운영 단계에선 S3 같은 외부 스토리지로 이관 권장 (jar에 묶이지 않게)

3) 호출 예 (Swagger)

POST   /api/v1/runs?userId=user_1
POST   /api/v1/runs/run_1/locations?userId=user_1
PATCH  /api/v1/runs/run_1/stop?userId=user_1
GET    /api/v1/courses/course_1/leaderboard?userId=user_1

Swagger UI: http://localhost:8080/swagger-ui/index.html (로컬 프로파일에선 /swagger-ui.html도 허용)