Ga naar hoofdinhoud

FieldOps — functies en schermen (web)

Dit is het functionele overzicht van wat de webapplicatie op https://fieldops.be/ biedt. Toegang per route hangt af van rol en rechten (server en profiel). Zie de per-rol handleidingen voor detailworkflows.

Weergave op telefoon, tablet en desktop

De webapp past de layout aan je schermbreedte aan: op een telefoon blijft de inhoud compact met onder-navigatie; op tablet en desktop gebruikt de inhoud de volledige breedte naast de navigatie (dashboard, klachten, taken, veldformulieren, profiel, …). Formulieren en lijsten gebruiken waar nodig responsive grids (sm/lg kolommen) en horizontaal scrollbare tabellen op smalle schermen. Smalle inhoud (bv. een foutmelding bij opmeting) kan bewust smaller blijven. De magazijnmodule (/magazijn/*) volgt hetzelfde principe; de webshop houdt op mobiel een compacte kolom (zie Magazijn — handleiding).

Authenticatie en onboarding

RouteFunctie
/loginInloggen (gebruikersnaam of e-mail + wachtwoord, JWT in de app). Link Wachtwoord vergeten? op het inlogscherm.
/wachtwoord-vergetenE-mail invullen; bij bekend adres wordt een resetlink gestuurd (geen vermelding of het adres bestaat).
/wachtwoord-resettenNieuw wachtwoord instellen via link uit de resetmail (?token=…, 24 uur geldig).
/registerPubliek registratieformulier alleen als de server FIELDOPS_ALLOW_REGISTRATION toestaat.
/email-bevestigdBevestiging na e-mailverificatie (registratie).

Start en dashboard

RouteFunctie
/Werfleider (en vergelijkbare rollen): dashboard met overzichten. Subco/ploeg: start op taken (redirect).

Taken, goedkeuringen, meetstaten

RouteFunctie
/takenSubco/ploeg: lijst met toegewezen taken; werfleider: zelfde module voor goedkeuringsflow (rechten).
/taken/:taskIdTaakdetail (inventarisatie, antwoorden, goedkeuring, koppeling met rondgang/rapport).
/goedkeuringenWachtrij goedkeuringen (werfleider-achtige rollen).
/meetstaten/opmetingSubco-opmeting / meetstaten (rechten: canAccessMeetstatenOpmeting).
/meetstaten/opmeting/individueel/:surveyIdOpmeting per survey.

Werfleider — rondgang, opmeting, meetstaat, sokkel + LS-kast, GIS

RouteFunctie
/werfleiderNieuwe of actieve rondgang (hoofdformulier). Een opgeslagen concept opent op dezelfde route met query ?concept=:reportId.
/werfleider/concept/:reportIdZelfde concept-editor als hierboven (alternatieve URL; o.a. oude bookmarks).
/werfleider/ls-kast, /werfleider/ls-kast/concept/:id, /werfleider/ls-kast/bewerken/:idGeen formulier meer — doorverwijzing naar /rapport/:id (archief) of naar /werfleider/ls-kast-plaatsing (basis-URL bij rechten op plaatsing).
/werfleider/ls-kast-plaatsing, .../concept/:reportId, .../bewerken/:reportIdSokkel + LS-kast plaatsing (werfleider).
/werfleider/opmetingSleufmeting / opmeting-hub.
/werfleider/opmeting/*Diverse opmeting- en legacy-routes (rapport- en survey-paden; zie App.tsx voor exacte URL’s).
/werfleider/opmeting/grondtypesRedirect naar Beheer-tab of opmeting (rechten).
/werfleider/meetstaatMeetstaat-hub (feature flag + werfleider).
/werfleider/gis-uploadShapefile / GIS naar PostGIS; elke upload eigen schema (niets overschrijven tot handmatig wissen); ZIP mag Comsof ReportSummary / Warnings / QGS / CSV bevatten (design-metadata); keuze Metingen of Aanleg plannen; importgeschiedenis met filters en kaartweergave. Platform-admin altijd; werfleider alleen met Beheer → Actie: GIS-upload aan (standaard uit). Werfleider: upload/verwijderen beperkt tot eigen POP in user_project_zones.
GIS-kaart/werfleider/gis-kaart

Zie Werfleider handleiding en Platform.

Beheer

RouteFunctie
/beheerBeheer-console: gebruikers, instellingen, koppelingen, subco’s, notificaties, M365, opmeting-config, Downloads (tablet-APK), enz. (rechten: o.a. platform, support, werfleider met beheer).
/beheer?tab=downloadsTab Downloads — FieldOps Android APK voor tablets (versie uit /api/config).

Veldrollen (lasser, blaser, graafploeg)

RouteFunctie
/lasser, /lasser/concept/:reportId, /lasser/bewerken/:reportIdLasser-rapport (nieuw, concept, bewerken).
/blaser, .../concept/, .../bewerken/Blaser-rapport.
/graafploeg, .../concept/, .../bewerken/Graafploeg-rapport (rondgang: nieuwe punten bovenaan via Nieuw punt toevoegen; meerwerk: afmetingen B/D/L in centimeter).
/graafploeg/ls-kast-plaatsing (+ concept/bewerken)LS-kast plaatsing vanuit graafploeg (rechten).

Zie Veld — overzicht.

Rapporten, rondgang, trench (legacy)

RouteFunctie
/rapport/:idRapportdetail (werfleider/coördinatie); subco wordt naar taken geleid.
/rapport/:id/rondgangRondgang voortgang (werfleider of projectcoördinator).
/rapport/:id/trench, /rapport/:id/trench/:surveyIdLegacy koppeling naar sleuf/trench (redirect naar huidige opmeting-flow).

Klachten

RouteFunctie
/klachtenKlachtenlijst (can_access_complaints e.d.).
/klachten/nieuwNieuwe klacht (aanmaakrechten + zones/projecten).
/klachten/:idKlachtdetail (rechten per rol).

Profiel, notities, documenten

RouteFunctie
/profielProfiel: naam, wachtwoord, notificatievoorkeuren (volgens rol).
/notitieSnelle notitie / memo-scherm.
/documenten, /documenten/logRedirects naar magazijn-documenten (/magazijn/documenten, log).

Magazijn (/magazijn/*)

RouteFunctie
/magazijnEntry: redirect naar hub, scan, bestellen of beheer-dashboard (sessie en rol).
/magazijn/hubHub (o.a. subco: bestellen + overzicht).
/magazijn/bestellenBestellen (webshop, indien van toepassing).
/magazijn/mijn-subcoMutatielog voor eigen subco.
/magazijn/scan, /magazijn/scan/:tokenScanner (QR), voorraadmutaties.
/magazijn/voorraad/:warehouseIdVoorraad per magazijn.
/magazijn/telling/:warehouseId, .../sessie/:sessionIdTelling (wizard).
/magazijn/beheer, /magazijn/beheer/:warehouseIdMagazijn-beheer (interne rollen met dashboard-rechten).
/magazijn/documentenDocumenten (upload/support-flow, rechten).
/magazijn/documenten/log, /magazijn/documenten/log/:submissionIdLog van documentaanvragen.

Zie Handleiding magazijn en Subco handleiding § magazijn.

REST API (los van deze UI)

De HTTP API onder /api/* is niet anoniem voor de meeste operaties: login levert een JWT; andere endpoints vereisen Bearer-authenticatie en vaak specifieke rollen. Technische contracten staan bij Ontwikkelaars — gevoelige uitwerkingen (Swagger, TypeDoc, interne notities) zijn op productie extra afgeschermd (zie daar).


Onderhoud: nieuwe Route in fieldops/src/App.tsx → voeg hier een rij toe en werk DOC-inventaris bij.