Převod kontaktů ze skautISu do Google Contacts

Webová aplikace (doporučeno)

Spuštění přes Docker (doporučeno)

Požadavky

docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
git

Spuštění

docker compose up -d

Aplikace bude dostupná na portu 5000.

Zastavení

docker compose down

Aktualizace

docker compose down
git pull
docker compose up -d --build

Spuštění bez Dockeru

Požadavky

• python3.12

Nainstaluj pomocí správce balíčků nebo stáhni z https://www.python.org/downloads/

Instalace

1. Vytvoř virtuální prostředí:

python -m venv .venv

2. Aktivuj ho:

. .venv/bin/activate

3. Nainstaluj závislosti:

pip install -r requirements.txt

Spuštění

python app.py

Aplikace bude dostupná na http://localhost:5000

---

CLI režim

Skript lze stále používat z příkazové řádky:

./convert.py <cesta_ke_staženému_xlsx_exportu>.xlsx <kam_uložit_výstup>.csv

---

Příprava exportu ze skautISu

Caution

Doporučuji nejdříve udělat zálohu a staré kontakty smazat až po úspěšném importu nových, aby se předešlo jakékoli ztrátě dat!

1. Přihlas se do skautISu.
2. Vyber správnou roli. Pro export musí být Oddíl: vedoucí/admin
3. Přejdi na Exporty > Osoby
4. V sekci Správa a nastavení exportů vytvoř novou šablonu a nastav ji podle přiloženého screenshotu.
5. Vrať se na Exporty / seznamy, vyber nově vytvořenou šablonu.
6. Odstraň výchozí jednotku k exportu, přidej novou pomocí formuláře Přidat jednotku a přitom zaškrtni Včetně podřízených.

Note

Odstranění a opětovné přidání je nutné k tomu, aby bylo možné zahrnout podřízené jednotky.

7. Klikni na Export do XLSX. Export se stáhne.
8. Nahraj stažený soubor do webové aplikace nebo použij CLI.

Import do Google Contacts

Important

Doporučuji vizuální kontrolu vytvořeného CSV, zda se zdá být v pořádku. Mělo by odpovídat ukázkové šabloně.

1. Importuj stažený .csv soubor do Google Contacts.
2. Nezapomeň poté smazat staré kontakty, abys předešel duplicitám.

Note

Tento proces se obvykle provádí jednou ročně, aby byly kontaktní údaje aktuální.