TraceableUnit Entity Schema Review

[pwt-cd]

TraceableUnit Entity Schema Review

Please review the schema for the TraceableUnit entity and provide feedback on its structure, field definitions, and relationships.

Schema Overview

Core entity for the BOOST biomass tracking system

Key Fields

• traceableUnitId (string) - Unique ID for each TRU
• unitType (string) - Type of traceable unit
• uniqueIdentifier (string) - Biometric signature, RFID tag, or QR code
• totalVolumeM3 (number) - Total volume of the traceable unit in cubic meters
• currentGeographicDataId (string) - Foreign key to current location
• harvestGeographicDataId (string) - Foreign key to harvest location
• createdTimestamp (string) - When the TRU was created
• harvesterId (string) - Foreign key to harvesting organization
• operatorId (string) - Foreign key to operator
• materialTypeId (string) - Foreign key to Material entity (reference table)
• assortmentType (string) - Type of wood assortment
• qualityGrade (string) - Quality grade classification
• isMultiSpecies (boolean) - True if contains multiple species
• attachedInformation (array) - All data linked to this TRU
• processingHistory (array) - Complete processing chain references (Phase 2)
• parentTraceableUnitId (string) - For split/merge operations (Phase 2)
• childTraceableUnitIds (array) - For split/merge operations (Phase 2)
• currentStatus (string) - Current status of the TRU (Phase 2)
• sustainabilityCertification (string) - FSC, PEFC, etc. claims (Phase 2)
• mediaBreakFlags (array) - Points where data continuity was lost (Phase 2)
• lastUpdated (string) - Timestamp of the most recent data update

Questions for Review

• Are the field types and constraints appropriate?
• Are the required fields correctly identified?
• Are there any missing fields that should be included?
• Do the relationships to other entities make sense?
• Are the field descriptions clear and accurate?

Schema File Location

/drafts/current/schema/traceable_unit/validation_schema.json

Related Documentation

• Schema Directory README
• BOOST ERD Visualization

---

This discussion was created to facilitate community review of the TraceableUnit entity schema. Please share your thoughts, suggestions, and questions to help improve the data model.