Glossary
Term | Definition |
AAA (A3) | AAA (A3) is the Authentication & Authorization Service provided by OS1 Platform. |
Address | An address is a set of human-readable information used for identifying a place like a building, apartment, facility, warehouse, etc. |
App/Application | A web/mobile software that allows an authenticated user to interact with business processes/services by performing actions on backend resources. The app consists of App UI and/or App Backend Service. |
Authentication | The process of confirming the identity of a User. |
Authorization | The process of confirming the permissions granted to a User for taking action on App/OS1 Platform resources. |
Client | Clients are the business entities on the platform responsible for originating orders. |
Consignor | The person sending a shipment to be delivered to a consignee. |
Container | A container is a physical component with a unique ID. It is the smallest entity unit to represent a shipment. |
Core APIs | The Core APIs form the most basic set of libraries and APIs that allow anyone to build business-specific apps on top of them. |
OS1 Services | The services that are available as a part of the OS1 Platform (For example - Participant Service, Secure Data Service, Container Service, Workflow Service, Dispatch Service, etc.). |
Custody | Custody is an implicit mechanism to keep a ledger of what inventory (physical objects) are in the custody of an operator for a given dispatch. |
Consignee | A consignee is someone waiting somewhere for goods or services. |
Dimension: Height | One of three main dimensions (the others being length and width) for an object. Height is measured from the base of an object to the top. |
Dimension: Length | One of three main dimensions for a shipment (the others being width and height.) Length is typically the longest dimension and is measured from one end of the shipment to the other. |
Dimension: Width | The horizontal distance between the edges of a package or other packaging or object. In contrast, height is the measure of the vertical distance from the bottom of the object to the top. |
Dispatch | Dispatch is a manifestation of the intent to move an operator/service provider from or to a location or multiple locations in order to perform a unit of action called to task or a set of tasks. |
Dispatcher | An internal or external individual who can assign operators and vehicles to deliver a set of packages. |
Event | An event is an individual action performed on the entity object either by a user, app, or system. It is an immutable record of a fact that happened during the lifecycle of the entity object. An event may or may not cause the system to change the state of the entity object. |
Event code | An event code is a unique alphanumeric code given to an event. Each event code represents a unique event. A particular Event Code can be associated with only one type of entity. |
Event Sourcing | The event sourcing component is an event-based framework to ensure every change to the state of an application is captured in an event object, and that these event objects are themselves stored in the sequence they were applied for the same lifetime as the application state itself. |
Execution Task | An execution task is the smallest atomic task that is performed by an operator. The execution task will have a binary outcome, i.e., it can either succeed or fail. Note that an ET can’t be canceled; only the ET workflow or objective can be canceled. |
Expected Path | An expected path is a route for the movement of the participant/shipment for fulfilling an order. |
Field Engineer (FE) | The person performing a delivery. |
Generic Dispatcher | A dispatch represents movement and is the generic construct for representing the movement of resources. The generic dispatcher is a set of instructions created in the form of tasks that will be fulfilled by an operator using the generic field app. What makes it generic is that the dispatcher is purely instructions-driven and is not tied to any leg of delivery (last mile, first mile, etc); nor does it have any particular understanding of the task. |
Job | The sequence of workflows to be executed for completing a single leg of the expected path of an order (point to point). |
Last-mile delivery | Last-mile delivery is the movement of goods from a transportation hub to their final delivery destination, whether a residential or commercial address. |
Less than Truckload (LTL) | A freight shipment that does not meet the specifications required for a Full Truckload (TL) shipment. LTL shipments are typically aggregated with other movements to maximize trailer utilization. |
Location | An address with corresponding geographical coordinates. Each Service has one or more locations to be visited in order. Example: Pickup location/Delivery location/Return location. |
Objective | One or more execution tasks to be performed as a workflow for a Container or set of Containers at a given location. Eg: Pick, Drop, KYC, Installation, etc. |
Operators | Onboards resources (users, vehicles, devices, facilities) and use them to complete a task. |
Order | An order is a set of instructions from the originator to complete a task/set of tasks. These tasks can be executed by one or more service providers as per the contract. \n\nA task can be physical or digital in nature. If we are performing the moving of a shipment from a consignor to a consignee then it’s a physical task. Whereas, verifying an address is a digital task. |
Package | The smallest unit is tracked in the lifecycle of a shipment. Has both a human and machine-readable label and resolves to a know package ID in the platform. |
Participant | A Participant is an organization or individual connected to the platform for the purpose of performing any activity on the platform and is governed by the platform rules. |
Permission | Permission represents a named action allowed on a resource. |
Policy | A user attribute (designation, department, etc.) and/or environment (mobile, web, time, etc.) based rule that defines whether a Role can be dynamically granted or denied to a user. |
Reason code | There can be more than one reason which can trigger an event. Reason Code is a unique alphanumeric code given to a reason that triggers an event. It provides additional information/context about the event that has occurred. |
Resource | A resource represents an entity and the possible actions on the entity through the REST API. |
Role | A named set of permissions that can be granted to enable a user or app/service to perform a set of actions in an app. |
Shipment | A shipment is a set of one or more containers to be moved from a consignor (originator of the order) to a consignee (terminal point of order). |
State | The state defines the current status/behavior of an entity object. An object entity undergoes various transitions of states as events are raised on them. States are devoid of any data/information related to the events that were raised on the entity object. At any given point in time, an entity object can be in only one state. |
Templatization | Templatization implements a concept where certain attributes take default predefined values based on a category and subcategory defined during participant type creation or updated on the participant type whenever a requirement for it arises. |
Tenant | A Tenant represents a group of users that have access to a specified set of resources. It is a type of Participant on the OS1 Platform that can create and govern custom usage of their Platform instance for their participants by configuring workflows and business models. |
User | Anyone who uses apps to take actions on Platform entities. |
User Group | A namespace for a set of users grouped together by a common attribute or purpose. |
Vehicle | A Vehicle is used to move individuals, goods/shipments, or tools from point A to B. |