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

---

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