# ARTLINK — 예술인·아티스트 구인구직/중개 플랫폼

첨부된 **예술인(아티스트) 특화 구인구직 플랫폼 기획/개발 견적서**의 범위를 바탕으로 구성한 PHP MVC 프로젝트입니다.

## 구현 범위

### 공용 사용자 화면
- 메인: 히어로 검색, 분야별 탐색, 추천 공고, 추천 아티스트, 작품 디스커버리, 공지
- 채용공고: 검색/필터/정렬, 목록, 상세, 관심공고, 온라인 지원
- 아티스트: 검색/필터, 목록, 공개 프로필, 포트폴리오, 경력/소개
- 서비스 소개 / FAQ / 공지 / 이용약관 / 개인정보처리방침
- 이메일 로그인/회원가입/비밀번호 찾기
- 카카오 / 네이버 / Google OAuth 연동 구조
- PWA manifest / service worker 기본 구성

### 아티스트 페이지
- 대시보드
- 공개 프로필 관리
- 맞춤 이력서 관리
- 포트폴리오 관리
- 지원 현황
- 받은 스카웃
- 관심공고
- 알림
- 계정/공개범위/알림 설정

### 기업·클라이언트 페이지
- 기업 대시보드
- 기업 프로필 및 승인 상태
- 채용공고 목록 / 신규 등록
- 공고별 지원자 관리
- 인재 검색
- 스카웃 제안 및 관리
- 상품·결제
- 기업 계정/알림 설정

### 관리자 페이지
- 통합 대시보드
- 회원 관리
- 기업 승인
- 채용공고 관리
- 아티스트 관리
- 지원 / 스카웃 관리
- 상품 / 결제 관리
- 배너 관리
- 신고 관리
- 공지·콘텐츠 관리
- 예술 카테고리 관리
- 통계 분석
- 서비스 운영 설정
- 관리자 로그

## 개발 구조

- PHP 8.1+ 권장
- 순수 PHP MVC 구조
- MySQL 8 / MariaDB 10.5+
- PDO Prepared Statement
- Session 인증 + CSRF
- Font Awesome
- 반응형 웹 + 모바일 하단 앱형 내비게이션
- SNS OAuth: Kakao, Naver, Google
- DB 미연결 시 DEMO_MODE로 전체 UI 확인 가능

## 폴더 구조

```text
artlink_platform/
├─ app/
│  ├─ Core/              Router, DB, Auth, CSRF, View
│  ├─ Controllers/       공용/아티스트/기업/관리자 컨트롤러
│  ├─ Repositories/      PDO 데이터 접근 + 데모 fallback
│  ├─ Services/          SNS OAuth
│  ├─ Support/           데모 데이터, helper
│  └─ Views/             전체 화면
├─ config/               app, DB, social 설정
├─ database/             schema.sql, seed.sql, install.php
├─ public/               index.php, CSS/JS, 이미지, PWA
├─ storage/              로그/업로드 확장용
├─ routes.php
├─ server.php
└─ .env.example
```

## 바로 실행 — 데모 모드

```bash
cd artlink_platform
php -S 0.0.0.0:8000 server.php
```

브라우저에서 `http://localhost:8000` 접속.

데모 로그인:
- 아티스트: `artist@example.com` / `demo1234`
- 기업: `client@example.com` / `demo1234`
- 관리자: `admin@example.com` / `demo1234`

로그인 화면의 **빠른 화면 확인** 버튼으로 비밀번호 없이 역할별 화면을 볼 수도 있습니다.

## MySQL 연결

1. `.env.example`을 `.env`로 복사합니다.
2. DB 정보를 수정합니다.
3. `DEMO_MODE=false`로 변경합니다.
4. DB 설치 스크립트를 실행합니다.

```bash
cp .env.example .env
php database/install.php
```

수동 설치 시 `database/schema.sql` → `database/seed.sql` 순서로 실행해도 됩니다.

## SNS 로그인

`.env`에 각 개발자센터에서 발급한 키를 입력합니다.

```env
KAKAO_CLIENT_ID=
KAKAO_CLIENT_SECRET=
KAKAO_REDIRECT_URI=https://your-domain.com/auth/kakao/callback

NAVER_CLIENT_ID=
NAVER_CLIENT_SECRET=
NAVER_REDIRECT_URI=https://your-domain.com/auth/naver/callback

GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=
GOOGLE_REDIRECT_URI=https://your-domain.com/auth/google/callback
```

키가 없을 때는 오류 대신 설정 안내 화면이 표시됩니다.

## Apache 배포

가장 안전한 방식은 Apache DocumentRoot를 `artlink_platform/public`으로 지정하는 것입니다.

```apache
<VirtualHost *:80>
    ServerName artlink.example.com
    DocumentRoot /var/www/artlink_platform/public

    <Directory /var/www/artlink_platform/public>
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>
```

`mod_rewrite`를 활성화하고 HTTPS 적용을 권장합니다.

## 이미지 자산

`public/assets/img/ui/artlink-concept-board.png`와 `public/assets/img/portfolio/`의 샘플 작품 이미지는 이번 프로젝트를 위해 생성한 오리지널 이미지 자산을 활용했습니다. 실제 서비스에서는 아티스트 업로드 원본, 썸네일 생성, EXIF 제거, 용량 제한, 스토리지/CDN 정책을 추가하는 것을 권장합니다.

## 운영 전 추가 권장사항

- 이메일 인증 / 휴대폰 본인인증
- 실제 파일 업로드 스토리지(S3 호환 포함)
- 이미지 썸네일 자동 생성
- PG사 계약 및 결제 승인/취소 Webhook
- 알림톡/문자/이메일 발송 모듈
- 관리자 권한 세분화(RBAC)
- 개인정보 암호화 및 보관기간 정책
- 신고/제재 정책 확정
- 이용약관/개인정보처리방침 법률 검토
- 대용량 영상은 직접 저장보다 YouTube/Vimeo/전용 CDN 연동 권장

## 샘플의 목적

UI 시안만 모은 HTML이 아니라, 실제 개발로 확장할 수 있도록 라우팅, 역할별 인증, PDO Repository, DB 스키마, OAuth 연결부, CSRF, 반응형 화면을 포함한 MVC 베이스 프로젝트로 구성했습니다.
