{"id":49820091,"url":"https://github.com/prgrms-fullcycle-devcourse/webfull_9_10_ddal-kkak_be","last_synced_at":"2026-05-13T10:01:45.979Z","repository":{"id":353548749,"uuid":"1217667715","full_name":"prgrms-fullcycle-devcourse/webfull_9_10_DDAL-KKAK_BE","owner":"prgrms-fullcycle-devcourse","description":"프로그래머스 웹 풀스택 9기 10회차 딸깍 BE : Travel-Tick","archived":false,"fork":false,"pushed_at":"2026-05-11T04:22:14.000Z","size":188,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-11T05:33:23.114Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/prgrms-fullcycle-devcourse.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-22T05:33:05.000Z","updated_at":"2026-05-07T11:50:56.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/prgrms-fullcycle-devcourse/webfull_9_10_DDAL-KKAK_BE","commit_stats":null,"previous_names":["prgrms-fullcycle-devcourse/webfull_9_10_ddal-kkak_be"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/prgrms-fullcycle-devcourse/webfull_9_10_DDAL-KKAK_BE","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prgrms-fullcycle-devcourse%2Fwebfull_9_10_DDAL-KKAK_BE","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prgrms-fullcycle-devcourse%2Fwebfull_9_10_DDAL-KKAK_BE/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prgrms-fullcycle-devcourse%2Fwebfull_9_10_DDAL-KKAK_BE/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prgrms-fullcycle-devcourse%2Fwebfull_9_10_DDAL-KKAK_BE/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/prgrms-fullcycle-devcourse","download_url":"https://codeload.github.com/prgrms-fullcycle-devcourse/webfull_9_10_DDAL-KKAK_BE/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prgrms-fullcycle-devcourse%2Fwebfull_9_10_DDAL-KKAK_BE/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32977273,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-13T06:31:55.726Z","status":"ssl_error","status_checked_at":"2026-05-13T06:31:51.336Z","response_time":115,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-05-13T10:01:45.033Z","updated_at":"2026-05-13T10:01:45.974Z","avatar_url":"https://github.com/prgrms-fullcycle-devcourse.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ✈️ Travel-Tick\n\n\u003e **여행은 내가 할게, 기록은 네가 할래?**  \n\u003e 영수증 한 장으로 완성되는 AI 기반 여행 소비 기록 서비스\n\n---\n\n## 🧭 프로젝트 소개\n\n여행 정산 서비스 'Travel-Tick'의 백엔드 저장소입니다.\n\n## 🛠 기술 스택\n\n- **Language**: TypeScript\n- **Framework**: Node.js (Express)\n- **Database**: PostgreSQL (Prisma ORM)\n- **Security \u0026 Config**: Doppler (Secret Management)\n- **Architecture**: Layered Architecture (Controller - Service - Repository)\n- **Code Quality**: ESLint, Prettier, Husky, Commitlint\n\n## 📂 프로젝트 구조\n\n본 프로젝트는 유지보수성과 테스트 용이성을 위해 **Layered Architecture**를 따릅니다.\n\n```text\nsrc/\n├── config/             # 환경 변수, DB 연결 등 전역 설정\n├── constants/          # 에러 메시지, 공통 상태 코드 등 상수\n├── controllers/        # [Layer 1] 요청/응답 처리, 입력값 검증 호출\n├── services/           # [Layer 2] 핵심 비즈니스 로직, 데이터 가공\n├── models/             # [Layer 3] DB 스키마 정의 (TypeORM, Mongoose 등)\n├── repositories/       # (선택) DB 직접 접근 로직 분리 시 사용\n├── errors/             # 커스텀 에러 클래스 정의 (AppError, NotFoundError 등)\n├── lib/                # 외부 라이브러리 초기화 및 싱글톤 (PrismaClient)\n│   └── prisma.ts       # PrismaClient 인스턴스화 및 어댑터 설정\n├── routes/             # 엔드포인트 정의 및 컨트롤러 연결\n├── middlewares/        # 인증, 로깅, 에러 핸들링 등 공통 미들웨어\n├── utils/              # 공통 함수 (날짜 계산, 암호화 등)\n├── types/              # 공통 TypeScript 인터페이스/타입 정의\n├── app.ts              # Express 앱 설정 및 미들웨어 등록\n└── main.ts             # 서버 구동 (포트 리스닝)\n```\n\n---\n\n## 🚀 시작하기\n\n### 1. 사전 준비\n\n- [Doppler CLI](https://docs.doppler.com/docs/install-cli) 설치 및 로그인 (`doppler login`)\n- Node.js (v18+ 권장) 및 npm\n\n### 2. 의존성 설치\n\n프로젝트 의존성을 설치합니다. 설치 후 `prisma generate`가 자동 실행됩니다.\n\n```bash\nnpm install\n```\n\n### 3. 환경 변수 및 데이터베이스 설정\n\nDoppler를 통해 환경 변수를 설정하고 데이터베이스 스키마를 동기화합니다.\n\n```bash\n# 로컬 개발용 .env 파일 생성\nnpm run env:download\n\n# DB 마이그레이션 실행 (테이블 생성)\nnpm run db:migrate\n```\n\n### 4. 애플리케이션 실행\n\n```bash\n# Development (Hot-reload with Doppler)\nnpm run dev\n\n# Production Build \u0026 Start\nnpm run build\nnpm start\n```\n\n### 5. 주요 유틸리티 명령어\n\n| Command             | Description                                    |\n| :------------------ | :--------------------------------------------- |\n| `npm run lint`      | ESLint를 통한 코드 정적 분석                   |\n| `npm run format`    | Prettier를 통한 코드 포맷팅                    |\n| `npm run db:studio` | Prisma Studio(GUI)로 DB 데이터 확인            |\n| `npm run db:reset`  | DB 초기화 (데이터 삭제 및 마이그레이션 재실행) |\n\n---\n\n## 🛣️ API 경로\n\n추후 업데이트될 예정입니다.\n\n### 🔐 인증 (Auth) - 예정\n\n| Method | Endpoint | Description |\n| :----- | :------- | :---------- |\n\n### 👤 유저 (User) - 예정\n\n| Method | Endpoint | Description |\n| :----- | :------- | :---------- |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprgrms-fullcycle-devcourse%2Fwebfull_9_10_ddal-kkak_be","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprgrms-fullcycle-devcourse%2Fwebfull_9_10_ddal-kkak_be","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprgrms-fullcycle-devcourse%2Fwebfull_9_10_ddal-kkak_be/lists"}