# mates-home-nas-tools

Metadata k projektům uloženým na **NAS** (Network Attached Storage).
Toto repo obsahuje **pouze popisy a cesty** – samotné archivy zůstávají na NAS.

> **Proč to tu je?** Aby ses při práci na novém stroji nebo při obnově po havárii **věděl, co kde je** a jak to znovu nasadit.

---

## 📍 Kde jsou archivy

Všechny archivy jsou uloženy na NAS:

```
/Volumes/<backup-mount>/Prace/moje-tools/
```

Tato cesta je specifická pro **tvůj Mac** s připojeným NAS přes SMB. Na novém stroji musíš:

1. Připojit NAS (`mount -t smbfs` nebo Finder → Go → Connect to Server)
2. Nebo zkopírovat archivy ručně (rsync, scp, USB disk)

---

## 📂 Co tu je

```
mates-home-nas-tools/
├── README.md                    # Tento soubor
└── (žádné další soubory – archivy zůstávají na NAS)
```

**Proč tak málo souborů?** Toto repo je **pouze index**. Skutečné archivy (`.zip`, `.7z`, `.tar.gz`) zůstávají na NAS, **ne v gitu**. Git není vhodný pro velké binární soubory.

---

## 🚀 Jak použít

### 1. Připoj NAS

**macOS:**
```bash
# Finder → Go → Connect to Server (⌘K)
# Zadej: smb://<nas-ip>/Backups
# nebo v terminalu:
mount -t smbfs //<user>@<nas-ip>/Backups/Prace /Volumes/nas-tools
```

**Linux:**
```bash
sudo mount -t cifs //<nas-ip>/Backups/Prace/moje-tools /mnt/nas-tools \
    -o username=<user>,password=<password>
```

### 2. Podívej se, co je k dispozici

```bash
ls -la /Volumes/<backup-mount>/Prace/moje-tools/
```

Uvidíš seznam `.zip`, `.7z`, `.tar.gz` archivů.

### 3. Rozbal co potřebuješ

```bash
cd /Volumes/<backup-mount>/Prace/moje-tools/

# Standardní zip
unzip <nazev-projektu>.zip

# 7-zip (vyžaduje: brew install p7zip)
7z x <nazev-projektu>.7z

# tar.gz
tar -xzf <nazev-projektu>.tar.gz
```

### 4. Nasaď podle README uvnitř

Každý archiv obsahuje vlastní `README.md` nebo `INSTALL.md` s konkrétním postupem.

---

## 🔐 Bezpečnost

| Aspekt | Jak řešen |
|---|---|
| Citlivá data (hesla, forenzní dumpy) | **NEJSOU v gitu** – archivy na NAS |
| Hesla k archivům | **V keychainu** na tvém Macu |
| Přístup na NAS | **SMB s heslem** (ne anonymous) |
| Šifrování archivů | Některé `.7z` jsou šifrované heslem |
| Sdílení s kolegy | **Vytvoř zvláštní verzi README** (bez konkrétních cest/názvů) |

### ⚠️ Doporučení

- **Nepushuj archivy do Gitea** – git na to není stavěný
- **Nesdílej toto repo veřejně** – obsahuje popis citlivých projektů
- **Pravidelně zálohuj NAS** – off-site backup (Backblaze B2, jíný disk, …)

---

## 🛠 Doporučený workflow

```
Mac (~/Skripty/)    Pracovní kopie
       |
       | rsync (denne)
       |
NAS (moje-tools/)   Centralní záloha
       |
       | off-site backup
       |
Cloud (S3/Backblaze) Disaster recovery
```

---

## 🏗 Struktura NAS archivu

```
/Volumes/<backup-mount>/Prace/moje-tools/
├── forenzika/
│   ├── asistent-v1.zip
│   ├── pipeline.zip
│   └── ...
├── utility/
│   ├── bitcopy-backup.tar.gz
│   ├── whois.zip
│   └── ...
├── konverze/
│   ├── json2xml.zip
│   └── ...
├── ai-asistenti/
│   ├── docker-verze.7z
│   ├── portable.zip
│   └── ...
└── (atd.)
```

*(Tato struktura se může v průběhu času měnit – archivy jsou přidávány a odebírány podle potřeby.)*

---

## 📚 Související

- **Jotty:** knowledge base (detailní informace o projektech)
- **mates-ansible:** Ansible pro nový server
- **mates-install-scripts:** Docker zálohy na NAS (`dk-backup`)

---

## 📜 Licence

MIT – viz [LICENSE](LICENSE)

---

**Poslední update:** 2026-08-01