How manikanta7cheruku/showtime-sentinel works
Movie Ticket Monitor watches user-defined movie and theatre criteria, checks availability through interchangeable source adapters, normalizes observations into availability states, deduplicates actionable transitions, persists monitoring history, and notifies users. The main runtime path is CLI/Telegram setup → scheduler → checker → source and state processing → notification and SQLite persistence. README documents a Playwright BookMyShow adapter, fake scenarios, and an optional read-only dashboard; relationships for unsampled dashboard wiring are not asserted here.
Main entry points: checker.py Availability checker · repositories.py SQLite repositories · main.py CLI and wiring · base.py Notification service
Components 23
User interfaces
- CLI and wiring
app/main.py - Bot commands
app/bot/commands.py - Bot runner
app/bot/runner.py - Local dashboard
app/web/dashboard.py
Monitoring pipeline
- Watch scheduler
app/monitoring/scheduler.py - Availability checker
app/monitoring/checker.py - Observation normalizer
app/monitoring/normalizer.py - Watch filters
app/monitoring/filters.py - Availability states
app/monitoring/state.py - Transition deduplicator
app/monitoring/change_detector.py - Domain contracts
app/models/result.py
Availability sources
- Source registry
app/sources/base.py - BookMyShow adapter
app/sources/bookmyshow.py - Fake scenarios
app/sources/fake.py
Notification delivery
- Notification service
app/notifications/base.py - Message formatter
app/notifications/formatter.py - Telegram delivery
app/notifications/telegram.py - Console delivery
app/notifications/console.py
Persistence
- SQLite repositories
app/database/repositories.py - SQLite database
app/database/connection.py
Other components
- Runtime settings
app/config.py - Telegram user
- Telegram API
Connections 25
- CLI and wiring → Watch scheduler: starts
app/main.py - CLI and wiring → Bot runner: starts
app/main.py - CLI and wiring → Runtime settings: loads
app/main.py - Bot runner → Bot commands: registers
app/bot/runner.py - Telegram user → Bot commands: sends commands
README.md - Bot commands → SQLite repositories: manages watches
app/bot/commands.py - Bot commands → Availability checker: runs checks
app/bot/commands.py - Watch scheduler → SQLite repositories: loads watches
README.md - Watch scheduler → Availability checker: runs checks
app/monitoring/scheduler.py - Availability checker → Source registry: selects source
app/monitoring/checker.py - Source registry → Fake scenarios: dispatches
app/sources/base.py - Source registry → BookMyShow adapter: dispatches
README.md - Availability checker → Observation normalizer: normalizes outcome
app/monitoring/checker.py - Observation normalizer → Watch filters: applies filters
app/monitoring/normalizer.py - Observation normalizer → Availability states: derives state
app/monitoring/normalizer.py - Availability checker → Transition deduplicator: decides transition
app/monitoring/checker.py - Availability checker → SQLite repositories: records results
app/monitoring/checker.py - Availability checker → Notification service: sends alert
app/monitoring/checker.py - Notification service → Message formatter: formats messages
app/notifications/console.py - Notification service → Telegram delivery: delivers
app/notifications/telegram.py - Notification service → Console delivery: delivers
app/notifications/__init__.py - Telegram delivery → Telegram API: sends messages
README.md - SQLite repositories → SQLite database: queries
app/database/__init__.py - Local dashboard → SQLite repositories: reads status
app/web/dashboard.py - CLI and wiring → Local dashboard: optionally starts