Skip to content

wodndb/kotonoha

Repository files navigation

Kotonoha

개인적인 목적으로 만든 일본어 단어장 웹 앱.

개발자를 위한 프로젝트 실행 방법

개발환경 설정

  1. VSCode 설치 (다른 편집기 또는 IDE 사용한다면 패스)
  2. nvm (node 22), yarn 설치
  3. docker desktop 설치 (supabase cli용)
  4. supabase cli 설치 (로컬 개발 및 테스트용)

프로젝트 실행 (로컬 개발 환경 기준)

  1. supabase start로 supabase cli 실행
  2. .template.env 파일을 복사하여 .env 파일로 저장한 뒤, 본인 환경에 맞게 값 수정
    cp .template.env .env
    • DATABASE_URL 값은 supabase start 실행 결과 출력되는 DB URL 값을 사용할 것
  3. docker compose up -d 명령어로 DB 서버 실행 (Adminer는 http://localhost:8080에서 접속 가능)
  4. yarn 명령어로 의존성 패키지 설치
  5. yarn prisma generate 명령어로 Prisma Client 생성
  6. yarn prisma migrate deploy 명령어로 DB 스키마 생성
  7. yarn dev 명령어로 Next.js 애플리케이션 실행

prisma로 마이그레이션 관리하기

초기 마이그레이션 추가 (최초 1회)

yarn prisma migrate dev --name init

스키마 업데이트 후 마이그레이션 추가

# 테스트 목적으로 마이그레이션 없이 스키마 바로 DB에 반영
yarn prisma db push

# 테스트까지 완료 후 변경된 스키마에 대한 마이그레이션 생성
yarn prisma migrate reset
yarn prisma migrate dev --name \<migration_name\> --create-only

# 만약 생성된 마이그레이션 sql 파일에 문제가 있는 경우 (계속 사용되어야 할 기존 데이터를 삭제하는 등...)
# sql 파일을 수정하고 나서
yarn prisma migrate deploy

실제 DB에 마이그레이션 적용

yarn prisma migrate deploy

About

Web service to study Japanese words for personal purposes.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages