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.