# Routeplanner Pro - Gebruikershandleiding

Welkom bij de gebruikershandleiding voor Routeplanner Pro. Deze gids helpt u om alle functionaliteiten van de applicatie optimaal te benutten.

## Inhoudsopgave
1. [Introductie](#1-introductie)
2. [Inloggen](#2-inloggen)
3. [De Interface](#3-de-interface)
    - [Zijbalk Navigatie](#zijbalk-navigatie)
    - [Hoofdvenster](#hoofdvenster)
4. [Een Route Plannen in 3 Stappen](#4-een-route-plannen-in-3-stappen)
    - [Stap 1: Adressen Importeren](#stap-1-adressen-importeren)
    - [Stap 2: Instellingen & Controle](#stap-2-instellingen--controle)
    - [Stap 3: Resultaten Bekijken en Bewerken](#stap-3-resultaten-bekijken-en-bewerken)
5. [Planning Afronden en Opslaan](#5-planning-afronden-en-opslaan)
6. [Opgeslagen Planningen Beheren](#6-opgeslagen-planningen-beheren)
7. [Dashboard](#7-dashboard)
8. [Instellingen Beheren](#8-instellingen-beheren)
    - [Algemene Instellingen](#algemene-instellingen)
    - [Mijn Voertuigen](#mijn-voertuigen)
9. [Admin Dashboard (voor beheerders)](#9-admin-dashboard-voor-beheerders)

---

## 1. Introductie
Routeplanner Pro is een krachtige tool, ontworpen om uw logistieke processen te stroomlijnen. Importeer een lijst met adressen, geef aan welke voertuigen beschikbaar zijn, en de applicatie berekent de meest efficiënte routes voor u. Deze routes worden direct zichtbaar op een interactieve kaart.

## 2. Inloggen
Gebruik het e-mailadres en wachtwoord dat door uw beheerder is verstrekt om in te loggen op de applicatie. Na een succesvolle login wordt u automatisch doorgestuurd naar het hoofdscherm: de **Planner**.

## 3. De Interface
De applicatie bestaat uit een zijbalk voor navigatie en een hoofdvenster waar de actie plaatsvindt.

### Zijbalk Navigatie
Aan de linkerkant vindt u het hoofdmenu:
- **Dashboard:** Bekijk statistieken over uw gemaakte planningen.
- **Planner:** De hoofdpagina waar u routes importeert, optimaliseert en bewerkt.
- **Routes:** Een overzicht van al uw opgeslagen planningen.
- **Instellingen:** Beheer uw voertuigen en algemene planningsvoorkeuren.
- **Admin:** (Alleen zichtbaar voor beheerders) Beheer gebruikersaccounts.
- **Uitloggen:** Spreekt voor zich.

### Hoofdvenster
Het hoofdvenster is opgesplitst in twee delen:
- **Linkerpaneel:** Een controlepaneel voor het importeren en configureren van uw planning.
- **Rechterpaneel:** Een interactieve kaart waarop de adressen en routes worden gevisualiseerd.

U kunt het linkerpaneel in- en uitklappen met de pijl-knoppen bovenaan, om meer ruimte voor de kaart te maken.

## 4. Een Route Plannen in 3 Stappen

Het planningsproces is opgedeeld in drie eenvoudige stappen, die u doorloopt in het linkerpaneel.

### Stap 1: Adressen Importeren
Dit is het startpunt van elke planning.

1. **Bestand Kiezen:** Klik op "Kies bestand" en selecteer een CSV- of XML-bestand met de afleveradressen.
2. **Bestandsvereisten:**
    - **CSV:** Gebruik een puntkomma (;) als scheidingsteken.
    - **XML:** Zorg voor een duidelijke, herhalende structuur (bv. een lijst van `<Stop>`-elementen).
    - **Verplichte informatie:** Voor een succesvolle import heeft elk adres minimaal een **Klantnaam**, **Straat** en **Plaats** nodig.
3. **Importeer en ga verder:** Klik op de importknop.
4. **Kolommen Koppelen:** Er verschijnt een pop-up. Hierin koppelt u de kolomnamen uit uw bestand aan de velden die de applicatie nodig heeft (zoals 'Klant', 'Straatnaam', etc.). De applicatie doet een slimme eerste gok.
    - **Templates:** U kunt een eenmaal gemaakte koppeling opslaan als een **template**. Bij een volgende import kunt u deze template direct laden, wat tijd bespaart.
5. **Bevestigen:** Klik op "Koppeling bevestigen". De adressen worden geïmporteerd.

### Stap 2: Instellingen & Controle
Na het importeren worden uw adressen automatisch omgezet naar coördinaten (geocoding).

1. **Voertuigen Selecteren:** Kies uit de lijst met beschikbare voertuigen welke u voor deze planning wilt inzetten. U kunt meerdere voertuigen selecteren.
2. **Gebruikslimiet:** U ziet een statusbalk die aangeeft hoeveel routeberekeningen u deze maand heeft uitgevoerd.
3. **Optimaliseren:** Zodra de geocoding is voltooid en u voertuigen heeft geselecteerd, klikt u op **"Routes optimaliseren"**. De applicatie berekent nu de meest efficiënte routes.

### Stap 3: Resultaten Bekijken en Bewerken
Na de optimalisatie verschijnt het resultaat op de kaart en in het linkerpaneel.

**De Routelijst:**
- Het linkerpaneel toont nu een lijst, gegroepeerd per voertuig.
- Elke voertuigkaart toont de totale afstand en duur van de route.
- U kunt een voertuigkaart uitklappen om de specifieke stops in volgorde te zien.

**Interactieve Bewerkingen:**
Dit is waar de kracht van de applicatie echt naar voren komt. U kunt de berekende routes handmatig aanpassen:

- **Volgorde Wijzigen:** Pak een stop op met het handvat-icoon (links van de stop) en sleep deze naar een andere positie binnen dezelfde route.
- **Stop Verplaatsen:** Klik op het menu-icoon (drie puntjes) rechts van een stop. Kies "Verplaats naar" en selecteer een ander voertuig om de stop daarheen te verplaatsen.
- **Stop Bewerken:** In hetzelfde menu kunt u "Bewerken" kiezen om de adresgegevens of venstertijden van een stop aan te passen.
- **Stop Verwijderen:** Kies "Verwijderen" in het menu. Na een bevestiging wordt de stop uit de route gehaald en in de lijst "Niet-Toegewezen Punten" geplaatst.
- **Nieuwe Stop Toevoegen:** Klik op het `+` icoon op de voertuigkaart om een volledig nieuw adres aan die specifieke route toe te voegen.

**Herberekenen:**
**Belangrijk:** Na elke handmatige aanpassing (volgorde wijzigen, verplaatsen, toevoegen, bewerken, verwijderen) verandert de route. Er verschijnt een **"Herberekenen"** knop. Klik hierop om de reistijden en aankomsttijden voor de aangepaste route opnieuw te laten berekenen.

**Interactie met de Kaart:**
- **Zichtbaarheid:** Gebruik het oog-icoon op een voertuigkaart om de bijbehorende route op de kaart te tonen of te verbergen.
- **Informatie:** Beweeg uw muis over een stop op de kaart om details zoals naam en aankomsttijd te zien.

**Delen en Downloaden:**
Gebruik het deel-icoon op een voertuigkaart om de route te:
- Openen in Google Maps voor directe navigatie.
- Delen via WhatsApp of E-mail.
- Downloaden als een CSV-bestand.

## 5. Planning Afronden en Opslaan
Tevreden met het resultaat? Klik onderaan op **"Huidige planning afronden"**.
- Geef de planning een duidelijke naam en datum.
- Voeg eventueel een notitie toe.
- **Opslaan:** Bewaart de planning in uw archief.
- **Versturen & Opslaan:** Slaat de planning op én verstuurt (na bevestiging) een e-mailnotificatie met de verwachte aankomsttijd naar alle klanten waar een e-mailadres van bekend is.

## 6. Opgeslagen Planningen Beheren
Op de **Routes** pagina vindt u een overzicht van al uw opgeslagen planningen, onderverdeeld in "Geplande Routes" en "Archief".
- **Filteren:** Gebruik de kalender om planningen voor een specifieke datum te bekijken.
- **Acties:** Via het menu (drie puntjes) kunt u een opgeslagen planning:
    - **Bekijken:** Zie de details in een pop-up.
    - **Wijzigen:** Pas de naam of notitie aan.
    - **Verwijderen:** Verwijder de planning permanent.
    - **Openen:** Laad de volledige planning opnieuw in de **Planner** om deze verder te bewerken of opnieuw te gebruiken als basis.

## 7. Dashboard
De **Dashboard** pagina geeft u visueel inzicht in uw planningen. Bekijk grafieken over:
- Totaal aantal gereden routes en stops.
- Totale afstand.
- Afstand per voertuig.
- Aantal stops per planning over tijd.

## 8. Instellingen Beheren
Op de **Instellingen** pagina kunt u de basisconfiguratie van de applicatie aanpassen.

### Algemene Instellingen
- **Bedrijfsnaam:** De naam die wordt gebruikt in e-mailnotificaties naar klanten.
- **Standaard Servicetijd:** De tijd in minuten die standaard wordt gerekend voor een stop (laden/lossen).

### Mijn Voertuigen
- Beheer hier uw wagenpark.
- Voeg nieuwe voertuigen toe, inclusief kenteken, type, en specifieke start- en eindadressen en werktijden.
- Geef per voertuig aan of het standaard geselecteerd moet zijn bij een nieuwe planning.

## 9. Admin Dashboard (voor beheerders)
Als u admin-rechten heeft, ziet u een extra **Admin** pagina.
- **Gebruikers Aanmaken:** Maak nieuwe gebruikersaccounts aan met een e-mail, wachtwoord, abonnementstype en eventuele admin-rechten.
- **Gebruikers Beheren:** Bekijk een lijst van alle gebruikers. U kunt hier per gebruiker:
    - Het abonnementstype en de admin-status aanpassen.
    - Een limiet instellen op het aantal maandelijkse routeberekeningen.
    - De maandelijkse teller van een gebruiker resetten naar nul.

---

Heeft u verdere vragen? Neem contact op met uw systeembeheerder.

Care4Fresh inrichting