Project 9 - Voorraad- en Distributiebeheer

Projectbriefing

Projectnaam: Voorraad- en Distributiebeheer "Vuller"

Datum: 8 januari 2026

Opdrachtgever: Stichting "De Reikende Hand"

Contactpersoon: Mevr. S. Broodstra (Logistiek Manager)

Student: [Naam Student]

1. Achtergrond en Probleemstelling

Onze stichting zamelt voedselpakketten in voor gezinnen in de regio. Momenteel werken we met Excel-lijsten om bij te houden welke vrijwilliger welk pakket op welk adres moet afleveren. Dit zorgt voor fouten: soms staan twee vrijwilligers bij hetzelfde adres, of worden pakketten vergeten.

Daarnaast hebben de bezorgers onderweg geen inzicht in hun route of specifieke afleverinstructies (bijv. "pakket achter het tuinhek"). We hebben behoefte aan een centraal systeem dat de logistiek stroomlijnt.

2. Doelstelling

Wij willen een web-based portaal (Vuller) laten ontwikkelen voor het beheren van bezorgroutes.

Vrijwilligers moeten op hun telefoon hun eigen route kunnen zien en pakketten als "afgeleverd" kunnen markeren. De logistiek manager moet routes kunnen aanmaken, vrijwilligers koppelen en de status van alle leveringen live kunnen volgen.

3. Doelgroepen

1. Bezorgers (Vrijwilligers): Willen hun toegewezen adressen zien en de status van een levering bijwerken.

2. Logistiek Managers (Admins): Willen een totaaloverzicht van de voorraad en de voortgang van de bezorgingen per wijk.

4. Gewenste Functionaliteiten (Must-Haves)

Voor het MVP verwachten wij de volgende functies:

• Authenticatie:

  • Inloggen voor vrijwilligers en managers.
  • Rollen: vrijwilliger en manager.

• Voor Vrijwilligers:

  • Dashboard met de lijst van af te leveren pakketten voor vandaag.
  • Detailpagina per adres met afleverinstructies en een knop "Markeer als Bezorgd".
  • Overzicht van eigen voltooide leveringen.

• Voor Managers (Admins):

  • Beheerpagina om nieuwe leveringen (adressen + inhoud pakket) toe te voegen.
  • Mogelijkheid om een levering toe te wijzen aan een specifieke vrijwilliger.
  • Live dashboard met statistieken: Hoeveel % van de pakketten is al bezorgd?

5. Technische Eisen & Randvoorwaarden

• Taal & Database: PHP (8.x) en MySQL.
• Code Architectuur: Gebruik van een duidelijke mappenstructuur en header/footer includes.
• Veiligheid: Beveiliging tegen SQL-injectie en het valideren of een vrijwilliger alleen zijn eigen routes kan inzien.
• Data Integriteit: Een levering (delivery) is gekoppeld aan één vrijwilliger (user), maar een vrijwilliger kan meerdere leveringen hebben (1-op-N relatie).

6. Budget en Planning

• Tijdsinvestering: Ontwikkelingstijd van circa 40-45 uur.
• Oplevering: Een werkend prototype (MVP) inclusief testdata.

BIJLAGE: Specifieke Design & Interface Wensen

De stichting wil een betrouwbare en rustige uitstraling: wit, lichtgrijs en 'hulpvaardig' oranje.

1. Status Badges:

   • In Magazijn: Grijze badge.
   • Onderweg: Oranje badge.
   • Afgeleverd: Groene badge.

2. De "Route-Tracker" Navigatie:

   • Top-navigatie met in het midden de tekst "Vuller - Logistiek Systeem".
   • Rechtsboven een duidelijke melding als er nog onbezorgde pakketten op de lijst staan.

3. Bezorging Detail View (2-Koloms):

   • Links (70%): Adresgegevens (groot) en de inhoud van het pakket (bijv. "Pakket A: Gezin 4 pers.").
   • Rechts (30%): "Klant-notities" box met informatie over de bewoner of de locatie van de voordeur.

4. Manager Filter:

   • Filteren op wijk (bijv. ?wijk=Centrum) en op vrijwilliger om snel te zien wie nog op pad is.