GDG Workshop AI Booking

Ticket Booking API used in workshop exercises for deterministic, constraint-driven AI-assisted engineering.

How to Run (Docker)

Docker is the default boot path for a clean-room local environment.

Requirements

• Docker Engine 24+ (or compatible)
• Docker Compose v2

Start the API

Build and run with the default script mode:

sh run.sh --docker

Alternative detached mode:

sh run.sh --docker-detached

The API is exposed at:

• http://localhost:5000

Verify Health Endpoint

curl http://localhost:5000/api/health

Expected response:

{"status":"ok","message":"API running"}

Stop Containers

sh run.sh --down

SQLite Persistence in Container

The Compose service mounts:

• ./instance:/app/instance

This mount only persists files written under /app/instance.

Local (venv) Fallback

python run.py

Database Seeding

Populate the database with sample events and tickets for workshop exercises:

# Docker
docker compose exec api flask --app run:app seed-db

# Local
flask --app run:app seed-db

This creates 3 events and 10 tickets, including a high-demand ticket for race condition testing. Running the command again clears and re-seeds the data.

Interactive CLI Client

A standalone HTTP client for interacting with the running API (no external tools required):

python cli_tool.py

Optionally specify a custom API URL:

python cli_tool.py --base-url http://localhost:5000

Features: health check, list events, list tickets, book a ticket.