Android 개발

// Android Jetpack Compose .cursorrules

// 유연성 알림

// 참고: 이것은 권장되는 프로젝트 구조이지만 기존 프로젝트 구조에 맞추어 유연성을 유지하세요.
// 프로젝트가 다른 조직 방식을 따르는 경우 이러한 구조 패턴을 강제로 적용하지 마세요.
// 기존 프로젝트 아키텍처와의 일관성을 유지하면서 Android Jetpack Compose 모범 사례를 적용하세요.

// 프로젝트 아키텍처 및 모범 사례

const androidJetpackComposeBestPractices = [
"코드 정리 원칙을 유지하면서 기존 프로젝트 아키텍처에 적응하기",
"Material Design 3 가이드 및 구성 요소 따르기",
"도메인 레이어, 데이터 레이어, 프레젠테이션 레이어를 포함한 정리된 아키텍처 구현",
"비동기 작업을 위한 Kotlin 코루틴 및 Flow 사용",
"Hilt를 사용한 의존성 주입 구현",
"ViewModel 및 UI State에 대한 단방향 데이터 흐름 따르기",
"Compose Navigation을 사용한 화면 관리",
"적절한 상태 승격 및 조합 구현",
];

// 폴더 구조

// 참고: 이것은 참조 구조입니다. 프로젝트의 기존 조직에 맞게 적응하세요.

const projectStructure = `app/
  src/
    main/
      java/com/package/
        data/
          repository/
          datasource/
          models/
        domain/
          usecases/
          models/
          repository/
        presentation/
          screens/
          components/
          theme/
          viewmodels/
        di/
        utils/
      res/
        values/
        drawable/
        mipmap/
    test/
    androidTest/`;

// Compose UI 가이드

const composeGuidelines = `

1. 적절한 remember 및 derivedStateOf 사용
2. 적절한 재구성 최적화 구현
3. 올바른 Compose 수식어 순서 사용
4. Composable 함수에 대한 명명 규칙 따르기
5. 적절한 미리보기 주석 구현
6. 적절한 상태 관리를 위한 MutableState 사용
7. 적절한 오류 처리 및 로딩 상태 구현
8. 적절한 테마를 위한 MaterialTheme 사용
9. 접근성 가이드 따르기
10. 적절한 애니메이션 패턴 구현
    `;

// 테스트 가이드

const testingGuidelines = `

1. ViewModels 및 UseCases에 대한 단위 테스트 작성
2. Compose 테스트 프레임워크를 사용한 UI 테스트 구현
3. 테스트를 위한 모의 저장소 사용
4. 적절한 테스트 커버리지 구현
5. 적절한 테스트 코루틴 스케줄러 사용
   `;

// 성능 가이드

const performanceGuidelines = `

1. 키값을 적절히 사용하여 재구성 최소화
2. LazyColumn 및 LazyRow를 사용한 적절한 지연 로딩 구현
3. 효율적인 이미지 로딩 구현
4. 불필요한 업데이트를 방지하기 위한 적절한 상태 관리 구현
5. 적절한 라이프사이클 인식 따르기
6. 적절한 메모리 관리 구현
7. 적절한 백그라운드 처리 구현
   `;