Filient - macOS 파일 자동 정리 앱

Filient는 macOS 사용자를 위한 지능형 파일 자동 정리 솔루션입니다.

🎯 현재 개발 상태 (2025.01)

✅ 완료된 기능

🏗️ 핵심 아키텍처

• SQLite 데이터베이스 기반 구축 (15개 테이블)
• Clean Architecture 기반 프로젝트 구조 설계
• 개발/배포 환경별 데이터베이스 경로 분리
• UUID 기반 데이터 식별자 시스템
• BLoC 패턴 기반 상태 관리

� 폴더 관리 시스템

• 폴더 추가/삭제/즐겨찾기 기능
• 사이드바 폴더 목록 UI
• 폴더별 규칙 연결 시스템

📋 규칙 관리 시스템 (완료도: ~90%)

• 규칙 CRUD 기능: 생성/수정/삭제/조회
• 우선순위 관리: High/Medium/Low 우선순위 자동 execution_order 관리
• 조건 시스템: 파일명, 날짜, 확장자, 크기, 태그, Any File 조건 지원
• 액션 시스템: 이동, 복사, 별칭, 삭제, 이름변경, 날짜별분류, 종류별분류, 태그관리, 코멘트 지원
• 규칙 편집기 UI: 조건/액션 추가/삭제, 우선순위 설정, 고급 옵션
• 조건/액션 다이얼로그: 완전한 폼 UI와 검증 로직 ✅ 완료
• 실시간 목록 업데이트: 규칙 생성/수정/삭제 시 즉시 반영
• 규칙 재정렬: 같은 우선순위 내에서 드래그 앤 드롭으로 순서 변경

🔧 데이터 레이어

• Repository 패턴 구현
• UseCase 계층 분리
• 의존성 주입 컨테이너 설정
• 트랜잭션 기반 복합 작업 처리

�🚧 개발 중 (진행률 표시)

📋 규칙 시스템 마무리 (~5% 남음)

• 조건/액션 다이얼로그 UI 구현 ✅ 완료
• 규칙 실행 엔진 구현 (파일 시스템 연동)
• 하위폴더 포함 기능 (설계 완료, 4단계 구현 계획)
  • Phase 1: 하위폴더 스캔 & 데이터베이스 레이어
  • Phase 2: UseCase & Repository 레이어
  • Phase 3: 폴더 트리 UI & 실시간 동기화
  • Phase 4: 하위폴더 규칙 토글 & 상속 관리
• 승인 시스템 연동

🤖 AI 규칙 생성 (0%)

• AI 챗봇 UI 구현
• 자연어 처리 및 규칙 변환
• LLM 모델 연동 (클라우드/로컬)

📊 히스토리 & 롤백 시스템 (0%)

• 실행 이력 추적 시스템
• 4단계 상세 추적 (폴더→규칙→파일→액션)
• 유연한 롤백 시스템
• 히스토리 UI

⚡ Direct Action (0%)

• 파일/폴더 직접 선택 UI
• 드래그 앤 드롭 지원
• 조건 없는 액션 실행

🎛️ 승인 시스템 (0%)

• 승인 대기함 UI
• 알림 시스템
• 미리보기 기능

📈 대시보드 (0%)

• 통계 카드 (규칙 수, 처리된 파일, 절약 시간)
• 활동 분석 차트
• AI 기반 정리 제안

🎨 룰 탭 (규칙 템플릿) (0%)

• 저장된 규칙 관리
• 규칙 템플릿화
• 그룹핑 및 즐겨찾기

⚙️ 설정 (0%)

• 언어 설정 (한글/영어)
• 테마 설정 (다크/라이트)
• 알림 설정
• 자동 정리 주기 설정

🖥️ macOS 네이티브 연동 (0%)

• 파일 시스템 API 연동
• macOS 태그 시스템 연동
• 시스템 알림 연동

🔄 자동 업데이트 시스템 (100% ✅ 완료)

• Sparkle 2.x 프레임워크 연동
• 개발/프로덕션 환경 자동 분리
• S3 기반 업데이트 배포 시스템
• EdDSA 암호화 서명 시스템
• 사용자 친화적 타이밍 설정
• 전체 시스템 문서화 완료

📚 문서:

• 상세 가이드: docs/AUTO_UPDATE_SYSTEM.md
• 빠른 시작: docs/AUTO_UPDATE_QUICK_START.md

📋 TODO 우선순위

1. 규칙 시스템 완성 (1주)

   • 규칙 실행 엔진 구현 (핵심!)
   • 하위폴더 포함 기능

2. macOS 파일 시스템 연동 (1주)

   • 네이티브 파일 조작 API

3. 히스토리 & 롤백 (2주)

   • 실행 추적 시스템
   • 롤백 기능

4. AI 규칙 생성 (2-3주)

   • 자연어 처리
   • LLM 연동

5. 나머지 기능들 (3-4주)

   • Direct Action, 대시보드, 설정 등

🗂 문서

• 프로젝트 문서 허브: docs/index.md
• 핵심 문서: 아키텍처(docs/architecture.md), DB(docs/database.md), 규칙(docs/rules.md), 실행(docs/execution.md), 플랫폼(docs/platform.md)

🛠 개발 환경 설정

# 패키지 설치
flutter pub get

# macOS에서 실행
flutter run -d macos

📊 데이터베이스

개발 환경: ./database/filient.db
배포 환경: ~/Documents/filient_data/filient.db

🏗 Architecture

lib/
├── core/          # 데이터베이스, 상수, 유틸리티
├── data/          # 데이터 소스, 모델, 레포지토리 구현체
├── domain/        # 엔티티, 레포지토리 인터페이스, UseCase
├── presentation/  # UI, BLoC, 위젯
└── platform/      # macOS 네이티브 연동

debug, info, warning, error, verbose, none

flutter run -d macos --dart-define=LOG_LEVEL=none

📋 로그 레벨별 표시되는 내용

레벨	표시되는 로그	사용 시나리오
none	없음	로그 완전 비활성화
error	error()	프로덕션, 중요 에러만
warning	error(), warning()	주의가 필요한 상황 포함
info	error(), warning(), info(), success()	일반 작업 흐름 확인
debug	+ debug(), database(), performance()	개발 중 디버깅
verbose	모든 로그	상세 분석 필요시