Cleanup, documentation added, new GUI

2025-12-23 11:28:05 +01:00
parent 9882bede8c
commit fe529ecfdd
6 changed files with 2395 additions and 1 deletions
--- a/README.md
+++ b/README.md
@@ -0,0 +1,174 @@
+# 🏷️ Tagger
+
+Desktopová aplikace pro správu a organizaci souborů pomocí hierarchických tagů (štítků).
+
+## ✨ Hlavní funkce
+
+- 📁 Rekurzivní procházení složek
+- 🏷️ Hierarchické tagy (kategorie/název)
+- 🔍 Filtrování podle tagů a textu
+- 💾 Metadata v JSON souborech (.!tag)
+- 🎬 Automatická detekce rozlišení videí (ffprobe)
+- 🎨 Dvě verze GUI: klasické a moderní (qBittorrent-style)
+
+## 🚀 Rychlý start
+
+```bash
+# Instalace závislostí
+poetry install
+
+# Spuštění (moderní GUI)
+poetry run python Tagger_modern.py
+
+# Nebo klasické GUI
+poetry run python Tagger.py
+```
+
+## 📸 Screenshot
+
+### Moderní GUI (qBittorrent-style)
+```
+┌─────────────────────────────────────────────────────┐
+│ 📁 Otevřít │ 🔄 │ 🏷️ │ 📅     🔍 [____]  Toolbar
+├────────────┬────────────────────────────────────────┤
+│ 📂 Štítky  │ Název    │Datum│Štítky│Velikost       │
+│  ├─📁 Stav │ file1.txt│2025 │HD    │1.2 MB         │
+│  │ ☑ Nové  │ file2.mp4│     │4K    │15 MB          │
+│  ├─📁 Video│ file3.jpg│     │RAW   │845 KB         │
+│  │ ☐ HD    │                                        │
+├────────────┴────────────────────────────────────────┤
+│ Připraven              3 vybráno │ 125 souborů      │
+└─────────────────────────────────────────────────────┘
+```
+
+## 🎯 Použití
+
+1. **Otevři složku** - Načti soubory ze složky (rekurzivně)
+2. **Vytvoř tagy** - Hierarchická struktura (kategorie → tagy)
+3. **Přiřaď tagy** - Označ soubory, vyber tagy
+4. **Filtruj** - Klikni na tagy pro filtrování souborů
+5. **Vyhledávej** - Textové vyhledávání v názvech
+
+## ⌨️ Keyboard Shortcuts (moderní GUI)
+
+- `Ctrl+O` - Otevřít složku
+- `Ctrl+T` - Přiřadit tagy
+- `Ctrl+D` - Nastavit datum
+- `F5` - Refresh
+- `Del` - Smazat z indexu
+
+## 🏗️ Architektura
+
+```
+┌─────────────────────────────────┐
+│  Presentation (UI)              │  ← Tkinter GUI
+├─────────────────────────────────┤
+│  Business Logic                 │  ← FileManager, TagManager
+├─────────────────────────────────┤
+│  Data Layer                     │  ← File, Tag models
+├─────────────────────────────────┤
+│  Persistence                    │  ← JSON .!tag soubory
+└─────────────────────────────────┘
+```
+
+## 📁 Struktura projektu
+
+```
+Tagger/
+├── Tagger.py              # Entry point (klasické GUI)
+├── Tagger_modern.py       # Entry point (moderní GUI)
+├── PROJECT_NOTES.md       # ⭐ Kompletní dokumentace
+├── src/
+│   ├── core/              # Business logika
+│   │   ├── file.py
+│   │   ├── tag.py
+│   │   ├── file_manager.py
+│   │   └── tag_manager.py
+│   └── ui/
+│       ├── gui.py         # Klasické GUI
+│       └── gui_modern.py  # Moderní GUI
+└── tests/                 # 116 testů
+```
+
+## 🧪 Testování
+
+```bash
+# Všechny testy (116 testů, 100% core coverage)
+poetry run pytest tests/ -v
+
+# S coverage report
+poetry run pytest tests/ --cov=src/core --cov-report=html
+```
+
+## 📝 Dokumentace
+
+**Veškerá dokumentace je v jednom souboru:**
+
+👉 **[PROJECT_NOTES.md](PROJECT_NOTES.md)** ⭐
+
+Obsahuje:
+- Kompletní dokumentaci projektu
+- Architektonická rozhodnutí (ADR)
+- Coding standards
+- Git workflow
+- Known issues & TODO
+- Debugování tipy
+- Pravidla pro AI asistenty
+
+## 🛠️ Technologie
+
+- **Python:** 3.12
+- **GUI:** Tkinter (standard library)
+- **Dependencies:** Pillow (PIL)
+- **Package manager:** Poetry
+- **Testing:** pytest
+
+## 📊 Metriky
+
+- **Řádky kódu:** ~1060 Python LOC
+- **Testy:** 116 (všechny ✅)
+- **Test coverage:** 100% core modulů
+- **GUI verze:** 2 (klasická + moderní)
+
+## 🎯 Design Decisions
+
+### Proč JSON místo databáze?
+- ✅ Jednoduchý backup (copy složky)
+- ✅ Git-friendly (plain text)
+- ✅ Portable (žádné DB dependencies)
+- ✅ Metadata zůstanou při přesunu souboru
+
+### Proč Tkinter?
+- ✅ Standard library (žádné extra deps)
+- ✅ Cross-platform
+- ✅ Dobře dokumentované
+
+### Proč Poetry?
+- ✅ Deterministické buildy (poetry.lock)
+- ✅ Dev dependencies oddělené
+- ✅ Moderní nástroj
+
+## 🐛 Known Issues
+
+- Git merge konflikty s poetry.lock při merge devel→feature
+- Dlouhé operace (ffprobe) blokují UI - TODO: threading
+
+## 🚀 Plánované features
+
+- [ ] Progress bar pro dlouhé operace
+- [ ] Undo/Redo mechanismus
+- [ ] Export do CSV/Excel
+- [ ] Dark mode theme
+- [ ] Drag & drop souborů
+
+## 📄 License
+
+MIT License
+
+## 👤 Autor
+
+honza
+
+---
+
+**Pro detailní dokumentaci viz [PROJECT_NOTES.md](PROJECT_NOTES.md)**