{"schema":"https://ver.cy/schemas/card/1.0.0","id":"vr.wm-obj-003","code":"world-m3-tradable-good","url":"https://ver.cy/models/world-m3-tradable-good/","name":"Tradable Good","alternateNames":["M3"],"kind":"world-model","status":"legacy","version":"0.2.0-legacy","language":"en","classifiers":{"family":"World Models","category":"Physical world and living systems","entryKind":"view-candidate","plane":"","domain":["PHY.OBJ.TYPE"],"industry":["Cross-industry"],"navPath":"NAV.PHY.OBJ.TYPE","tags":["tradable","offer","commodity","view","phy.obj.type"],"facets":{}},"whatItIs":"This meta-model describes items in their market aspect: the good as a saleable class with its classification codes, identifiers, units of measure, packaging hierarchy and batch structure.","purpose":"Items in their market aspect","scope":{"in":[],"out":[],"boundaries":[]},"distinguishingFeatures":["It is its own model because market-facing description evolves on catalogue time (assortments, codes, pack changes) independently of both the chemistry of matter (M1) and the life of individual instances (M2), and because exchange models across the catalogue need a stable good identity to transact against."],"structure":{"bundles":[{"id":"catalogue","name":"catalogue","description":"The good as a described market class","layers":[{"id":"goodDefinition","name":"goodDefinition","description":"name, description, brand reference, origin declaration, lifecycle status","findings":[]},{"id":"variantStructure","name":"variantStructure","description":"variants (size, colour, flavour) and their relation to the base good","findings":[]}]},{"id":"identification","name":"identification","description":"How the market names and codes the good","layers":[{"id":"identifierAssignment","name":"identifierAssignment","description":"identifier scheme assignments at each packaging level","findings":[]},{"id":"classificationCoding","name":"classificationCoding","description":"classification codes from one or more schemes with validity periods","findings":[]}]},{"id":"packaging","name":"packaging","description":"How the good is quantified and packed","layers":[{"id":"packagingHierarchy","name":"packagingHierarchy","description":"each, inner pack, case, pallet levels and their containment","findings":[]},{"id":"unitOfMeasure","name":"unitOfMeasure","description":"net content, sale units and measure codes","findings":[]}]},{"id":"flow","name":"flow","description":"Bounded production populations of the good","layers":[{"id":"batchLot","name":"batchLot","description":"batches with production references, date ranges and recall status","findings":[]}]}]},"agentConduct":{"may":[],"mustNot":[],"requiresHuman":[]},"ethics":{"considerations":[],"affectedParties":[]},"owners":{"steward":"Each good record is stewarded by its seller or holder as established in the catalogue's S1 ownership model; syndication and lookup by other parties happen only under grants issued through S1/S2, with S4 providing the audit trail.","roles":[],"masterSystems":[]},"relations":[{"target":"world.physicalItem","type":"references","note":"serialized instances of a good are items; the item's kind reference resolves here."},{"target":"world.materialSubstance","type":"references","note":"composition and hazard disclosures attached to a good resolve to substance classes."},{"target":"(inbound)","type":"extends","note":"world.foodDrink (M4) and world.medicine (M5) specialize the good with nutrition and medicinal semantics."},{"target":"(inbound) from the exchange cluster (X)","type":"references","note":"offers, sales and settlements refer to good identities defined here; this model holds no transaction facts itself."},{"target":"gs1-gpc","type":"imports","note":"REFERENCE: brick-level product classification scheme."},{"target":"gs1-gtin","type":"imports","note":"REFERENCE: identifier scheme for goods at each packaging level."},{"target":"unspsc","type":"imports","note":"REFERENCE: procurement-oriented classification alternative."},{"target":"unece-rec20","type":"imports","note":"REFERENCE: code list for units of measure."},{"target":"vr.wm-mat-002","type":"requires"}],"interaction":{"identity":{"applicability":"required","items":["goodVariant: a variant of a base good; key attributes: varying dimension, variant value, own identifiers.","identifierAssignment: an identifier issued for the good at a packaging level; key attributes: scheme, value, level, issue date."]},"properties":{"applicability":"not-applicable","items":[]},"recognition":{"applicability":"optional","items":[]},"capabilities":{"applicability":"required","items":["goodDefined: a new good entered the catalogue with its initial definition.","variantIntroduced: a variant of an existing good was declared.","identifierAssigned: an identifier was issued for the good at a packaging level.","classificationRevised: the good moved within a classification scheme or a scheme revision re-coded it.","packagingChanged: the pack hierarchy or net content of the good changed.","batchReleased: a production batch was released into circulation.","batchRecalled: a batch was recalled from circulation.","goodDiscontinued: the good ceased to be offered as a market class."]},"hazards":{"applicability":"optional","items":[]},"interfaces":{"applicability":"required","items":["catalogueSyndication: ongoing supply of good definitions, identifiers and pack data to trading partners and marketplaces.","identifierVerification: query contract answering whether an identifier is genuine, what good and level it names, and its status.","traceabilityDisclosure: batch-level disclosure to a named party (buyer, authority) for a stated purpose and period.","retailListingView: name, brand, variant, net content and consumer-level identifier; omits batches and case-level logistics data.","customsClassificationView: classification codes, origin and measures needed at borders; omits commercial description and variants.","traceabilityView: batches, their windows and recall status; omits catalogue marketing content."]},"context":{"applicability":"required","items":[]}},"sources":[],"openQuestions":["Superseded by a researched world model? Map this legacy card to its successor or retire it."],"resources":{"spec":"/models/world-m3-tradable-good/spec.yaml","agents":"/models/world-m3-tradable-good/AGENTS.md"},"provenance":{"origin":"legacy MMAS card (world-models v0.2)","builtFrom":["models/world-m3-tradable-good/spec.yaml","models/docs/matter-artifacts/M3-tradable-good.md"],"providers":[],"researchStatus":"legacy","generatedAt":"","builder":"tools/build_cards.py@1.0.0"},"completeness":{"sections":{"classifiers":"filled","whatItIs":"derived","purpose":"filled","distinguishingFeatures":"derived","structure":"thin","agentConduct":"missing","ethics":"missing","owners":"filled","relations":"filled","interaction.identity":"derived","interaction.properties":"not-applicable","interaction.recognition":"missing","interaction.capabilities":"derived","interaction.hazards":"missing","interaction.interfaces":"derived","interaction.context":"missing","sources":"missing"},"notes":{"whatItIs":"First sentence of the legacy card introduction.","interaction.capabilities":"Legacy events listed as state transitions.","structure":"Legacy card: layers named, findings and questions never written.","interaction.properties":"Institutional or informational subject: no invented physical properties."},"score":0.438}}