QC One – Database Model Overzicht

Dit document geeft een overzicht van het datamodel dat beschikbaar is voor klanten via de QC One BigQuery-koppeling.
Het legt uit hoe de belangrijkste entiteiten zich tot elkaar verhouden en welk type informatie uit elke tabel kan worden gehaald.
De structuur ondersteunt typische kwaliteitscontrole-workflows: inspecties, productparameters, opmerkingen, impressies en unit-niveau data.

1. Introductie

QC One slaat gestructureerde inspectiedata op die de volledige levenscyclus van een kwaliteitscontrole vertegenwoordigt:

producten → variëteiten → units → parameters → impressies → bevindingen

Deze gids helpt je te begrijpen:

Welke data beschikbaar is
Hoe tabellen zich tot elkaar verhouden
Hoe je typische QC-workflows kunt bevragen
Waar je belangrijke informatie vindt zoals productkenmerken, inspectiestatus of parameterwaarden

2. High-Level Architectuur

Op hoog niveau bestaat de database uit de volgende domeinen:

Product- & Variëteitenstructuur

filtered_products
filtered_varieties

Deze definiëren de productcatalogus en variëteiten waarop inspecties worden uitgevoerd.

Inspectieworkflow

filtered_inspections
filtered_inspection_types
filtered_inspection_points

Deze tabellen vormen het kern-inspectierecord: wie heeft geïnspecteerd, wanneer, waar en wat het resultaat was.

Units & Parametercontroles

filtered_units
filtered_parameters
filtered_parameter_items
filtered_parameter_values

Deze vertegenwoordigen de individuele geïnspecteerde units en hun gemeten parameterwaarden (numeriek, tekst of boolean).

Impressies (Kwalitatieve Controles)

filtered_impressions
filtered_impression_items
filtered_impression_values

Deze leggen kwalitatieve indrukken van inspecteurs vast, zoals uiterlijk, hardheid, geur of kleur.

Opmerkingen & Aanvullende Notities

filtered_remarks
filtered_remark_values

Numerieke waarden of percentages gekoppeld aan kwaliteitsopmerkingen.

Organisatie- & Gebruikersmetadata

filtered_organisations
filtered_inspectors
filtered_licenses

Metadata voor klanten, leveranciers, inspecteurs en licenties.

3. Tabel-voor-Tabel Uitleg

Hieronder volgt een beknopte toelichting op de belangrijkste tabellen.

3.1 Producten & Variëteiten

filtered_products

Bevat de lijst met productcategorieën (bijv. Appels, Paprika’s, Druiven).

Kolom	Beschrijving
`id`	Unieke product-ID
`name`	Productnaam

filtered_varieties

Definieert variëteiten die bij elk product horen (bijv. Gala Appels, Red Globe Druiven).

Kolom	Beschrijving
`id`	Variëteit-ID
`product_id`	Verwijst naar `filtered_products.id`
`name`	Variëteitnaam

3.2 Inspecties

filtered_inspections

De centrale tabel die elke inspectie vertegenwoordigt.
Bevat o.a.:

Inspecteur (inspector_id)
Status (wachten op planning, wachten op aankomst, QC, vrijgave, publicatie, etc.)
Geplande tijd, start- en eindtijdstempels
Verzendinformatie (verlader, ontvanger, container, schip, AWB, etc.)
Toegewezen gebruikers
Inspectietype (type_id)
Inspectiepunt (point_id)

Dit is de hoofdtafel voor inspectieniveau-rapportages.

filtered_inspection_types

Woordenlijst van inspectietypes (aankomstcontrole, intake QC, exportinspectie, etc.).

filtered_inspection_points

Locaties of controlepunten waar inspecties plaatsvinden.

3.3 Units (Monsteritems)

filtered_units

Vertegenwoordigt sample units die binnen een inspectie zijn gecontroleerd.
Één inspectie kan meerdere units bevatten (verschillende pallets, partijen, dozen, etc.).

Bevat velden zoals:

Maat
Teler
Merk
Kleur
Boomgaard
Biologisch vlaggetje
Nettogewicht, colli, GGN, traceerdata
Verwijzingen naar parameterspecificaties
Veel aanvullende unitkenmerken

Dit is de meest gedetailleerde tabel in het model.

3.4 Parameters & Waarden

filtered_parameters

Definieert de parametercatalogus (bijv. Brix, Maat, Defecten %, Hardheid).

filtered_parameter_items

Optionele subitems (bijv. Schildefecten → Krusten, Kneuzingen).

filtered_parameter_values

Slaat de gemeten waarde per unit op.

Ondersteunt vier typen waarden:

Kolom	Betekenis
`numeric_value`	Numerieke metingen (bijv. Brix 14,2)
`string_value`	Tekstwaarden (bijv. “AA”, “Large”)
`meets_specification`	Boolean QC-resultaat
`date_value`	Datumwaarden indien van toepassing

Koppelingen:

unit_id → Geïnspecteerde unit
parameter_id → Parameterdefinitie
parameter_item_id → Optioneel subitem

3.5 Impressies (Subjectief / Kwalitatief)

filtered_impressions

Catalogus van impressietypes (bijv. Uiterlijk, Geur, Hardheid).

filtered_impression_items

Mogelijke waarden/scores voor elke impressie (bijv. Goed, Matig, Slecht).

filtered_impression_values

Slaat de gekozen impressiescore per inspectie en per item op.

Nuttig voor dashboards en visuele QC-rapportages.

3.6 Opmerkingen

filtered_remarks

Catalogus van mogelijke opmerkingen.

filtered_remark_values

Slaat op:

De opmerking
De numerieke waarde
Het percentage (bij defect-gerelateerde opmerkingen)

Gekoppeld via:

unit_id
remark_id

3.7 Organisaties, Inspecteurs & Licenties

filtered_organisations

Vertegenwoordigt klantaccounts en sub-organisaties.

filtered_inspectors

Gebruikers die inspecties uitvoeren.

filtered_licenses

Licentiemetadata toegewezen aan organisaties.

4. Hoe de Tabellen Zich Tot Elkaar Verhouden

Kernrelaties:

Product → Variëteit → Unit → Parameterwaarden → Opmerkingen
Inspectie → Units
Inspectie → Impressies
Inspectie → Inspecteur / Organisatie / Verzendinformatie

Visuele structuur:

Inspectie  ├── Units  │     ├── Parameterwaarden  │     └── Opmerkingen  └── Impressiewaarden

Dit model ondersteunt:

Meerdere units per inspectie
Meerdere parameters per unit
Kwantitatieve en kwalitatieve QC-resultaten

5. Veelvoorkomende Use Cases & Queries

Alle inspecties voor een klant opvragen
Join filtered_inspections ↔ filtered_organisations.
Alle units binnen een inspectie opvragen
Join filtered_units op inspection_id.
Parameterresultaten ophalen
Join filtered_parameter_values met:
- filtered_units
- filtered_parameters
- filtered_parameter_items
Impressiescores ophalen
Join filtered_impression_values met de impressie-catalogustabellen.
Defecten/opmerkingen analyseren
Join filtered_remark_values met filtered_remarks.

6. Conclusie

Dit datamodel biedt QC One-klanten volledige toegang tot gedetailleerde, gestructureerde inspectie-informatie.

Het maakt mogelijk:

QC-dashboards
Leveranciersscorekaarten
Geschiedenis van zendingkwaliteit
Automatische meldingen of anomaliedetectie
Integraties met ERP-, BI- en rapportagesystemen

QC One database visualisatie:

BI database model.pdf

QC One - Database Model