Stateless Telegram bot for Montenegro Railways timetable lookup. Timetable compiled into the binary at build time — no DB, no cache, no runtime deps. Domain-specific O (n) path-finding on a tree-topology railway network. Runs free of charge on Cloud Run - exactly €0.00 in Google Cloud invoices.
Deployed at @Monterails_bot since January 2024, actively maintained. Serving ~150 unique users per month and ~500 requests per month. Breaking changes are not expected - the scope is intentionally fixed.
Start with:
- Overview - for the reasoning behind the project and solution architecture.
- System Design - for the detailed design of the bot's architecture and its components.
Or any of the following:
| Doc | Covers |
|---|---|
| 1. Overview | The problem, the solution, traffic estimation, scope, and constraints |
| 2. System Design | Functional and non-functional requirements, high-level architecture, capacity estimates |
| 3. Implementation Details | Bot interface, the path-finding algorithm and its correctness assumptions, backend design |
| 4. Development Guidelines | Coding standards and conventions, shared across human and AI contributors |
| 5. Operational Profile | CI/CD, environments, release and rollback, observability, failure recovery, real production costs |
| 6. Extension Roadmap | Scoped future extensions and the trade-offs of each |