Domain Knowledge
Charter: Ground-up domain courses — the physics, architecture, and operations of the networks we model. Read these to understand what we are inventorying before you touch how we model it.
The platform is domain-agnostic, but the people building it are not allowed to be. These courses take you from first principles to the operational realities of each network we serve. They are full standalone lessons (built with the Vinxi design system) served alongside the Book.
The people and the buyers
The networks are operated by people and bought by organizations — knowing both is as much domain knowledge as knowing the physics:
- Field Personas & the Trust Economy — the six archetypes behind 45 utility-network roles, their jobs and pains, the moments that decide the product, and how low-trust environments shape everything. Read before designing any capture, approval, dispatch, or dashboard surface.
- The Buyer Landscape — what the operator organization needs beyond its user stories: the twin as a financial document, procurement psychology, and the adoption risks that live at the top.
Fiber / FTTx
The optical access network — from photons in glass to the GIS digital twin that inventories it. Start here if you are working on the fiber data model, splicing, or outside-plant topology.
- How Light Travels: The Physics Floor
- PON Architecture: OLT, ODN, ONT
- PON Standards & Generations
- Optical Splitters
- The Outside Plant: CO to Couch
- Fiber Cable Anatomy & Color Coding
- Splicing & Termination
- The Optical Loss Budget
- Test & Measurement: OTDR & Friends
- Network Inventory, GIS & the Digital Twin
- Vocabulary, Glossary & Capstone Quiz
Oil & Gas Networks
The hydrocarbon value chain — upstream gathering, processing, transmission, and the last-mile distribution grid, plus the SCADA and integrity systems that run it.
- The Oil & Gas Value Chain
- What Flows: Products & Properties
- Upstream & Gathering Systems
- Gas Processing & Treatment
- Transmission Pipelines & Hydraulics
- Compressor & Pump Stations
- Pipe, Materials & Protection
- Metering, Regulation & Custody Transfer
- Gas Distribution: The Last Mile
- SCADA, Control & Operations
- Pipeline Integrity, Pigging & Safety
- Network Inventory, GIS & the Digital Twin
- Vocabulary, Glossary & Capstone Quiz
Primers
The evergreen source primers behind the courses now live in this room: FTTx / Fiber Domain Primer · Oil & Gas Networks Domain Primer