The scenario

A port coordinates information across terminals, vessels, trucking and customs. In Vulnverse v2, Port Authority represents those public workflows while keeping terminal operations, crane telemetry, cargo manifests and yard inventory in the private model. The scenario examines which party needs which part of a shared logistics picture.

Begin with a vessel schedule, truck appointment or document exchange. Use the private inventory to ask how that context relates to container movements and cargo metadata. Map ownership and information access across several participants in the same operation.

Public surfaces

Terminal users, carriers, trucking firms and customs brokers reach the port through these routes; the configured exercise inventory sets the actual scope.

Public routes declared in the Port Authority catalog
RouteSurfaceContext
/terminal-portalTerminal operator and stakeholder portal.
/vesselsvessel-scheduleVessel schedule and berth planning facade.
/truckstruck-appointmentsTruck appointment and gate workflow API.
/customscustoms-docsCustoms document exchange facade.

Private systems

terminal-os Private application

Terminal operating system representation.

crane-telemetry Private application

Crane telemetry and maintenance data.

manifest-store Private data

Cargo manifest and bill of lading data store.

yard-inventory Private data

Container yard inventory and movement data.

Exercise questions

  • What should a truck appointment reveal about a container or terminal without exposing a wider cargo inventory?
  • How should vessel scheduling and customs documents be separated from internal yard and manifest records?
  • Which artifact supports an observation about a logistics relationship, and which details remain assumptions?

What to hand in

Produce a participant and data map covering terminal users, vessel information, truck appointments, customs documents and private operations. Support exposure claims with a route, record or observed system response.

Records and evidence

Vessels and berths describe the maritime context. Containers and truck appointments add landside movement context. Customs documents and crane events provide investigation artifacts. Compare the information needed by terminal users, carriers, trucking operators and internal operations.

  • vessels
  • berths
  • containers
  • truck-appointments
  • customs-docs
  • crane-events

Record each Port Authority finding with the research method →