How itamarco/telegram-heb-dates-reminder works
Main Components
a) Client Layer:
• Telegram Platform (external service)
• User Interface (Telegram Bot interface)
b) Application Core:
• Bot Service Layer (app/bot/*)
• User Flow Handler (app/user_flow.py)
• Operations Handler (app/operations.py)
• Route Handler (app/routes.py)
c) Supporting Services:
• Cron Job Service (separate container)
• Database Layer (app/db.py)
d) Utility Components:
• Date Utils (app/date_utils.py)
• Text Patterns (app/text_patterns.py)
• Custom Logger (app/custom_logger.py)
[Telegram Platform] <---> [Bot Service Layer]
• v
[User Interface] <---> [Route Handler] <---> [User Flow Handler]
• v
• [Operations Handler]
• v
[Cron Service] <---------------> [Database Layer] <---> [Date Utils]
Special Elements to Highlight
• Model layer (app/models/*) showing the data structures
• Environment configuration (.env)
• API endpoints (vercel.json)
• Testing coverage (tests/*)
Implementation Details
• Asynchronous nature of bot communications
• Separation between bot implementation and business logic
• Date conversion and handling utilities
• Database operations and state management