baggage-service

Simulate airport baggage flow with Neo4j and Kafka event streams.

11|Updated Mar 23, 2026
One-click install
npx skills add https://github.com/Jupiter41/arthur-airport --skill baggage-service
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: baggage-service
Source: https://github.com/Jupiter41/arthur-airport/tree/main/services/baggage-service
Command: npx skills add https://github.com/Jupiter41/arthur-airport --skill baggage-service

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates the end-to-end baggage lifecycle in an airport digital twin, enabling deterministic throughput modeling, DG screening outcomes, and incident-driven flow control.

Core Features & Use Cases

  • Conveyor pipeline simulation: induction, screening, sorting, make-up, and arrival belts with per-zone throughput and failure modes.
  • Dangerous goods detection and review: probabilistic screening with class-specific rates and false positives, DG flagging, and offload scenarios.
  • System resilience and restart: startup convergence from Neo4j, real-time event streaming via Kafka, and in-memory state reconstruction for continuity.

Quick Start

Launch the baggage-service and observe the end-to-end baggage lifecycle from drop-off to collection in your configured Neo4j/Kafka environment.

Frequently Asked Questions about baggage-service

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How does airport baggage conveyor simulation handle system failures and restarts?▼

Airport baggage conveyor simulation handles system failures by reconstructing in-memory state from a Neo4j database during restart, ensuring continuity. Kafka-based event streams provide real-time metrics for immediate recovery and ongoing flow control.

What is dangerous goods detection in baggage screening and how are false positives handled?▼

Dangerous goods detection in baggage screening uses probabilistic screening with class-specific detection rates to flag items. The simulation handles false positives by applying offload logic to flagged baggage for subsequent review.

How do I simulate end-to-end baggage flow from drop-off to collection?▼

You simulate end-to-end baggage flow by launching the service in a configured Neo4j and Kafka environment. The in-memory conveyor model processes induction, screening, sorting, make-up, and arrival belts with per-zone throughput.

Can I use Kafka and Neo4j for real-time baggage tracking in a digital twin?▼

Yes, you can use Kafka and Neo4j for real-time baggage tracking in a digital twin. Kafka streams real-time events while Neo4j provides the graph database for startup convergence and state persistence across the baggage lifecycle.

How is throughput modeled across different terminals in an airport simulation?▼

Throughput is modeled across terminals using an in-memory conveyor model with zone-based throughput calculations. The simulation tracks screening outcomes and incident responses, applying system-failure effects to offload logic when necessary.

Do I need Neo4j to run baggage flow simulations with DG detection?▼

Yes, you need Neo4j to run baggage flow simulations with DG detection because it provides startup convergence and state persistence. Kafka is also required to handle the real-time event streams for throughput and incident response tracking.