o2o-clinicad-frontend/README.md

프로젝트

• 이름 : Clinic AD

기술 스택

• React 19 + TypeScript
• Vite
• Tailwind CSS
• TanStack Query
• Zustand

디렉토리 구조

디렉토리 구조는 다음을 따를 예정입니다.

src/
├── app/              # 애플리케이션 진입점 및 전역 설정 (Router, Providers, 글로벌 스타일)
├── assets/           # 정적 파일 (이미지, 폰트, 로티 애니메이션 등)
├── components/       # 도메인에 종속되지 않는 공통 UI 컴포넌트 (버튼, 모달, 디자인 시스템)
├── features/         # 핵심 비즈니스 로직 및 도메인 영역 (이 구조의 핵심)
│   ├── auth/         # 특정 도메인 (예: 인증)
│   │   ├── api/      # 해당 도메인 전용 API 통신 함수
│   │   ├── hooks/    # 해당 도메인 전용 커스텀 훅
│   │   ├── store/    # 해당 도메인 전용 상태 (Zustand 등)
│   │   ├── types/    # 해당 도메인 전용 타입 정의
│   │   └── ui/       # 해당 도메인 전용 UI 컴포넌트
├── hooks/            # 전역에서 사용하는 공통 훅 (useClickOutside 등)
├── layouts/          # 페이지 레이아웃 (GNB, Sidebar, 풋터 등)
├── pages/            # 라우팅과 1:1 매칭되는 페이지 진입점 (여기서는 features의 컴포넌트만 조립)
├── services/         # 공통 API 클라이언트 설정 (Axios 인스턴스, 인터셉터 등)
├── store/            # 전역 상태 관리 (사용자 세션, 테마 등)
└── utils/            # 공통 유틸리티 함수 (날짜 포맷팅, 정규식 등)

시작하기

설치

npm install

실행

npm run dev