# PIN FOR YOU (Gifticon Platform)

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

---
컨테이너 안에서 tinker 사용방법
HOME=/tmp XDG_CONFIG_HOME=/tmp php artisan tinker

## 문서(Documentation)

- 보안
    - [Google reCAPTCHA v3 적용 가이드](docs/security/recaptcha.md)
    - [SMS 발송/인증 가이드](docs/security/sms.md)

> 새로운 설명 문서는 `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) 설치
```bash
composer install
npm install
