66 lines
1.6 KiB
Markdown
66 lines
1.6 KiB
Markdown
# PIN FOR YOU (Gifticon Platform)
|
|
|
|
PIN FOR YOU는 **상품권/모바일 교환권(기프티콘) 거래/구매**를 위한 웹 서비스입니다.
|
|
보안(핀번호/민감정보), 결제 연동, 회원 인증, 운영 안정성을 최우선으로 설계합니다.
|
|
|
|
---
|
|
|
|
## 문서(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
|