Cross-schema relationships
How the 22 document types link via shared identifiers.
Every schema inherits the common title_block, so documents can already be joined on core project fields. The keys below carry the heavy lifting for cross-document reconciliation.
Linking keys
equipment_tag_numbersThe most universal join key. Present in every title_block.
purchase_order_noTies every vendor-supplied document to a single procurement record.
procurement_package_idGroups every document belonging to one purchased package.
parent_equipment_tagDetail / seal drawings point back to the equipment they describe.
line_numberJoins P&IDs, tag lists, cable schedules, and instrument datasheets on piping context.
pid_reference / pid_numberInstrument back-pointer from datasheets and tag lists to the P&ID sheet.
How classes interlink
1. Data Sheets
Spec source
→ 3. P&ID Vendor Level via purchase_order_no + procurement_package_id
Vendor P&IDs share the PO/package as the matching datasheets.
→ 2. Engineering Drawings via parent_equipment_tag
GA, detail, and seal drawings describe the datasheet items.
→ 5. Performance Curves via equipment_tag_numbers
Gas turbine datasheets pair with performance-curve sets.
2. Engineering Drawings
Geometric representation
→ 1. Data Sheets via parent_equipment_tag
Nozzle details, seal drawings, and 3D models point back to a datasheet item.
→ 6. P&ID Project Level via reference_drawings[].drawing_number
Project P&IDs cite GA drawings by document number.
3. P&ID Vendor Level
Package functional schematic
→ 6. P&ID Project Level via continuation_refs.to_drawing
Vendor P&IDs tie into project P&IDs at package boundaries.
→ 4. Cable Schedules via instrument tag + line_number
Cable endpoints match instruments shown on vendor P&IDs.
→ 7. Tag Lists via equipment/instrument/line tags
Tag list rows are populated from the three payload arrays.
4. Cable Schedules
Electrical + instrumentation wiring
→ 3. P&ID Vendor Level via from.tag_equipment_no / to.tag_equipment_no
Endpoints are instruments on vendor P&IDs.
→ 6. P&ID Project Level via from.equipment_tag / to.equipment_tag
Plant-wide cabling references project P&IDs.
5. Performance Curves
Quantitative equipment behavior
6. P&ID Project Level
Plant-wide functional schematic
→ 3. P&ID Vendor Level via reference_drawings + continuation_refs
Project P&IDs reference vendor package P&IDs.
7. Tag Lists
Master cross-reference register
→ 6. P&ID Project Level via pid_reference + pid_sheet
Points back to the P&ID sheet where the tag appears.
