giftcon_dev/README.md

PIN FOR YOU (Gifticon Platform)

PIN FOR YOU는 상품권/모바일 교환권(기프티콘) 거래/구매를 위한 웹 서비스입니다.
보안(핀번호/민감정보), 결제 연동, 회원 인증, 운영 안정성을 최우선으로 설계합니다.

---

문서(Documentation)

• 보안
  • Google reCAPTCHA v3 적용 가이드
  • SMS 발송/인증 가이드

새로운 설명 문서는 docs/ 아래에 계속 추가합니다.
예: docs/deploy/, docs/dev/, docs/ops/ 등

---

기술 스택(Tech Stack)

• Backend: PHP / Laravel 12
• DB: MySQL 또는 MariaDB
• Cache/Queue: Redis (선택/구성에 따라)
• Web: Nginx (또는 Apache) + PHP-FPM
• Frontend: Vite 기반 리소스 빌드 (@vite)

---

서버/환경 정보(Environment)

아래는 운영/개발 환경에 맞게 값만 채워주세요.

• Service Domain: https://four.syye.net
• Admin Domain: (예: https://shot.syye.net)
• PHP: 8.x
• Laravel: 12.x
• DB: MySQL 8.x 또는 MariaDB 10.x/11.x
• Redis: x.x (사용 시)
• OS: Ubuntu xx.xx / Docker 사용 여부: Yes/No

---

레포지토리 구조(요약)

• app/ : Laravel 앱 코드
• resources/ : Blade / CSS / JS 소스
• routes/ : 라우팅 정의
• public/ : 정적 파일, 빌드 산출물
• docs/ : 운영/개발/보안 문서 (지속 확장)
  • docs/security/ : 보안 관련 문서

---

실행/개발(Development)

1) 필수 준비물

• PHP / Composer
• Node.js / npm (Vite 빌드)
• MySQL/MariaDB
• (선택) Redis

2) 설치

composer install
npm install