sokuree_web_front/README.md

Sokuree Consultant Web Project (v1.1.0)

**소쿠리 컨설턴트(Sokuree Consultant)**의 공식 웹사이트 프로젝트입니다. React 기반의 모던 프론트엔드와 WordPress Headless CMS 백엔드를 결합하여 제작되었습니다.

---

🛠 Tech Stack (기술 스택)

• Frontend: React, Vite
• Backend (CMS): WordPress (Headless API)
• Deployment: Synology Web Station (Static Hosting)
• Key Libraries: react-router-dom, dompurify, formsubmit-co

---

🚀 Getting Started (시작하기)

이 프로젝트를 처음부터 설치하고 실행하는 방법입니다.

1. 사전 요구사항 (Prerequisites)

• Node.js (v16 이상 권장)
• Git

2. 설치 (Installation)

터미널(CMD/PowerShell)을 열고 다음 명령어를 순서대로 실행하세요.

# 1. 프로젝트 복제 (Clone)
git clone https://github.com/your-repo/antigravity.git
cd antigravity

# 2. 의존성 패키지 설치
npm install

3. 설정 (Configuration)

백엔드(워드프레스) 연결을 위해 설정 파일 확인이 필요할 수 있습니다.

• src/api/wordpress.js 파일에서 API 주소가 올바른지 확인하세요.
  • 기본값: https://api.sokuree.com/wp-json (예시)

4. 개발 서버 실행 (Run Dev Server)

로컬 환경에서 웹사이트를 미리 확인합니다.

npm run dev

이제 브라우저에서 http://localhost:5173 으로 접속하면 사이트가 뜹니다.

---

📚 Documentation (상세 문서)

프로젝트에 대한 자세한 내용은 docs/ 폴더 내의 가이드 문서를 참고하세요.

문서	설명
📄 Code Structure	코드 구조 및 컴포넌트 설명 (개발자 필독)
🛠 WordPress Setup	백엔드(Wordpress) 설치 및 Headless 설정 가이드
☁️ Deployment Guide	시놀로지 NAS에 최종 배포하는 방법

---

✨ Features (주요 기능)

• 반응형 디자인: PC/모바일 모두 최적화된 UI.
• 소식(News) 연동: 워드프레스 글을 실시간으로 가져와 보여줌.
• 문의하기(Contact): 스팸 방지(Rate Limit) 및 알림 기능이 탑재된 이메일 폼.
• 보안(Security): 우클릭 방지, 이미지 드래그 방지, XSS 방어 적용.
• 개인정보보호: 별도의 DB 없이 이메일로만 통신하며, 즉시 파기 정책 준수.

---

📦 Version History

• v1.1.1 (Current): 문서 현행화 및 최종 정리.
• v1.1.0: 보안 및 기능 최종 수정.
• v1.0.0: 초기 런칭 버전.