Real-Time Workflow
=============================================================================

At this time, the |prt| is the most common way to interact with providers that expose the information through an API or through their website. The workflow is described as **real-time** because every time a container is traced, the results of its status are provided immediately. Of course, the time to trace the container will depend on the provider implementation and the number of containers. APIs are usually very fast where scrapes take longer to retrieve results.

The following is a diagram that shows the design of the |prt|:

..  image:: /_static/realtime-workflow-design.png

The process is initiated by the |tms| application by sending a **Container Publish Event** to |encd|. |encd| notifies |entm| of the new event. |entm| generates a trace job for the container and sends the job to |entr|, which evaluates the job and sends it to the right provider implementation.

When the status is retrieved from the provider, |entr| sends the results to |entm|, which generates the **Container Result Event** and sends it to |encd|. |encd| receives the results event and notifies the |tms| application through the exposed **Web-Hook**.

This initial trace of the container may take just a few seconds or less depending on the interaction with the provider source of information; therefore, the name of |prt|.

Once the container has been published by the |tms| the first time, |entm| will trace the container again through the **Real-Time Scheduler** process that will initiate the trace. How frequently a container is traced depends on several factors calculated from the status of the container when the results are retrieved.

The goal is to provide information about status changes as frequently as possible while balancing the cost of querying the information.

The following sections document all the **Real-Time** providers supported and detailed information about how they work.


..  toctree::
    :maxdepth: 1
    :caption: Contents:

    rt/apl-terminal
    rt/apm
    rt/blount-island-terminal
    rt/bnsf
    rt/conley
    rt/cn
    rt/eagle-marine
    rt/etslink
    rt/everglades
    rt/florida
    rt/ictsi
    rt/its
    rt/lbct
    rt/maher
    rt/matson-c60
    rt/mgt
    rt/nwcs
    rt/oakland-b58
    rt/pacific-coast-terminal
    rt/packer
    rt/piera
    rt/pomtoc
    rt/portland
    rt/ports-america
    rt/port-of-houston
    rt/railsight
    rt/red-hook-terminal
    rt/scspa
    rt/shippers-alameda
    rt/shippers-carson
    rt/shippers-transport
    rt/terminal-5
    rt/terminal-6
    rt/terminal-18
    rt/terminal-30
    rt/termont
    rt/trapac
    rt/trinium
    rt/tti
    rt/up
    rt/washington_united
    rt/yti