🏷️ 네이밍 컨벤션

메잇볼 팀에서는 가독성과 유지보수 효율성을 최우선으로 하여 아래와 같은 네이밍 규칙을 따릅니다.

---

1️⃣ 컴포넌트 명명법

• PascalCase 사용 (예: UserProfile, MatchCard)
• 이유: React, Vue 등 주요 프레임워크에서 컴포넌트를 구분하기 쉽고, JSX/TSX에서 HTML 태그와 명확히 구분되어 가독성이 뛰어납니다.

---

2️⃣ 폴더명

• 케밥 케이스(kebab-case) 사용 (예: user-profile, match-card)
• 이유: OS 파일 시스템과 URL 경로 모두에서 표준적으로 널리 쓰이며, 공백 대신 하이픈을 쓰는 케밥 케이스는 직관적이고 읽기 편합니다. 또한, 대소문자 구분에 따른 혼란도 줄여주고, 터미널이나 명령어 입력 시 오타 가능성을 줄입니다.

---

3️⃣ 파일명 (컴포넌트 제외)

• 케밥 케이스(kebab-case) 사용 (예: api-client.ts, user-service.ts)
• 이유: 폴더명과 동일한 이유로, 여러 플랫폼에서 일관된 표기와 편한 인식이 가능하며, 특히 윈도우, 맥, 리눅스 환경 모두에서 호환이 좋습니다.

---

4️⃣ 변수, 함수명

• camelCase 사용 (예: getUserData, totalCount)
• 이유: JavaScript와 TypeScript의 표준 스타일이며, 소문자로 시작해 변수를 선언함으로써 가독성이 높고 직관적입니다.

---

5️⃣ 함수 파라미터명

• camelCase 사용
• 이유: 변수명과 동일한 규칙을 적용해 일관성을 유지하고, 함수 내부에서의 가독성을 향상시킵니다.

---

6️⃣ 상수명

• BIG_SNAKE_CASE 사용 (예: MAX_USER_COUNT, API_BASE_URL)
• 이유: 상수임을 명확하게 구분해주어 수정하면 안 되는 값이라는 의미를 직관적으로 전달하고, 다른 변수와 쉽게 구별됩니다.

---

✨ 추가 설명 및 효과

• 케밥 케이스를 폴더 및 일반 파일명에 적용하는 것은 실제 개발 및 배포 환경에서 경로 혼동, 오타, 대소문자 문제를 크게 줄여주며,
• 특히 협업 과정에서 누구나 일관된 방식으로 파일을 찾고 관리할 수 있어 유지보수가 쉬워집니다.
• 컴포넌트는 UI 단위로 중요도가 높아 가독성과 프레임워크 표준에 맞춘 PascalCase를 사용해 쉽게 구분할 수 있게 하였습니다.
• 변수, 함수, 파라미터는 JavaScript 커뮤니티의 표준인 camelCase로, 자연스러운 코드 흐름을 만들어 줍니다.
• 상수는 대문자 스네이크 케이스로 표시하여 변경하지 않는 값임을 직관적으로 알 수 있게 하여 실수를 방지합니다.