Image Voice Memos

User Workflow

flowchart TD
    A["📁 Select Folder"] --> B["🖼️ Load Photo Grid"]
    B --> C["👆 Select Photo"]
    C --> D{"Voice memo\nexists?"}

    D -- No --> E["🎙️ Start Recording"]
    D -- Yes --> K["▶️ Playback / 🗑️ Delete"]

    E --> F["⏱️ 1s Countdown\n+ Hardware Warmup"]
    F --> G["🔴 Recording\n+ Waveform Display"]
    G --> H["⏹️ Stop"]
    H --> I["💾 PCM → AAC\nConversion"]
    I --> J["📝 Transcription\n(Speech Framework)"]
    J --> L{"Translation\nenabled?"}
    L -- Yes --> M["🌐 DE → EN\nTranslation"]
    L -- No --> N["✅ Done"]
    M --> N
    K --> C

    style A fill:#1a3a5c,stroke:#5e9eff,color:#e8e8e8
    style G fill:#5c1a1a,stroke:#ff5e5e,color:#e8e8e8
    style N fill:#1a5c2a,stroke:#34d058,color:#e8e8e8
            

State Machine — VoiceMemoState

stateDiagram-v2
    [*] --> noNote
    noNote --> countingDown : Record
    countingDown --> recording : Countdown = 0
    recording --> converting : Stop
    recording --> noNote : Cancel
    converting --> noteExists : AAC saved
    noteExists --> playing : Play
    noteExists --> countingDown : Re-Record
    noteExists --> noNote : Delete
    playing --> paused : Pause
    playing --> noteExists : Stop / End
    paused --> playing : Resume
    paused --> noteExists : Stop
            

System Overview

graph TD
    subgraph V["Views"]
        CV[ContentView] --> DV[DetailView]
        CV --> PG[PhotoGridView]
    end

    subgraph VM["ViewModels"]
        LVM[LibraryViewModel]
        VNVM[VoiceMemoViewModel]
    end

    subgraph S["Services"]
        ARS[AudioRecording]
        TS[Transcription]
        TRS[Translation]
        ILS[ImageLoading]
    end

    subgraph FS["File System"]
        M4A[".m4a"]
        TXT[".txt"]
        ENTXT[".en.txt"]
    end

    PG --> LVM
    DV --> VNVM
    LVM --> ILS
    VNVM --> ARS
    VNVM --> TS
    VNVM --> TRS
    ARS --> M4A
    TS --> TXT
    TRS --> ENTXT

    style V fill:#1a2a3a,stroke:#5e9eff,color:#e8e8e8
    style VM fill:#2a1a3a,stroke:#a05eff,color:#e8e8e8
    style S fill:#1a3a2a,stroke:#34d058,color:#e8e8e8
    style FS fill:#3a2a1a,stroke:#f0883e,color:#e8e8e8
            

Audio Pipeline

flowchart TD
    MIC["Microphone"] --> PCM["PCM 44.1kHz .caf"]
    PCM --> AAC["AAC .m4a"]
    AAC --> PLAY["Playback"]
    AAC --> SF["Speech Framework"]
    SF --> TXT["Transcript .txt"]
    TXT --> TR["Translation Framework"]
    TR --> EN["Translation .en.txt"]

    style MIC fill:#5c1a1a,stroke:#ff5e5e,color:#e8e8e8
    style AAC fill:#1a3a5c,stroke:#5e9eff,color:#e8e8e8
    style TXT fill:#1a5c2a,stroke:#34d058,color:#e8e8e8
    style EN fill:#3a2a1a,stroke:#f0883e,color:#e8e8e8
            

File Structure — Sidecar Pattern