Studio — CropNode
CropNode is het vlaggenschip-product binnen het Studio ecosysteem. Het is een state-of-the-art webapplicatie ontworpen om agrarische bedrijven te ontlasten bij de administratie van gewasbescherming.
Door de kracht van Generatieve AI (Google Gemini) te combineren met een deterministische CTGB-validatie-engine, biedt de app een unieke ervaring: praat tegen je spuitschrift, en de app regelt de rest. Alles verpakt in een hoogwaardige, Emerald Dark Mode interface.
Belangrijkste Functionaliteiten
Multi-Modal Command Center
De kern van de applicatie. Eén intelligente command-bar met vier gespecialiseerde modi:
| Mode | Icoon | Functie |
|---|
| Registratie | Tractor | Spuitregistraties invoeren via natuurlijke taal |
| Product Check | Flask | Direct CTGB product informatie opzoeken |
| Urenregistratie | Timer | Start/stop timers voor teamtaken |
| Research Hub | Microscope | AI-gestuurde kennisbank voor gewasbescherming |
Registratie Mode (AI-First)
- Natuurlijke Taal: Type zoals je praat: "Vandaag alle peren gespoten met Merpan en Score"
- Streaming AI: Zie de AI live mee-denken terwijl de invoer wordt geanalyseerd
- Multi-turn Context: Correcties zoals "Oja, en ook nog 0.5L Zwavel" worden direct toegevoegd
- Groepselectie: "Alle peren", "De Conference" worden automatisch gematched
Product Check Mode
- Directe Zoekfunctie: Zoek op productnaam, toelatingsnummer of werkzame stof
- Gebruiksvoorschriften: Bekijk per gewas de toegestane dosering, toepassingen en veiligheidstermijnen
- W-codes & Etikettering: Inzicht in veiligheidsvoorschriften
Urenregistratie Mode
- Timer Functie: "Start snoeien" → start een timer voor de taak
- Stop & Registreer: "Stop" → stopt de timer en registreert de uren automatisch
- Team Integratie: Gekoppeld aan Team Tasks pagina
Research Hub Mode
- RAG-gestuurde AI: Stel vragen over ziektes, plagen en bestrijding
- Tool-gebruik: De AI doorzoekt automatisch relevante bronnen
CTGB Validatie-Engine
Veiligheid en wetgeving staan centraal. Elke registratie wordt automatisch getoetst aan de officiële CTGB-database.
- Toelatingscheck: Mag dit product op dit gewas?
- Doseringcontrole: Is de ingevoerde dosis binnen de wettelijke limieten?
- Interval & Cumulatie: Houdt rekening met eerdere bespuitingen en minimale intervallen
- Status Systeem:
Akkoord, Waarschuwing of Afgekeurd
Perceelbeheer
Een gedetailleerd overzicht van alle percelen.
- Boomstructuur: Beheer percelen met onderliggende sub-percelen (rassen/plantjaren)
- RVO/BRP Integratie: Officiële perceelgrenzen via PDOK API
- Kaartweergave: Interactieve Leaflet kaart met perceelgrenzen
- Historie: Volledige spuithistorie per (sub-)perceel
Voorraadbeheer
- Automatisch Verbruik: Voorraad wordt bijgewerkt na bevestigde registratie
- CTGB Database: Doorzoekbare database met actuele toelatingsinformatie
Technologie Stack
| Categorie | Technologie |
|---|
| Frontend | Next.js 15 (App Router + Turbopack) |
| Taal | TypeScript |
| AI | Genkit + Google Gemini 2.0 Flash |
| Database | Supabase (PostgreSQL) |
| Caching | TanStack Query v5 (60s staleTime) + Server-side caching |
| Styling | Tailwind CSS + shadcn/ui + Framer Motion |
| Kaarten | Leaflet + PDOK |
Netwerk Resilience
De applicatie is geoptimaliseerd voor gebruik op instabiele verbindingen (5G hotspot):
- Retry Mechanisme: Automatische retries met exponential backoff
- Keep-alive Connections: Persistente verbindingen naar Supabase
- Server-side Caching: CTGB producten gecached voor snellere responses
Projectstructuur
src/
├── ai/ # Genkit flows en AI logica
│ ├── flows/ # Agent flows (intent-router, agribot-agent)
│ ├── prompts/ # AI prompts
│ ├── schemas/ # Intent schemas
│ └── tools/ # AI tools
├── app/ # Next.js App Router
│ ├── (app)/ # Beveiligde routes
│ │ ├── command-center/ # Smart Input & Timeline
│ │ ├── parcels/ # Perceelbeheer
│ │ ├── crop-care/ # Spuitschrift & Voorraad
│ │ └── team-tasks/ # Urenregistratie
│ └── api/ # Backend endpoints
│ ├── analyze-input/ # Multi-modal AI endpoint
│ ├── validate/ # CTGB validatie
│ └── ctgb/ # Product search
├── components/ # React componenten
│ ├── ui/ # shadcn basis componenten
│ ├── domain/ # Domein-specifieke componenten
│ ├── command-bar.tsx # Multi-modal command bar
│ ├── mode-selector.tsx # Mode switching met Framer Motion
│ └── product-info-card.tsx # Product informatie display
├── hooks/ # React hooks
│ └── use-data.ts # TanStack Query hooks
└── lib/ # Core logica
├── supabase.ts # Client met retry logic
├── supabase-store.ts # Database functies
├── server-cache.ts # Server-side caching
├── ctgb-validator.ts # Validatie-engine
└── rag-service.ts # AI context service
Database Schema (Supabase)
De applicatie gebruikt Supabase (PostgreSQL) als database. Hieronder een overzicht van alle tabellen:
Kern Tabellen
| Tabel | Doel | Belangrijkste Kolommen |
|---|
| spuitschrift | Bevestigde spuitregistraties | id, date, plots[], products (JSONB), status, validation_message |
| logbook | Ruwe invoer/draft registraties | id, raw_input, parsed_data (JSONB), status, date |
| parcels | Hoofdpercelen | id, name, crop, area, geometry (JSONB), rvo_id |
| sub_parcels | Sub-percelen (rassen/plantjaren) | id, parcel_id, variety, plant_year, area |
| parcel_history | Spuithistorie per perceel | id, parcel_id, product, dosage, date, log_id |
| production_history | Productie/oogst historie | id, parcel_id, year, yield, quality |
Product & Voorraad
| Tabel | Doel | Belangrijkste Kolommen |
|---|
| ctgb_products | CTGB gewasbeschermingsmiddelen | toelatingsnummer (PK), naam, status, werkzame_stoffen[], gebruiksvoorschriften (JSONB), etikettering (JSONB) |
| ctgb_regulation_embeddings | Vector embeddings voor RAG search | id, product_naam, gewas, embedding (VECTOR) |
| fertilizers | Meststoffen database | id, name, manufacturer, category, composition (JSONB) |
| inventory_movements | Voorraadmutaties | id, product_name, quantity, type (inkoop/verbruik), date |
| product_aliases | Product synoniemen/afkortingen | alias, official_name, confidence, usage_count |
| product_usages | Product gebruiksdata | id, product_id, usage_count, last_used |
| active_substances | Werkzame stoffen referentie | code (PK), name, category, max_applications_per_year |
| product_substances | Koppeltabel product-stof | product_id, substance_code, concentration |
Team & Taken
| Tabel | Doel | Belangrijkste Kolommen |
|---|
| task_types | Soorten werk (snoeien, plukken, etc.) | id, name, default_hourly_rate |
| task_logs | Urenregistraties | id, start_date, end_date, sub_parcel_id, task_type_id, people_count, hours_per_person, total_hours |
| active_task_sessions | Actieve timer sessies | id, task_type_id, started_at, user_id |
Research & AI
| Tabel | Doel | Belangrijkste Kolommen |
|---|
| research_papers | Onderzoeksdocumenten | id, title, summary_ai, category, verdict, embedding (VECTOR) |
| pests_diseases | Ziektes en plagen database | id, name, type, crops[], symptoms, treatments |
| soil_samples | Bodemanalyses | id, parcel_id, date, ph, nutrients (JSONB) |
| conversations | Chat sessies/drafts | id, status, draft_data (JSONB), chat_history (JSONB) |
| user_preferences | Gebruikersvoorkeuren/aliassen | id, alias, preferred |
Views
| View | Doel |
|---|
| v_task_logs_enriched | Task logs met perceel- en taaktype info |
| v_active_task_sessions_enriched | Actieve sessies met taaktype info |
| v_sprayable_parcels | Percelen beschikbaar voor bespuiting |
| v_substances_summary | Werkzame stoffen met aantal producten |
| v_products_with_substances | Producten met gekoppelde stoffen |
| v_pests_diseases_summary | Ziektes/plagen overzicht |
JSONB Structuren
ctgb_products.gebruiksvoorschriften:
[{
"gewas": "Appel",
"doelorganisme": "Schurft",
"dosering": "2.25 kg/ha",
"maxToepassingen": 8,
"veiligheidstermijn": "21 dagen",
"interval": "min. 7 dagen",
"wCodes": ["W1", "W2"]
}]
spuitschrift.products:
[{
"product": "Merpan spuitkorrel",
"dosage": 2.25,
"unit": "kg/ha",
"targetReason": "Schurft"
}]
Aan de slag
1. Omgeving instellen
Maak een .env.local bestand:
NEXT_PUBLIC_SUPABASE_URL=...
NEXT_PUBLIC_SUPABASE_ANON_KEY=...
GOOGLE_GENAI_API_KEY=...
2. Database setup
# Voer de SQL scripts uit in Supabase SQL Editor
# sql/setup_all.sql bevat alle benodigde tabellen
# Sync CTGB producten
npx tsx scripts/sync-ctgb-supabase.ts
3. Installatie & Development
npm install
npm run dev
De applicatie is bereikbaar op http://localhost:3000.
Roadmap
Studio — Ontwikkeld met passie voor de agrarische sector door Jordi de Jager.
