SAN 프론트엔드 코드 컨벤션 (React + TypeScript)

1. 프로젝트 철학 & 아키텍처


2. 네이밍 규칙 (Naming Conventions)

대상 규칙 예시
파일 & 폴더 소문자 기반 scope popup, options
컴포넌트 PascalCase ScrapList.tsx, NotifyPanel.tsx
변수 & 함수 camelCase isPanelOpen, handleScrap()
상수 UPPER_SNAKE_CASE THEME_COLOR_MINT, MAX_TITLE_LENGTH
Type/Interface PascalCase (접두사 없이) ScrapItem, UserConfig

3. 디렉토리 구조 (Directory Structure)

익스텐션과 대시보드의 코드를 효율적으로 관리하기 위한 구조입니다.

기존의 feature 단위를 모노레포 패키지 단위로 확장합니다.

root/
├── packages/
│   ├── shared/             # [Brain] 비즈니스 로직, 데이터 규격
│   │   ├── src/types/      # ERD 기반 인터페이스 (card.ts, scrap.ts)
│   │   ├── src/api/        # Axios 인스턴스 및 API 호출 함수
│   │   └── src/utils/      # 포맷터, 스토리지 추상화
│   ├── ui/                 # [Skin] 디자인 시스템, 순수 컴포넌트
│   │   ├── src/components/ # LeafCard, Button, Tag (Stateless)
│   │   └── src/styles/     # Tailwind v4 전역 설정 및 유틸리티
│   ├── extension/          # 크롬 익스텐션 앱 (Chrome API 연동)
│   └── dashboard/          # 웹 대시보드 앱 (React + Vite)

4. 컴포넌트 작성 규칙