How aleuuu/hranilka works
Хранилка is a Windows desktop app for organizing local photos and documents from a user’s instructions. The main workflow is to choose a folder, scan and analyze its files, review and adjust a proposed organization plan, then apply moves and renames; the app also supports undo. React screens call a typed API backed by Tauri commands, which bridge to a separate Python engine and Rust file operations. The README documents local Ollama models, onboarding and model setup; unsampled subsystem links below rely on those documented capabilities, not inspection of their implementation.
Main entry points: store.ts App state · Shell.tsx Screen router · lib.rs Command handlers · Plan.tsx Plan review
Components 25
Interface
- UI entry
src/main.tsx - App shell
src/App.tsx - Onboarding
src/screens/Onboarding.tsx - Screen router
src/screens/Shell.tsx - Dialogs
src/screens/Modals.tsx - App state
src/store.ts - Typed API
src/lib/api.ts - Browser mock
src/lib/mock.ts - UI components
src/ui.tsx - Formatting
src/lib/format.ts - Domain types
src/lib/types.ts
Organization workflow
- Folder selection
src/screens/Start.tsx - Analysis view
src/screens/Analysis.tsx - Plan review
src/screens/Plan.tsx - Plan tuning
src/screens/Tune.tsx - Apply result
src/screens/Result.tsx
Desktop services
- Command handlers
src-tauri/src/lib.rs - Engine process bridge
src-tauri/src/engine.rs - File moves and undo
src-tauri/src/fsops.rs - Ollama management
src-tauri/src/ollama.rs - System checks
src-tauri/src/sys.rs - Settings storage
src-tauri/src/settings.rs
Analysis engine
- Scan and plan engine
engine/engine.py
Other components
- User
- Ollama service
Connections 37
- User → UI entry: opens app
README.md - UI entry → App shell: renders
src/main.tsx - App shell → Onboarding: renders
src/App.tsx - App shell → Screen router: renders
src/App.tsx - App shell → Dialogs: renders
src/App.tsx - Screen router → Folder selection: routes to
src/screens/Shell.tsx - Screen router → Analysis view: routes to
src/screens/Shell.tsx - Screen router → Plan review: routes to
src/screens/Shell.tsx - Screen router → Apply result: routes to
src/screens/Shell.tsx - Screen router → Plan tuning: routes to
src/screens/Shell.tsx - Onboarding → App state: starts checks
src/screens/Onboarding.tsx - Folder selection → App state: selects folder
src/screens/Start.tsx - Analysis view → App state: uses state
src/screens/Analysis.tsx - Plan review → App state: uses state
src/screens/Plan.tsx - Plan tuning → App state: uses state
src/screens/Tune.tsx - Apply result → App state: uses state
src/screens/Result.tsx - App state → Typed API: calls
src/store.ts - Typed API → Browser mock: selects fallback
src/lib/api.ts - Typed API → Command handlers: invokes commands
src/lib/api.ts - Command handlers → Engine process bridge: dispatches engine calls
src-tauri/src/lib.rs - Command handlers → File moves and undo: delegates file operations
src-tauri/src/lib.rs - Command handlers → Ollama management: delegates model management
src-tauri/src/lib.rs - Command handlers → System checks: checks system
src-tauri/src/lib.rs - Command handlers → Settings storage: reads and saves settings
src-tauri/src/lib.rs - Engine process bridge → Scan and plan engine: exchanges JSON
src-tauri/src/engine.rs - Scan and plan engine → Ollama service: uses local models
README.md - Ollama management → Ollama service: manages models
README.md - App state → Domain types: uses domain types
src/store.ts - Typed API → Domain types: uses domain types
src/lib/api.ts - Browser mock → UI components: renders sample data with
src/lib/mock.ts - Analysis view → UI components: uses components
src/screens/Analysis.tsx - Plan review → Formatting: formats display values
src/screens/Plan.tsx - Plan review → UI components: uses components
src/screens/Plan.tsx - Analysis view → Formatting: formats display values
src/screens/Analysis.tsx - Scan and plan engine → File moves and undo: produces plan for
README.md - User → Plan review: reviews organization plan
README.md - User → File moves and undo: applies or undoes moves
README.md