# 🗂 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

```bash
# 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

```bash
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:

```bash
# 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
```