Transaction Entity Schema Review

[pwt-cd]

Transaction Entity Schema Review

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

Schema Overview

Core entity for the BOOST biomass tracking system

Key Fields

• transactionId (string) - Unique identifier for the business transaction
• supplyingOrganizationId (string) - Foreign key to selling organization
• customerOrganizationId (string) - Foreign key to buying organization
• transactionDate (string) - Date of business agreement
• salesDocumentId (string) - Foreign key to sales/delivery documentation
• contractValue (number) - Total monetary value of the transaction
• contractCurrency (string) - Currency code for contract value
• contractTerms (string) - Incoterms delivery conditions
• paymentTerms (string) - Payment conditions and timeline
• transactionStatus (string) - Current status of business transaction
• transactionGeographicDataId (string) - Foreign key to primary transaction location
• brokerOrganizationId (["string","null"]) - Foreign key to intermediary broker organization
• contractSignedDate (["string","null"]) - Date when contract was executed
• expectedDeliveryDate (["string","null"]) - Expected completion/delivery date
• complianceRequirements (array) - Regulatory compliance requirements for transaction
• financialTerms (object) - Detailed financial terms and conditions
• riskManagement (object) - Risk management and mitigation terms
• lastUpdated (string) - Timestamp of last modification

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/transaction/validation_schema.json

Related Documentation

• Schema Directory README
• BOOST ERD Visualization

---

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