domainarchitectureoperations

The map is not the path

A fiber network looks simple from a distance. There are routes on a map, points for handholes and cabinets, symbols for closures, and maybe colored lines for different cable sizes. That view is necessary. It is also incomplete in the exact place where operations most often needs precision.

The customer does not ride the geometry. The customer rides a path through fibers, splices, connectors, ports, splitters, and active equipment. The map can place every asset correctly and still leave the operator uncertain about which strand is live, which splice was changed during the last repair, which spare has already been consumed, or which service depends on a particular tray in a particular closure.

This is why the previous cairn, The As-Built Is the Network Model, cannot stop at routes and asset points. A real operating model needs connectivity. And in outside plant, connectivity is decided in places that are easy to under-model: splice closures, pedestals, cabinets, patch panels, and terminals.

Key Takeaway

Geometry tells us where the plant is. Splice connectivity tells us how the network can actually carry service.

The phrase “truth table” is deliberate. In software, a truth table makes the possible inputs and outputs explicit. In fiber, a splice record does the same thing for physical continuity: fiber 13 in cable A connects to fiber 13 in cable B; fiber 14 is reserved; fiber 15 is broken; buffer tube blue exits through the north cable; tray 2 holds a midspan branch; this splitter feeds these drops. The closure is the table where a physical network becomes an answerable graph.

When that table lives in a static PDF, a contractor photo, or a spreadsheet attached to an email, every urgent workflow becomes a reconstruction exercise. During an outage, someone asks the NOC what is affected. During a turn-up, someone asks whether capacity exists. During closeout, someone asks whether the installed plant matches the funded design. During an expansion, someone asks where to branch. The same closure facts are needed again and again.

Closure data carries operational truth

A splice closure is usually drawn as a point. That is appropriate for a map. It is not appropriate for a data model.

Operationally, a closure is a container, a junction, an evidence bundle, and a change boundary. It contains trays, splice sleeves, slack, cable entries, buffer tubes, individual fibers, labels, sometimes splitters, sometimes pass-through fibers, and sometimes undocumented field compromises. It is a junction because it changes physical continuity. It is an evidence bundle because photos, splice sheets, OTDR traces, redlines, and field forms are often the only proof of what happened. It is a change boundary because emergency repairs and construction deviations tend to become durable network facts at that location.

Esri’s telecom domain network documentation is useful because it names several of these ideas directly. It distinguishes lines, junctions, assemblies, junction objects, edge objects, circuit tables, grouping, unit identifiers, containment, and connectivity fields. The exact implementation is Esri-specific, but the conceptual split is broadly useful: telecom networks are not only spatial features; they also have high-cardinality nonspatial objects and circuit paths that need first-class modeling.

That distinction explains why closure records become fragile when we reduce them to notes. A note can say “splice complete.” It cannot reliably answer which fiber units were joined, which pass through, which are dark, which are reserved, which were tested, or which service path now depends on the change.

A “unit” is the countable thing inside a cable or object: an individual fiber, a range of fibers, a port, or another modeled component. Unit-level modeling is what lets a system represent a 144-count cable without pretending it is one undifferentiated line.

This matters for Osprey-shaped work because emergency callouts already produce field evidence and status transitions. Osprey Strike’s ECO workflow ends with downstream activities such as circuit testing and as-built documentation. That boundary is sensible for Strike, but the closure model is where those downstream activities become reusable memory rather than another folder of artifacts.

Good models separate containment from connectivity

The first modeling mistake is to treat “inside” and “connected to” as the same relationship.

Containment answers what lives inside what. A cable contains buffer tubes. A buffer tube contains fibers. A closure contains trays. A tray contains splice sleeves. A cabinet contains splitters and ports. A duct contains cable. A handhole contains slack and access to conduit.

Connectivity answers what is joined to what. Fiber 1 from cable A is spliced to fiber 1 from cable B. A feeder fiber terminates into a splitter input. A splitter output connects to a distribution fiber. A patch port connects a field fiber to equipment. A pass-through fiber continues without being cut. A broken fiber is intentionally not connected.

Both relationships are true. They serve different jobs.

Question Relationship needed Example answer
What assets are in this closure? Containment Two 144-count cables, three trays, one splitter, one abandoned drop cable
Which fibers form this service path? Connectivity Feeder fiber 37 -> splitter input -> output 12 -> distribution fiber 84
Can this cable hold another assignment? Containment and status Fibers 97-144 exist; 113-120 are reserved; 121-144 are dark
What changed during the repair? Connectivity and provenance Fibers 25-36 were moved from tray 1 to tray 3 under repair event R-1042
What should a field tech open? Geometry and containment Closure C-208, west handhole, tray 2, blue buffer tube

If containment is missing, operators cannot locate the physical thing to inspect. If connectivity is missing, operators cannot reason about the path. If provenance is missing, operators cannot decide whether the answer is trusted.

flowchart TD
  Route[Route Geometry] --> Cable[Cable]
  Cable --> Tube[Buffer Tube]
  Tube --> Fiber[Fiber Unit]
  Closure[Splice Closure] --> Tray[Tray]
  Tray --> Splice[Splice Record]
  Fiber --> Splice
  Splice --> OutFiber[Outgoing Fiber Unit]
  Splice --> Evidence[Photo, splice sheet, test result]
  Splice --> Review[Reviewed decision]
  OutFiber --> Service[Service or circuit path]
Definition

Containment locates the components. Connectivity explains the path. Provenance explains why the system believes the path.

The architecture implication is that a closure-level model should not be one giant mutable row. It should be a set of identifiable objects and relationships that can be projected into views. The GIS editor may care about geometry and asset placement. The NOC may care about impact. The field supervisor may care about which closure and tray to open. The closeout reviewer may care about evidence. The system should not force those readers to share one overloaded spreadsheet.

The first useful projection is a traceable path

A team can make this too big by trying to model the entire telecom universe before it models one useful question. The first practical target should be smaller: a traceable path projection.

The path projection answers, for a given service, circuit, fiber, or work order: which physical components explain continuity from one endpoint to another, and what evidence supports each segment?

That projection does not require perfect inventory across the whole network. It requires enough closure-level structure to connect the known pieces. For a first implementation, a path might include:

Path component Why it matters
Endpoint or service identifier Gives the query a business handle
Cable and fiber unit Identifies the physical strand involved
Closure and tray Tells field teams where the relationship is made
Splice relation Explains continuity across cables or through splitters
Status Distinguishes active, reserved, dark, damaged, abandoned, and unknown
Evidence Links the model to photos, splice sheets, test results, or redlines
Review state Shows whether the relationship is proposed, accepted, superseded, or disputed
Effective date Lets operators reason about what was true at outage time

This projection is valuable because it creates one shared object for several teams. The NOC can ask what might be affected. A field supervisor can see where to inspect. A GIS editor can see which asset relationship needs cleanup. A grant or closeout reviewer can see what evidence supports the installed condition. A planner can see where spare capacity is real rather than assumed.

Example: Closure facts during an outage
@NOC ECO is open near the west feeder route. Which customers might share closure C-208?
@Q C-208 has accepted splice records for feeder fibers 37-48 into splitter S-14 outputs 1-12. Six active services trace through those outputs. Two fibers are reserved, four are dark. Last accepted evidence is a splice sheet and OTDR package from the June closeout.
@Field Send the crew to C-208 tray 2 first. If the sheet is right, the affected services are all on the blue tube branch.

The important part of that exchange is not that an agent answered. The important part is that the answer is possible without guessing from a map, a PDF, and someone’s memory. The system has a path projection that turns closure facts into operational language.

Evidence and provenance keep the model honest

Splice data is not static. It changes during construction, restoration, expansion, cleanup, and correction. That is not a problem if the system treats change as normal. It becomes a problem when the current record overwrites its own history.

The Fiber Optic Association’s restoration guidance emphasizes updating documentation after repairs, including new components, splices, closures, fibers that are no longer serviceable, and new test data. That is an operations principle, not an archive principle. A repaired network without updated documentation is only repaired physically; it is still broken as a model.

Osprey Vantage’s lakehouse architecture gives us a useful mental model for preserving trust. Raw source capture belongs at the bottom: photos, forms, splice sheets, OTDR files, contractor exports, GIS changes, and closeout packages. Typed and validated facts sit above that: closure ID, cable ID, fiber unit, tray, splice relationship, status, and test result. Reviewed projections sit above that: accepted path, serviceability, outage impact, capacity, and closeout status.

That layered approach keeps the team out of two traps. The first trap is blind ingestion, where every contractor upload becomes truth. The second trap is invisible correction, where someone fixes the spreadsheet and the system loses the evidence trail. A useful closure model makes both source and decision visible.

Warning

If the current splice table cannot explain when a relationship became true and what evidence supports it, it is a convenience view, not an operating record.

Effective dating matters more than it first appears. During an outage investigation, the relevant question may be what the path looked like before the emergency repair. During billing or closeout, the question may be what was accepted on a particular milestone date. During a dispute, the question may be which source introduced a contested assignment. A model that only stores “latest” forces people to reconstruct time from file names and chat history.

What to capture first

The minimum viable closure model should be boring on purpose. Do not start with every possible telecom modeling feature. Start with the facts that let the team answer path, repair, closeout, and capacity questions without opening five artifacts.

The first pass should capture:

Field group Minimum facts
Identity Closure ID, cable IDs, source system IDs, human-readable labels
Location Geometry, access notes, structure association, route segment
Containment Cable -> tube -> fiber units; closure -> tray -> splice record
Connectivity Incoming unit, outgoing unit, splice type, splitter or port relation where present
Status Active, dark, reserved, damaged, abandoned, unknown, proposed, accepted, superseded
Evidence Photos, splice sheets, OTDR/OLTS results, redlines, field forms, file hashes or source references
Review Submitter, reviewer, decision, timestamp, effective date
Change Work order, ECO, closeout package, correction reason

That is already enough to produce useful projections. It supports a service path, a closure inventory view, a closeout checklist, a restoration packet, and a capacity summary. It also creates obvious places to add sophistication later: circuit management, wavelength schemes, splitter hierarchy, port-level equipment integration, route diversity, loss budget simulation, and automated inconsistency detection.

The key is to keep unknowns explicit. A closure model with an honest unknown status is better than a spreadsheet that silently omits uncertain fibers. Unknowns create work queues. Omissions create false confidence.

This is also a product design point. Unknowns should not make the system feel broken. They should appear as reviewable gaps with source context: missing tray photo, unresolved fiber unit, stale test record, conflicting splice sheet, or unreviewed field correction.

What the team should take away

The closure is where outside plant becomes software-readable. We can draw the route, photograph the work, test the fiber, and still lack an operating model if we do not represent the splice relationships themselves.

That does not mean every team needs a grand telecom digital twin on day one. It means closure-level connectivity deserves the same respect we already give to events, projections, traces, and as-builts. The record should identify the physical units, model containment and connectivity separately, preserve evidence, expose review state, and project answers for the people running the network.

For Osprey and Vantage work, the architectural pattern is familiar. Field systems produce events and artifacts. Ingestion preserves raw evidence. Validation turns evidence into typed facts. Review turns facts into accepted records. Projections turn accepted records into NOC views, closeout views, GIS views, and capacity views. The splice model is not an exception to that pattern. It is one of the strongest reasons to use it.

  1. A correct map is not enough. Fiber operations need closure-level connectivity, not just geometry and asset placement.
  2. Containment and connectivity are different relationships. Mixing them makes the model hard to query and easy to trust incorrectly.
  3. The first useful product is a traceable path projection. It should explain the physical path, the evidence behind it, and the review state of each relationship.
  4. Provenance is operational safety. Splice records change; the system has to preserve why and when they changed.
  5. Start with boring fields. Stable IDs, unit ranges, splice relationships, status, evidence, reviewer, and effective dates unlock most of the early value.

Discussion prompts

  • For a first Vantage-style ingest, which closure artifact should become the anchor: contractor splice sheet, GIS export, field form, photo package, or test package?
  • Who should be allowed to move a splice relationship from proposed to accepted: GIS editor, field supervisor, NOC operator, project manager, or a paired review between two roles?
  • What is the first path question we want the system to answer without human reconstruction: outage impact, service turn-up, spare capacity, closeout acceptance, or grant evidence?

References

  1. Esri ArcGIS Pro: Telecom domain networks - Shows a mature telecom modeling vocabulary: lines, junctions, assemblies, junction objects, edge objects, unit identifiers, circuit tables, containment, and connectivity fields.
  2. Fiber Optic Association: Fiber Optic Restoration Guide - Supports the article's restoration claim: documentation needs to be updated after repair, including components, splices, closures, fibers no longer serviceable, and new test data.
  3. Fiber Optic Association: Outside Plant Fiber Optic Network Design - Useful grounding for treating cable plant documentation as an important design, construction, and maintenance artifact.
  4. Corning: Recommended Fiber Optic Test Guidelines - Gives practical examples of the non-optical and optical documentation that should travel with installed fiber, including route diagrams, splice plans, labels, and test records.
  5. IDOT Communications Fiber Inventory SOP - Public agency example of a fiber inventory and configuration-management process spanning planning, design, construction, and GIS updates.
  6. Broadband Forum: Our Work Areas - Broader industry context for formal access-network requirements, information models, and interoperable network-management specifications.