{
  "format": "dataset-manifest/1",
  "slug": "shipping-company-cargo-tracking-application",
  "version": 2,
  "seed": "shipping-company-cargo-tracking-application:1",
  "spec": {
    "format": "dataset/1",
    "slug": "shipping-company-cargo-tracking-application",
    "name": "Cargo Voyage Insights",
    "tagline": "Vessels, routes, cargo containers, customs declarations, and maintenance logs from an international logistics operation.",
    "description": "Logistics companies manage a web of operations to transport goods efficiently across global waterways and land routes. They track various elements of their operations, including the movement of vessels, routes taken, cargo containers, and customs processes essential for timely deliveries. Each operation carries the importance of ensuring that vessels are well-maintained, routes are optimized, and cargo is handled in compliance with regulations. Maintenance logs provide records of vessel upkeep, while customs declarations document the necessary approvals for cargo movement. Vehicle assignments ensure that the right drivers and vehicles are matched to specific cargo containers, facilitating streamlined logistics operations.\n\nThe dataset is structured into several interconnected tables, each representing a core aspect of the logistics operation. The 'vessels' table tracks details of the ships in operation, with each row representing a unique vessel and its specifications. The 'routes' table outlines the paths taken by these vessels, linking to the vessels through a common identifier. 'Cargo_containers' records the details of individual containers, which are associated with specific routes and customs declarations. The 'customs_declarations' table captures the compliance information required for international transport, tying back to both cargo containers and the routes they traverse. 'Maintenance_logs' are linked to vessels, providing insight into their upkeep, while 'vehicle_assignments' details the drivers assigned to transport containers, connecting these assignments to both cargo and routes.\n\nThis dataset proves valuable for addressing a variety of questions related to logistics operations: What maintenance schedules are most effective? What routes are most frequently used? How do customs delays impact delivery times? Practicing with this data can help develop skills in data analysis, operations management, and optimization techniques within the logistics domain. All the data contained within is synthetic, crafted to provide realistic scenarios for those looking to improve their analytical capabilities.",
    "domain": "logistics",
    "shape": "event-log",
    "useCases": [
      "analytics-demo",
      "etl-pipelines"
    ],
    "keywords": [
      "logistics",
      "cargo tracking",
      "vessel management",
      "customs",
      "shipping routes",
      "data analysis",
      "SQL practice"
    ],
    "locale": "en",
    "license": "CC0-1.0",
    "version": 1,
    "tables": {
      "vessels": {
        "description": "This table stores information about the vessels used for transporting goods, including their capacity and status.",
        "rows": 50,
        "columns": {
          "id": {
            "kind": "pk",
            "description": "Unique identifier for each vessel."
          },
          "name": {
            "kind": "words",
            "min": 2,
            "max": 5,
            "description": "Name of the vessel."
          },
          "capacity": {
            "kind": "decimal",
            "min": 1000,
            "max": 30000,
            "scale": 0,
            "description": "Maximum cargo capacity of the vessel in kilograms.",
            "nullable": true,
            "distribution": "normal"
          },
          "status": {
            "kind": "enum",
            "values": [
              "active",
              "inactive"
            ],
            "description": "Current operational status of the vessel.",
            "nullable": true,
            "weights": [
              7,
              2
            ]
          }
        }
      },
      "routes": {
        "description": "This table contains details about the routes taken by vessels, including departure and arrival ports.",
        "rows": 100,
        "columns": {
          "id": {
            "kind": "pk",
            "description": "Unique identifier for each route."
          },
          "vessel_id": {
            "kind": "fk",
            "ref": "vessels.id",
            "description": "References the vessel assigned to this route."
          },
          "departure_port": {
            "kind": "words",
            "min": 2,
            "max": 5,
            "description": "Name of the port from which the vessel departs.",
            "nullable": true
          },
          "arrival_port": {
            "kind": "words",
            "min": 2,
            "max": 5,
            "description": "Name of the port where the vessel arrives.",
            "nullable": true
          },
          "departure_date": {
            "kind": "datetime",
            "from": "2023-01-01",
            "to": "2023-12-31",
            "description": "Date and time when the vessel departs.",
            "dayProfile": "waking"
          }
        }
      },
      "cargo_containers": {
        "description": "This table tracks information about cargo containers, including their contents and assigned routes.",
        "rows": 150,
        "columns": {
          "id": {
            "kind": "pk",
            "description": "Unique identifier for each cargo container."
          },
          "route_id": {
            "kind": "fk",
            "ref": "routes.id",
            "description": "References the route assigned to this container."
          },
          "contents": {
            "kind": "words",
            "min": 3,
            "max": 10,
            "description": "Description of the contents inside the container.",
            "nullable": true
          },
          "weight": {
            "kind": "decimal",
            "min": 100,
            "max": 20000,
            "scale": 0,
            "description": "Total weight of the container in kilograms.",
            "nullable": true,
            "distribution": "long-tail"
          }
        }
      },
      "customs_declarations": {
        "description": "This table captures customs clearance records for various cargo shipments.",
        "rows": 80,
        "columns": {
          "id": {
            "kind": "pk",
            "description": "Unique identifier for each customs declaration."
          },
          "container_id": {
            "kind": "fk",
            "ref": "cargo_containers.id",
            "description": "References the cargo container that this declaration pertains to."
          },
          "status": {
            "kind": "enum",
            "values": [
              "pending",
              "cleared",
              "rejected"
            ],
            "description": "Current status of the customs declaration.",
            "weights": [
              5,
              4,
              1
            ]
          },
          "declaration_date": {
            "kind": "datetime",
            "from": "2023-01-01",
            "to": "2023-12-31",
            "description": "Date when the customs declaration was processed.",
            "nullable": true,
            "when": {
              "column": "status",
              "in": [
                "cleared",
                "rejected"
              ]
            },
            "dayProfile": "business"
          }
        }
      },
      "maintenance_logs": {
        "description": "This table records maintenance activities performed on vessels, typically sporadic events.",
        "rows": 40,
        "columns": {
          "id": {
            "kind": "pk",
            "description": "Unique identifier for each maintenance log."
          },
          "vessel_id": {
            "kind": "fk",
            "ref": "vessels.id",
            "description": "References the vessel that underwent maintenance."
          },
          "maintenance_date": {
            "kind": "datetime",
            "from": "2023-01-01",
            "to": "2023-12-31",
            "description": "Date when maintenance was performed.",
            "dayProfile": "business"
          },
          "description": {
            "kind": "sentence",
            "min": 5,
            "max": 20,
            "description": "Details about the maintenance performed.",
            "nullable": true
          }
        }
      },
      "vehicle_assignments": {
        "description": "This table lists vehicles assigned to transport cargo from ports to final destinations.",
        "rows": 70,
        "columns": {
          "id": {
            "kind": "pk",
            "description": "Unique identifier for each vehicle assignment."
          },
          "container_id": {
            "kind": "fk",
            "ref": "cargo_containers.id",
            "description": "References the cargo container assigned to this vehicle."
          },
          "vehicle_id": {
            "kind": "words",
            "min": 2,
            "max": 5,
            "description": "Identifier for the vehicle used for transport.",
            "nullable": true
          },
          "assignment_date": {
            "kind": "datetime",
            "from": "2023-01-01",
            "to": "2023-12-31",
            "description": "Date when the vehicle was assigned.",
            "dayProfile": "waking",
            "trend": "growing"
          }
        }
      }
    },
    "structure": "multi-table",
    "traits": [
      "categorical",
      "nullable",
      "timestamped"
    ],
    "analysisQuestions": [
      "How often do vessels undergo maintenance?",
      "What is the average shipping time between different ports?",
      "What percentage of customs declarations are cleared on the first attempt?",
      "Which routes have the highest cargo volume?",
      "How do maintenance schedules affect delivery times?"
    ],
    "suggestedQueries": [
      {
        "title": "Join vessels with their routes",
        "sql": "SELECT vessels.name, routes.departure_port, routes.arrival_port FROM vessels JOIN routes ON vessels.id = routes.vessel_id;",
        "dialect": "postgres"
      },
      {
        "title": "Count cargo containers per route",
        "sql": "SELECT routes.id, COUNT(cargo_containers.id) AS container_count FROM routes LEFT JOIN cargo_containers ON routes.id = cargo_containers.route_id GROUP BY routes.id;",
        "dialect": "postgres"
      },
      {
        "title": "Average weight of cargo per customs status",
        "sql": "SELECT customs_declarations.status, AVG(cargo_containers.weight) AS avg_weight FROM customs_declarations JOIN cargo_containers ON customs_declarations.container_id = cargo_containers.id GROUP BY customs_declarations.status;",
        "dialect": "postgres"
      },
      {
        "title": "Maintenance frequency by vessel",
        "sql": "SELECT vessels.name, COUNT(maintenance_logs.id) AS maintenance_count FROM vessels LEFT JOIN maintenance_logs ON vessels.id = maintenance_logs.vessel_id GROUP BY vessels.name;",
        "dialect": "postgres"
      }
    ],
    "usageScenarios": [
      {
        "title": "Logistics Analysis",
        "body": "A logistics analyst can use this dataset to evaluate shipping efficiency by analyzing routes, vessel utilization, and customs clearance times. By identifying bottlenecks in the logistics chain, they can recommend improvements to optimize operations."
      },
      {
        "title": "Customs Compliance Monitoring",
        "body": "A compliance officer in the logistics company can utilize the customs_declarations table to monitor the status of shipments and ensure that all cargo complies with international regulations. This helps mitigate risks associated with customs delays."
      },
      {
        "title": "Maintenance Scheduling",
        "body": "A fleet manager can leverage the maintenance_logs to track the upkeep of vessels. By analyzing the frequency and types of maintenance performed, they can schedule preventative maintenance to minimize downtime and ensure vessel reliability."
      },
      {
        "title": "Cargo Tracking",
        "body": "A shipment coordinator can use the cargo_containers and vehicle_assignments tables to track containers from departure to delivery. This enables them to provide accurate updates to customers about their shipments and improve overall service quality."
      }
    ]
  },
  "counts": {
    "vessels": 50,
    "maintenance_logs": 40,
    "routes": 100,
    "cargo_containers": 150,
    "customs_declarations": 80,
    "vehicle_assignments": 70
  },
  "stats": {
    "vessels": {
      "rows": 50,
      "columns": {
        "id": {
          "nulls": 0,
          "distinct": 50,
          "min": 1,
          "max": 50
        },
        "name": {
          "nulls": 0,
          "distinct": 50
        },
        "capacity": {
          "nulls": 4,
          "distinct": 46,
          "min": 5563,
          "max": 25413
        },
        "status": {
          "nulls": 2,
          "distinct": 2,
          "min": "active",
          "max": "inactive"
        }
      }
    },
    "routes": {
      "rows": 100,
      "columns": {
        "id": {
          "nulls": 0,
          "distinct": 100,
          "min": 1,
          "max": 100
        },
        "vessel_id": {
          "nulls": 0,
          "distinct": 42,
          "min": 1,
          "max": 50
        },
        "departure_port": {
          "nulls": 9,
          "distinct": 91
        },
        "arrival_port": {
          "nulls": 7,
          "distinct": 93
        },
        "departure_date": {
          "nulls": 0,
          "distinct": 100,
          "min": "2023-01-03 20:23:11",
          "max": "2023-12-31 20:51:38"
        }
      }
    },
    "cargo_containers": {
      "rows": 150,
      "columns": {
        "id": {
          "nulls": 0,
          "distinct": 150,
          "min": 1,
          "max": 150
        },
        "route_id": {
          "nulls": 0,
          "distinct": 78,
          "min": 1,
          "max": 99
        },
        "contents": {
          "nulls": 13,
          "distinct": 137
        },
        "weight": {
          "nulls": 12,
          "distinct": 138,
          "min": 100,
          "max": 19790
        }
      }
    },
    "customs_declarations": {
      "rows": 80,
      "columns": {
        "id": {
          "nulls": 0,
          "distinct": 80,
          "min": 1,
          "max": 80
        },
        "container_id": {
          "nulls": 0,
          "distinct": 63,
          "min": 1,
          "max": 150
        },
        "status": {
          "nulls": 0,
          "distinct": 3,
          "min": "cleared",
          "max": "rejected"
        },
        "declaration_date": {
          "nulls": 34,
          "distinct": 46,
          "min": "2023-01-08 12:33:23",
          "max": "2023-12-25 15:12:07"
        }
      }
    },
    "maintenance_logs": {
      "rows": 40,
      "columns": {
        "id": {
          "nulls": 0,
          "distinct": 40,
          "min": 1,
          "max": 40
        },
        "vessel_id": {
          "nulls": 0,
          "distinct": 27,
          "min": 1,
          "max": 49
        },
        "maintenance_date": {
          "nulls": 0,
          "distinct": 40,
          "min": "2023-01-01 08:27:33",
          "max": "2023-12-31 10:00:17"
        },
        "description": {
          "nulls": 3,
          "distinct": 37
        }
      }
    },
    "vehicle_assignments": {
      "rows": 70,
      "columns": {
        "id": {
          "nulls": 0,
          "distinct": 70,
          "min": 1,
          "max": 70
        },
        "container_id": {
          "nulls": 0,
          "distinct": 54,
          "min": 4,
          "max": 147
        },
        "vehicle_id": {
          "nulls": 4,
          "distinct": 66
        },
        "assignment_date": {
          "nulls": 0,
          "distinct": 70,
          "min": "2023-01-04 13:26:12",
          "max": "2023-12-31 08:25:18"
        }
      }
    }
  },
  "artifacts": [
    {
      "file": "csv/vessels.csv",
      "format": "csv",
      "table": "vessels",
      "key": "datasets/shipping-company-cargo-tracking-application/v2/csv/vessels.csv",
      "url": "https://database-sample-website.s3.eu-north-1.amazonaws.com/datasets/shipping-company-cargo-tracking-application/v2/csv/vessels.csv",
      "bytes": 2052,
      "sha256": "a6d82a13759565d4a8f495cfe5d2820c181c4aeae47af6431381e8cf9759c41f",
      "rows": 50,
      "contentType": "text/csv; charset=utf-8"
    },
    {
      "file": "csv/maintenance_logs.csv",
      "format": "csv",
      "table": "maintenance_logs",
      "key": "datasets/shipping-company-cargo-tracking-application/v2/csv/maintenance_logs.csv",
      "url": "https://database-sample-website.s3.eu-north-1.amazonaws.com/datasets/shipping-company-cargo-tracking-application/v2/csv/maintenance_logs.csv",
      "bytes": 3205,
      "sha256": "952cbe423cf8a403947be54b7be2b34e21b4703d5380539d281709564bde6ff9",
      "rows": 40,
      "contentType": "text/csv; charset=utf-8"
    },
    {
      "file": "csv/routes.csv",
      "format": "csv",
      "table": "routes",
      "key": "datasets/shipping-company-cargo-tracking-application/v2/csv/routes.csv",
      "url": "https://database-sample-website.s3.eu-north-1.amazonaws.com/datasets/shipping-company-cargo-tracking-application/v2/csv/routes.csv",
      "bytes": 7164,
      "sha256": "f2c1387b6459b5d4ddb99eaf61c1c9badf6e904ec92831a75c316bb2a4169476",
      "rows": 100,
      "contentType": "text/csv; charset=utf-8"
    },
    {
      "file": "csv/cargo_containers.csv",
      "format": "csv",
      "table": "cargo_containers",
      "key": "datasets/shipping-company-cargo-tracking-application/v2/csv/cargo_containers.csv",
      "url": "https://database-sample-website.s3.eu-north-1.amazonaws.com/datasets/shipping-company-cargo-tracking-application/v2/csv/cargo_containers.csv",
      "bytes": 7848,
      "sha256": "f036856e6b9ec7b69fcef6131ea633cb466366e5e59593752ea28a38dc8b456f",
      "rows": 150,
      "contentType": "text/csv; charset=utf-8"
    },
    {
      "file": "csv/customs_declarations.csv",
      "format": "csv",
      "table": "customs_declarations",
      "key": "datasets/shipping-company-cargo-tracking-application/v2/csv/customs_declarations.csv",
      "url": "https://database-sample-website.s3.eu-north-1.amazonaws.com/datasets/shipping-company-cargo-tracking-application/v2/csv/customs_declarations.csv",
      "bytes": 2217,
      "sha256": "a9fa26a216d70ac077ff1e3af9d303350a866b1dbb47e53012c327874a07e849",
      "rows": 80,
      "contentType": "text/csv; charset=utf-8"
    },
    {
      "file": "csv/vehicle_assignments.csv",
      "format": "csv",
      "table": "vehicle_assignments",
      "key": "datasets/shipping-company-cargo-tracking-application/v2/csv/vehicle_assignments.csv",
      "url": "https://database-sample-website.s3.eu-north-1.amazonaws.com/datasets/shipping-company-cargo-tracking-application/v2/csv/vehicle_assignments.csv",
      "bytes": 3549,
      "sha256": "9dac1c878fbe1a34e2517d5a549b7f3054659a6f5eb526be2d85111eeddf73d2",
      "rows": 70,
      "contentType": "text/csv; charset=utf-8"
    },
    {
      "file": "shipping-company-cargo-tracking-application.json",
      "format": "json",
      "table": null,
      "key": "datasets/shipping-company-cargo-tracking-application/v2/shipping-company-cargo-tracking-application.json",
      "url": "https://database-sample-website.s3.eu-north-1.amazonaws.com/datasets/shipping-company-cargo-tracking-application/v2/shipping-company-cargo-tracking-application.json",
      "bytes": 72881,
      "sha256": "5750166ef27860bde8a7361be465dddfc4c974f73bf6c42397039ba5e420ff7d",
      "rows": null,
      "contentType": "application/json; charset=utf-8"
    },
    {
      "file": "sql/postgres.sql",
      "format": "sql-postgres",
      "table": null,
      "key": "datasets/shipping-company-cargo-tracking-application/v2/sql/postgres.sql",
      "url": "https://database-sample-website.s3.eu-north-1.amazonaws.com/datasets/shipping-company-cargo-tracking-application/v2/sql/postgres.sql",
      "bytes": 35769,
      "sha256": "59033b457aa375a9c1fd11352d12e12094c262e0d7c235c513a6f64e5021ed95",
      "rows": null,
      "contentType": "application/sql; charset=utf-8"
    },
    {
      "file": "sql/mysql.sql",
      "format": "sql-mysql",
      "table": null,
      "key": "datasets/shipping-company-cargo-tracking-application/v2/sql/mysql.sql",
      "url": "https://database-sample-website.s3.eu-north-1.amazonaws.com/datasets/shipping-company-cargo-tracking-application/v2/sql/mysql.sql",
      "bytes": 35034,
      "sha256": "b4b59fc1f16b3c0be0b4066c1cbba761f14ce637e18d351c8244e8c67dabffbd",
      "rows": null,
      "contentType": "application/sql; charset=utf-8"
    },
    {
      "file": "sql/mssql.sql",
      "format": "sql-mssql",
      "table": null,
      "key": "datasets/shipping-company-cargo-tracking-application/v2/sql/mssql.sql",
      "url": "https://database-sample-website.s3.eu-north-1.amazonaws.com/datasets/shipping-company-cargo-tracking-application/v2/sql/mssql.sql",
      "bytes": 36350,
      "sha256": "69ef204409d38211722dd5a3f900464798237980d0faac842374588bf5c672a6",
      "rows": null,
      "contentType": "application/sql; charset=utf-8"
    },
    {
      "file": "sql/sqlite.sql",
      "format": "sql-sqlite",
      "table": null,
      "key": "datasets/shipping-company-cargo-tracking-application/v2/sql/sqlite.sql",
      "url": "https://database-sample-website.s3.eu-north-1.amazonaws.com/datasets/shipping-company-cargo-tracking-application/v2/sql/sqlite.sql",
      "bytes": 34723,
      "sha256": "26267c52840d0a70ec4109bdb349be3844b9dd269d88a451ae749f674019fcab",
      "rows": null,
      "contentType": "application/sql; charset=utf-8"
    },
    {
      "file": "prisma/seed.ts",
      "format": "prisma-seed",
      "table": null,
      "key": "datasets/shipping-company-cargo-tracking-application/v2/prisma/seed.ts",
      "url": "https://database-sample-website.s3.eu-north-1.amazonaws.com/datasets/shipping-company-cargo-tracking-application/v2/prisma/seed.ts",
      "bytes": 62547,
      "sha256": "fbe591210a9a368cfbcaff13baa488eb210767c4175d1bd65d7efa71f143f645",
      "rows": null,
      "contentType": "application/typescript; charset=utf-8"
    },
    {
      "file": "django/fixtures.json",
      "format": "django-fixture",
      "table": null,
      "key": "datasets/shipping-company-cargo-tracking-application/v2/django/fixtures.json",
      "url": "https://database-sample-website.s3.eu-north-1.amazonaws.com/datasets/shipping-company-cargo-tracking-application/v2/django/fixtures.json",
      "bytes": 96249,
      "sha256": "1199409218f2d4f53332170a1a5cdad67e4ba7e6577611f5a9aae9da4b2967fb",
      "rows": null,
      "contentType": "application/json; charset=utf-8"
    }
  ],
  "publishedAt": 1788768538978,
  "updatedAt": 1788785928363
}