전체적인 구조와 기능

[nninnnin]

전체적인 구조와 기능

앱 형태

macOS 네이티브 앱 (Swift). 메뉴바에 상주하며, 네 개의 레이어로 구성된다.

┌─────────────────────────────────┐
│  Nudge (AI 인텔리전스 레이어)     │  맥락 알림, 정리 제안
├─────────────────────────────────┤
│  Project View (프로젝트 뷰)      │  현황판, 중요도 시각화, 정리 액션
├─────────────────────────────────┤
│  Sync (싱크 레이어)              │  클라우드 동기화, 모바일 접근
├─────────────────────────────────┤
│  Watcher (감시 레이어)           │  FSEvents, 활동 기록, 훅
└─────────────────────────────────┘
        ↕
  로컬 파일 시스템 (source of truth)

앱 동선

평소에는 메뉴바에 조용히 상주한다. Finder에서 관리 대상 디렉터리를 열면 훅이 발동하고, 할 말이 있으면 알림이 뜬다. 알림을 누르면 앱 화면(프로젝트 뷰)이 열린다. 사용자가 "앱을 열어야지"라고 의식하는 게 아니라, 하던 행동에서 자연스럽게 넘어오는 흐름이다.

모바일에서는 훅이 없으므로, 앱을 직접 열어서 프로젝트에 접근한다. 이 경우 앱이 프로젝트 진입점 역할을 한다.

플랫폼

• macOS (메인): 네이티브 Swift 앱. 메뉴바 상주 + 풀 앱 화면. FSEvents, NSWorkspace 등 시스템 API 직접 사용.
• iOS (추후): 싱크된 파일의 열람/편집 클라이언트 + 동일한 Project View 제공. 훅 없이 앱 직접 진입.
• 크로스플랫폼 프레임워크(Flutter 등)는 사용하지 않는다. macOS 시스템 API에 깊이 의존하는 구조이므로 네이티브가 적합.

모듈 요약

모듈	역할	핵심 키워드
Watcher	파일 시스템 관찰, 활동 데이터 수집	FSEvents, 훅, 폴더 열림 감지
Sync	로컬 ↔ 클라우드 동기화	로컬퍼스트, 모바일 접근
Project View	프로젝트 상태 시각화, 정리 액션	현황판, 중요도, 아카이브
Nudge	AI 기반 맥락 알림	LLM, 상황 인식, 제안