RepoAudit QT
Audit repozitáře. Detekce APP_ konstant, metadata, struktura projektu.
Co projekt řeší
RepoAudit QT je analytické centrum pro audit větších zdrojových repozitářů. Automaticky vytěžuje aplikační metadata, kontroluje závislosti, dokumentaci a grafické assety a ukládá výsledky tak, aby bylo možné porovnávat stav projektu v čase.
Jak aplikace funguje a k čemu slouží
Přehled
RepoAudit QT je analytické centrum celého projektu MFilmDB. Slouží k udržování hygieny repozitáře, extrakci technických metadat ze všech sub-aplikací a dohledu nad konzistencí dokumentace a grafických zdrojů.
- Metadata Extraction: Automatický parsing , a přímo z Python souborů.
- SVG Integrity: Auditní subsystém pro detekci vadných ikon (blank render, chybějící viewBox).
- Dependency Analysis: Identifikace 3rd party importů a kontrola jejich dostupnosti v prostředí.
- Documentation Guard: Vizualizace pokrytí aplikací README soubory a HTML dokumentací.
Základní údaje
| Framework | (Qt6) |
|---|---|
| Persistence | SQLite (historie auditů, statistiky) |
| Kategorie auditu | MAIN, BONUS, DEV_TOOLS, SYSTEM_TOOLS |
| Statistiky | Počet řádků (LOC), velikost, pokrytí DOC |
Použití
Aplikace slouží k automatizované kontrole celého repozitáře MFilmDB.
- Skenování: Tlačítko "Spustit audit" projde všechny složky a vyhledá Python soubory.
- Metadata: Automaticky extrahuje verze, autory a popisy přímo ze zdrojového kódu.
- Dokumentace: Indikuje chybějící README nebo HTML dokumentaci (červený/zelený indikátor).
- SVG Audit: Speciální modul pro kontrolu a automatickou opravu SVG ikon (viewBox, render test).
Troubleshooting
- Pomalé skenování: První spuštění může trvat déle u velkých repozitářů. Data jsou následně cachována v DB.
- Chybné verze: Pokud aplikace nenajde verzi, ujistěte se, že v kódu používáte standardní proměnné jako nebo .
- Zablokovaný auto-fix: Před spuštěním opravy SVG doporučujeme mít čistý GIT stav pro případný rollback.
FAQ
Lze exportovat výsledky? Ano, k dispozici je export kompletního auditního logu do formátu TXT.
Funguje to i na jiné projekty? Aplikace je optimalizována pro strukturu MFilmDB, ale lze ji adaptovat přenastavením kořenových složek.