mates-infra/home-nas-tools/README.md

🗂 home-nas-tools

Rejstřík projektů uložených na NAS. Tento adresář obsahuje pouze metadata – samotné archivy zůstávají na NAS, do Gitea se nekopírují.

🎯 Účel

• ✅ Orientace – vědět co kde je
• ✅ Replikace – snadné znovuvytvoření na novém stroji
• ✅ Dokumentace – co archiv obsahuje, jak ho rozbalit, jak nasadit

📍 Cesta k archivům (NAS)

Všechny archivy jsou uloženy na:

/Volumes/Backups/Prace/moje-tools/

Tato cesta je specifická pro tvůj Mac s připojeným NAS (SMB). Na novém stroji musíš připojit NAS (/Volumes/Backups/...) nebo zkopírovat archivy ručně (např. přes scp, USB disk, cloud).

📚 Rejstřík projektů

Názvy projektů v tomto README jsou zobecněné popisy – konkrétní názvy archivů a popis obsahu zůstávají pouze v NAS. Pokud chceš znát detail, otevři si archive-index.md (gitignored, lokální soubor na tvém Macu) nebo přímo NAS.

🔐 Bezpečnost a utility

Projekt	Archiv (pouze NAS)	Velikost	Účel
web-aplikace	web-aplikace.txt	~135 B	Poznámky k web nástrojům (OSINT)
backup-bitcopy	bitcopy-backup-*.tar.gz	~9 KB	Bit-perfect zálohovací nástroj (shell)
whois-util	whois.zip	~3 KB	Whois lookup utilita

🕵️ Forenzika a bezpečnostní analýza

Projekt	Archiv (pouze NAS)	Velikost	Účel
forensic-asistent-1	Digitalní*asistent*.zip	~9 MB	Asistent pro forenzní výslechy
forensic-pipeline	forensic-pipeline.zip	~53 MB	Forenzní pipeline (zpracování důkazů)
gesture-to-pin	gesto*pin.zip	~54 KB	Web app: gesture → PIN
wireless-auditor	aircrack-ng.zip	~29 MB	Kompilace wireless auditu
network-mapper	network-topology-mapper.zip	~1.2 MB	Mapper síťové topologie
rpi4-scanner	zaloha-rpi4-*.zip	~3 MB	Raspberry Pi 4 scanner

📄 Konverze dokumentů

Projekt	Archiv (pouze NAS)	Velikost	Účel
json2xml	jonson2xml.zip	~43 MB	JSON ↔ XML konverze
json2xml-batch	prevod-json-souboru-do-xml.zip	~4 KB	Batch konverze
xml-sms-parser	prevod-xml-sms-zalohy.zip	~16 KB	SMS XML parser
ocr2txt	ocr2txt.zip	~7 KB	OCR extrakce textu
ocr2txt-v2	ocr2txt-*.zip	~31 MB	OCR v2
forensic-helper	programAmateriX.zip	~47 KB	Forenzní pomůcka

📧 E-maily

Projekt	Archiv (pouze NAS)	Velikost	Účel
eml-comparator	provnani-eml-slozek.zip	~12 MB	Porovnání EML složek

💻 Hardware a utility

Projekt	Archiv (pouze NAS)	Velikost	Účel
usb-share	usb-share.zip	~7 KB	USB share utilita
unique-pw	unik-hesel.zip	~1 KB	Unique passwords utilita
foto-dokumentace	_skript-na-fotodokumentaci.zip	~154 KB	Skript pro fotodokumentaci

🤖 AI / Asistenti (velké archivy)

Projekt	Archiv (pouze NAS)	Velikost	Účel
ai-asistent-docker	AI_Prepis-docker-*.7z	~1.3 GB	AI asistent – Docker verze
ai-asistent-portable	AI_Prepis-portable-*.zip	~14 GB	AI asistent – Portable
ai-asistent-final	AI_Prepis-portable-FINAL*.zip	~3 GB	AI asistent – finální verze
prace-kolekce	_prace-programy.zip	~1.2 GB	Pracovní programy (kolekce)

📊 Statistiky (přibližné)

Kategorie	Počet	Celková velikost
Bezpečnost a utility	3	~12 KB
Forenzika	6	~4 GB
Konverze dokumentů	6	~94 MB
E-maily	1	~12 MB
Hardware	3	~4 MB
AI / Asistenti	4	~19 GB
Celkem	23	~23 GB

🗂 Struktura adresáře

home-nas-tools/
├── README.md                    # Tento soubor (zobecněný)
└── archive-index.md            # GITIGNORED – lokální index s konkrétními názvy

🔄 Jak znovuvytvořit na novém stroji

1. Připoj NAS

# macOS
mount -t smbfs //user@nas/Backups/Prace /Volumes/nas-tools

# Nebo zkopíruj archivy přes rsync/scp
rsync -av user@nas:/Backups/Prace/moje-tools/ /Users/Shared/nas-tools/

2. Rozbal archiv

cd /Users/Shared/nas-tools
tar -xzf bitcopy-backup-*.tar.gz
unzip 'gesto*pin.zip'
unzip -P <password> zaloha-rpi4-*.zip

3. Nasaď podle README

Každý projekt má v NAS vlastní README s konkrétním postupem instalace.

⚠️ Bezpečnost

• Archivy obsahují citlivá data (forenzní dumpy, uniklá hesla, interní utility)
• NEVER pushuj archivy do Gitea – vždy zůstávají na NAS
• Některé archivy jsou šifrované – chraň hesla v keychainu
• Nesdílej tento adresář na veřejných platformách bez kontroly
• Pro prezentaci kolegům použij jinou verzi tohoto README (bez konkrétních odkazů)

🔐 Doporučené zálohovací schéma

┌──────────────────────┐
│  Mac (~/Skripty/)    │ ← Pracovní kopie
└──────────┬───────────┘
           │ rsync (denně)
           ▼
┌──────────────────────┐
│  NAS (moje-tools/)   │ ← Centrální záloha
└──────────┬───────────┘
           │ off-site backup
           ▼
┌──────────────────────┐
│  Cloud (S3/Backblaze)│ ← Disaster recovery
└──────────────────────┘

📝 Pro vlastní potřebu (lokální, ne v gitu)

Vytvoř si lokálně soubor archive-index.md s konkrétními názvy archivů a jejich obsahem:

# Vytvoř si lokální soukromý index
cat > ~/git-repos/mates/home-nas-tools/.archive-index.md << 'EOF'
# Soukromý index – NEVER commit
# Konkrétní názvy archivů na NAS

| Archiv | Cesta k souboru | MD5 | Poznámka |
|---|---|---|---|
| ai-asistent-docker | /Volumes/Backups/Prace/moje-tools/AI_Prepis-docker-verze.7z | abc123 | ... |
...
EOF

# Tento soubor je v .gitignore, takže zůstane jen u tebe