Tempo (가칭)

stateDiagram-v2
    [*] --> TODO: 작업 생성
    TODO --> FOCUS: 집중 시작 (focus 점유)
    TODO --> BG: 백그라운드 착수
    TODO --> DONE: 즉시 완료
    FOCUS --> BG: 위임·자리비움 (focus 해제)
    BG --> FOCUS: 다시 직접 집중 (focus 점유)
    FOCUS --> PENDING: 블로커 발생
    BG --> PENDING: 블로커 발생
    PENDING --> FOCUS: 블로커 해소·집중
    PENDING --> BG: 블로커 해소·백그라운드
    FOCUS --> DONE: 완료
    BG --> DONE: 완료
    PENDING --> DONE: 완료/취소
    DONE --> TODO: 재오픈(되돌리기)
    note right of FOCUS
      focus는 전체에서 동시에 1개만 존재한다.
      새 작업이 FOCUS로 진입하면 기존 FOCUS는
      자동으로 BG 또는 직전 상태로 강등된다 (2.2).
    end note
    

flowchart TD
    U["사용자 — 자유형 마크다운 노트 작성/편집"]
    U -->|15s 스냅샷| C["Collection: before/after diff 추출"]
    C --> A1["Agent 1: Diff Parser\n변경 항목 추출 (들여쓰기 레벨 포함)"]
    A1 --> A2["Agent 2: Task Mapper\n기존 task 매핑 or 신규 생성\nparent-child 관계 설정"]
    A2 --> A3["Agent 3: Pattern Classifier\n변경 패턴 분류"]
    A3 --> TG["Task Graph Store"]
    TG --> K["Kanban · Mainboard"]
    TG --> RS["Right Sidebar 이벤트 스트림"]
    TG --> R["Report 세션 분석"]
    

flowchart TD
    A([틱: 1초/이벤트 발생]) --> B{일과 진행 중?}
    B -- 아니오 --> Z[모든 타이머 정지]
    B -- 예 --> C{유휴 임계 초과?}
    C -- 예 --> I["focus 세션 일시정지
유휴로 기록"] --> D
    C -- 아니오 --> R{focus 세션 복귀?}
    R -- 예 --> RS[focus 세션 재개]
    R -- 아니오 --> D
    RS --> D
    D{현재 focus 작업 존재?}
    D -- 예 --> E[focus 작업 += 경과]
    D -- 아니오 --> F[focus 누적 없음]
    E --> G
    F --> G
    G[[백그라운드 작업 집합 순회]] --> H{각 BG 작업 진행중?}
    H -- 예 --> J[해당 작업 백그라운드 += 경과]
    H -- 아니오 --> K[건너뜀]
    J --> L([세션 테이블에 반영])
    K --> L
    

erDiagram
    WORKDAY       ||--o{ TIME_SESSION  : "포함"
    WORKDAY       ||--o{ POPUP_LOG    : "포함"
    TASK          ||--o{ TIME_SESSION  : "측정됨"
    TASK          ||--o{ POPUP_LOG    : "참조됨"
    TASK          ||--o{ TIMELINE_MEMO: "이벤트 로그"
    TASK          }o--o| TASK         : "parent(자기참조)"
    NOTE_SNAPSHOT ||--o{ TASK         : "원천"
    PROJECT       ||--o{ TASK         : "그룹핑(선택)"

    PROJECT {
      uuid   id PK
      string name
      string color
    }
    TASK {
      uuid     id PK
      string   label
      string   status      "TODO|PENDING|FOCUS|BG|DONE"
      uuid     parent_id   FK "nullable — 업무분해 계층"
      string   source_text "원본 노트 텍스트"
      int      cumulative_ms
      uuid     project_id  FK "nullable"
      datetime created_at
      datetime completed_at "nullable"
    }
    TIMELINE_MEMO {
      uuid     id PK
      uuid     task_id FK
      string   event_type  "EXPANSION|DECOMPOSITION|STATUS_CHANGE|NEW_TASK"
      string   description "AI 생성 설명"
      datetime timestamp
    }
    NOTE_SNAPSHOT {
      uuid     id PK
      datetime captured_at
      text     content     "전체 마크다운"
    }
    TIME_SESSION {
      uuid     id PK
      uuid     task_id FK
      uuid     workday_id FK
      string   kind "FOCUS|BACKGROUND"
      datetime started_at
      datetime ended_at "nullable=진행중"
      int      idle_sec "유휴 제외분"
    }
    POPUP_LOG {
      uuid     id PK
      uuid     workday_id FK
      uuid     task_id FK "nullable=무응답"
      datetime shown_at
      datetime responded_at "nullable"
      string   note "한 줄 상태"
      string   outcome "ANSWERED|SNOOZED|MISSED|NEW_TASK"
    }
    WORKDAY {
      uuid     id PK
      date     date
      datetime start_at
      datetime end_at "nullable=진행중"
      bool     auto_started
    }
    SETTINGS {
      int   popup_interval_min "기본 5"
      int   idle_threshold_min "기본 5"
      time  default_start
      time  default_end
      string theme
    }
    

flowchart LR
    L[앱 실행] --> B[메인 보드]
    B -->|일과 시작/자동| B
    B -. 주기 경과 .-> P[Spotlight 팝업]
    P -->|저장/스누즈| B
    B -->|새 작업| N[작업 생성 모달]
    N --> B
    B -->|카드 클릭| D[작업 상세]
    D --> B
    B -->|일과 종료| R[일과 리포트]
    R -->|닫기| B
    B -->|기록 메뉴| H[과거 기록 조회]
    H -->|날짜 선택| R2[과거 리포트]
    R2 --> H
    B -->|설정| S[설정]
    S --> B
    

sequenceDiagram
    participant Sch as 스케줄러
    participant UI as Spotlight 팝업
    participant U as 사용자
    participant E as 시간엔진
    Sch->>UI: 주기 도래 → 팝업 표시(현재 focus 강조)
    UI->>U: "지금 집중 대상?" + 메모 입력
    alt 기존 작업 유지/선택
        U->>UI: 작업 선택 + 한 줄 메모
        UI->>E: focus 갱신(필요 시 전환 로직)
        UI->>UI: PopupLog(ANSWERED) 저장
    else 새 작업 생성
        U->>UI: 제목 입력
        UI->>E: 신규 Task 생성 후 focus 지정
        UI->>UI: PopupLog(NEW_TASK) 저장
    else 스누즈(Esc)
        U->>UI: 나중에
        UI->>Sch: N분 뒤 재노출
        UI->>UI: PopupLog(SNOOZED) 저장
    else 무응답(타임아웃)
        UI->>UI: PopupLog(MISSED) 저장, focus 유지
    end
    UI-->>Sch: 다음 주기 예약