📦 AdventurePack Handleiding

Wat je gaat doen

1. Download een .adventurepack bestand (of begin met een leeg sjabloon).
2. Open het op je computer — het is gewoon een ZIP-bestand.
3. Vul de reisgegevens in met Excel, Numbers, of een AI-assistent.
4. Pak alles weer in als .adventurepack.
5. Importeer het in de AdventureManager app.

Stap 1 — Download de AdventurePack

1. Klik op de downloadlink die je kreeg (mail, chat, Google Drive, enz.).
2. Sla het bestand op in Downloads.
3. Controleer of de bestandsnaam eindigt op .adventurepack
   Voorbeeld: reis_islay_2026-09-24.adventurepack
4. Maak eerst een reservekopie voordat je gaat bewerken.
   Voorbeeld: reis_islay_2026-09-24_backup.adventurepack

Stap 2 — Open de AdventurePack op je computer

1. Dubbelklik op het .adventurepack bestand. Op Mac wordt dit automatisch uitgepakt naar een map.
2. Open de nieuwe map. Je ziet bestanden zoals:

Bestand	Inhoud
reis.csv	Basis van de reis: naam, bestemming, datums
reisplan.csv	Dagplanning — het hoofdbestand
vervoer.csv	Vervoersdetails: vluchten, treinen, boten
groepsleden.csv	Wie er mee reist en hun rol
contacten.csv	Hotels, restaurants, locaties met telefoon/website
uitgaven.csv	Kosten per item
reisinformatie.csv	Reisnotities, tips, visa-info
manifest.json	⚠️ Dit bestand niet aanpassen

Stap 3 — Aanbevolen: werken met een gekoppelde Excel-werkmap

De makkelijkste manier om een AdventurePack op de computer te bewerken is met een gekoppelde Excel-werkmap (.xlsx). Deze werkmap heeft één tabblad per CSV. Formulecellen (lichtblauw) kopiëren automatisch gegevens van reisplan naar vervoer en uitgaven zodra je reisplan aanpast.

• reisplan is het hoofdbestand: begin hier met invullen.
• vervoer en uitgaven hebben formulecellen die bijpassende gegevens uit reisplan ophalen via de RefID. Vul alleen de velden in die uniek zijn voor vervoer (vervoermiddel, vluchtnummer, vertrek/aankomst, enz.).
• contacten en reisinformatie vul je handmatig in.
• Dropdownvalidatie op Categorie en Vervoermiddel voorkomt typefouten.

Stap 4 — Handmatig invullen (direct in CSV)

1. Open een CSV in Excel of Numbers.
2. Laat rij 1 (de kolomnamen) precies zoals die is.
3. Voeg nieuwe regels toe onder de kolomnamen.
4. Sla op met dezelfde bestandsnaam en als .csv.
5. Herhaal dit voor elke CSV die je wilt aanpassen.

Verplichte opmaak

Type	Formaat	Voorbeeld
Datum	YYYY-MM-DD	2026-09-24
Tijd	HH:MM (24u)	07:55
Datum+Tijd	YYYY-MM-DD HH:MM	2026-09-24 07:55
Kosten	alleen getal	85 of 85.00
GPS-coördinaat	decimalen	52.3731 / 4.8922

Geldige categorieën voor reisplan.csv

Categorie	Gebruik voor
hotel	Overnachtingen
transport	Vluchten, treinen, boten, autoreizen, bussen
activity	Uitstapjes, rondleidingen, diners, wandelingen, ervaringen

Geldige vervoermiddelen voor vervoer.csv

Waarde	Gebruik voor
airplane	Vliegtuig
car	Auto (ook autohuur)
train	Trein
boat	Boot, veerpont, ferry
bus	Bus
bike	Fiets
moped	Scooter

Stap 5 — RefIDs: koppeling tussen reisplan, vervoer en uitgaven

RefIDs koppelen rijen aan elkaar in verschillende CSV-bestanden. Een vervoersitem in reisplan.csv en de bijbehorende rij in vervoer.csv moeten dezelfde RefID hebben.

Je kunt gebruiken:

• Leesbare IDs: vlucht1   hotel_amsterdam   ferry_heen
• UUID's: 3C064C66-5330-4F43-A66D-16C87E963762
• Elke unieke tekst: dag1_activiteit   KL935

Stap 6 — Opnieuw inpakken naar .adventurepack

Mac (aanbevolen — altijd correct):

cd /pad/naar/reis_islay_uitgepakt/
zip -r ../reis_islay_2026-09-24.adventurepack .

Het .adventurepack bestand verschijnt één niveau hoger.

Windows / handmatig:

1. Open de uitgepakte map.
2. Selecteer alle bestanden in die map (ook de map photos, ook als die leeg is).
3. Rechtsklik en kies Comprimeer — dit maakt een .zip bestand.
4. Hernoem die .zip naar .adventurepack.

Stap 7 — Uploaden in de AdventureManager app

1. Zet het .adventurepack bestand in Bestanden / iCloud Drive.
2. Open AdventureManager.
3. Tik op Importeer (of op + en daarna importeren).
4. Kies je .adventurepack.
5. Wacht tot het importeren klaar is.
6. Open de reis en controleer snel: reisplan, vervoer, contacten en groepsleden.

Stap 8 — Gebruik een AI-assistent (Claude, ChatGPT, enz.)

Als je je reis al gepland hebt in een document, spreadsheet, e-mailwisseling of boekingsbevestigingen, kun je een AI-assistent vragen dit om te zetten naar het juiste CSV-formaat.

Kopieer de onderstaande prompt, vul je reisgegevens in, en stuur het naar Claude, ChatGPT, Gemini of een andere AI-assistent.

Je helpt mij een AdventurePack maken voor de AdventureManager reisapp.
Een AdventurePack is een ZIP-bestand hernoemd naar .adventurepack, met daarin CSV-bestanden
gescheiden door puntkomma's (;), gecodeerd als UTF-8 zonder BOM.

Maak de volgende CSV-bestanden op basis van mijn reisgegevens hieronder.

BESTAND 1: reis.csv
Kolomnamen: Naam;Bestemming;Startdatum;Einddatum
- Eén rij. Startdatum/Einddatum: YYYY-MM-DD.

BESTAND 2: groepsleden.csv
Kolomnamen: Naam;Rol;Kleur
- Rol: "planner" (organisator, volledige toegang) of "reiziger" (meereiziger, alleen lezen).
- Kleur: hex kleurcode zoals #FF6B6B. Geef elke persoon een andere kleur.
- Altijd minimaal één planner opnemen.

BESTAND 3: reisplan.csv
Kolomnamen: RefID;Datum;Locatie;Titel;Omschrijving;Categorie;Verborgen;Starttijd;Eindtijd;Straat;Postcode;Stad;Provincie;Land;Lokaal adres;Telefoon;E-mail;Website;Kosten (EUR);Kosten notitie;Betaald door;Breedtegraad;Lengtegraad
- RefID: gebruik een korte leesbare ID per rij (bijv. vlucht1, hotel_amsterdam, ferry_heen).
  Moet uniek zijn. Moet overeenkomen met vervoer.csv voor vervoersitems.
- Datum: YYYY-MM-DD.
- Categorie: hotel / transport / activity  (alleen deze drie waarden zijn geldig)
  Gebruik "transport" voor vluchten, treinen, boten, autoreizen, bussen.
  Gebruik "hotel" voor overnachtingen.
  Gebruik "activity" voor uitstapjes, rondleidingen, diners, wandelingen, ervaringen.
- Verborgen: false (gebruik true alleen om een verrassing te verbergen voor reizigers).
- Starttijd/Eindtijd: HH:MM (24u) of leeg laten.
- Kosten (EUR): alleen getal (bijv. 85.00) of leeg laten.
- Breedtegraad/Lengtegraad: decimale GPS-coördinaten of leeg laten.

BESTAND 4: vervoer.csv (één rij per vervoersitem — RefID moet overeenkomen met reisplan.csv)
Kolomnamen: RefID;Datum;Titel;Omschrijving;Locatie;Vervoermiddel;Luchtvaartmaatschappij;Vluchtnummer;Boekingsnummer;Online inchecknummer;Vertrekstation;Vertrekterminal;Incheckdatum;Vertrekdatum;Aankomststation;Aankomstterminal;Aankomstdatum;Ticketnummer;E-ticketnummer;Ruimbagage;Handbagage;Telefoon;E-mail;Website;Adres;Kosten (EUR);Kosten notitie;Betaald door;Vertrek breedtegraad;Vertrek lengtegraad;Aankomst breedtegraad;Aankomst lengtegraad;Breedtegraad;Lengtegraad
- RefID: MOET dezelfde waarde zijn als de bijbehorende rij in reisplan.csv.
- Vervoermiddel: airplane / car / train / boat / bus / bike / moped  (alleen deze waarden)
  Gebruik "boat" voor veerponten. Gebruik "car" voor autohuur.
- Vertrekdatum/Aankomstdatum: YYYY-MM-DD HH:MM.
- Onbekende velden leeg laten.

BESTAND 5: contacten.csv
Kolomnamen: Naam;Locatie;Type;Platform;Website;E-mail;Telefoon;Adres;Lokaal adres;Data;Volgorde
- Eén rij per hotel, restaurant of locatie. Onbekende velden leeg laten.

BESTAND 6: uitgaven.csv
Kolomnamen: RefID;ReisplanRef;Bedrag;Valuta;Bedrag EUR;Categorie;Datum;Betaald door;Notitie
- RefID: unieke ID per rij (bijv. uit1, uit2).
- ReisplanRef: RefID van de bijbehorende reisplan.csv rij (of leeg laten).
- Bedrag EUR: kosten in euro's als getal. Datum: YYYY-MM-DD.

Regels:
- Puntkomma als kolomscheider, UTF-8, geen BOM.
- RefIDs in reisplan.csv en vervoer.csv moeten overeenkomen voor hetzelfde vervoersitem.
- Laat optionele velden leeg in plaats van te raden.
- Geef elk bestand een header zoals: === reisplan.csv ===

Mijn reisgegevens:
[PLAK HIER JE REISGEGEVENS]

Als er iets misgaat

Probleem	Oplossing
Import mislukt direct	Controleer of de extensie echt .adventurepack is. Pak opnieuw in via Terminal en zorg dat er geen extra bovenliggende map in de zip zit.
Rare tekens in tekst	Sla CSV op als UTF-8 (niet UTF-8 met BOM, niet Windows-1252).
Kolommen verschoven	Controleer of het puntkomma-scheidingsteken goed bleef en kolomnamen niet zijn aangepast.
Datums/tijden kloppen niet	Gebruik YYYY-MM-DD voor datums en HH:MM (24u) voor tijden.
Vervoer zonder routelijn op kaart	Controleer dat de RefID in vervoer.csv exact overeenkomt met die in reisplan.csv, en dat Vervoermiddel een geldige waarde heeft.
Kaartpinnen ontbreken	Controleer of Breedtegraad/Lengtegraad geldige decimale coördinaten zijn (lat −90..90, lon −180..180). Een waarde zoals 523.105 wordt stilzwijgend genegeerd.
Databeheer rapport na import	De app toont automatisch een kwaliteitsrapport. Gebruik dit om fouten op te sporen voordat je het pack deelt met je reisgroep.