How teferdet/finances works
Finances is a Telegram financial assistant: users request currency and market conversions, manage portfolios and alerts, and receive scheduled updates. Its Python bot routes Telegram interactions to handlers, while background services refresh rates and evaluate alerts. A separate web dashboard exposes administrative views through an API; both the bot and API are configured for MongoDB-backed data. The README also documents in-bot administration, diagnostics, localization, and exports. Some handler, parser, and dashboard-page implementations were not sampled, so their internal connections are omitted or marked unverified.
Main entry points: parser_service.py Rate parser · bot.py Bot dispatcher · Program.cs Dashboard API · alert_service.py Alerts and volatility
Components 29
Telegram experience
- Bot dispatcher
app/bot.py - Finance handlers
app/handlers - Admin panel
app/handlers/admin.py - Localization
app/i18n.py
Financial services
- Rate parser
app/services/parser_service.py - Fiat parser
app/services/fiat_parser.py - Crypto parser
app/services/crypto_parser.py - Stocks parser
app/services/stocks_parser.py - Alerts and volatility
app/services/alert_service.py - Portfolio service
app/services/portfolio_service.py - Digest service
app/services/digest_service.py - Analytics reporter
app/services/analytics_reporter.py
Web administration
- Dashboard interface
dashboard/frontend/src/App.tsx - API client
dashboard/frontend/src/api/client.ts - Dashboard API
dashboard/API/Program.cs - Authentication API
dashboard/API/Controllers/AuthController.cs - OTP and JWT auth
dashboard/API/Services/AuthService.cs - Statistics API
dashboard/API/Controllers/StatsController.cs - Statistics service
dashboard/API/Services/StatsService.cs - User data API
dashboard/API/Controllers/UsersController.cs - User data service
dashboard/API/Services/UserDataService.cs
Shared platform
- Bot data store
app/db.py - Redis cache adapter
app/redis_client.py - Memory cache
app/cache.py - Runtime configuration
app/config.py - Dashboard data store
dashboard/API/Repositories/MongoContext.cs - User entity
dashboard/API/Models/Entities/User.cs
Other components
- Telegram user
- Dashboard user
Connections 35
- Telegram user → Bot dispatcher: sends requests
README.md - Bot dispatcher → Finance handlers: routes updates
app/bot.py - Bot dispatcher → Rate parser: starts workers
app/__main__.py - Bot dispatcher → Alerts and volatility: starts workers
app/__main__.py - Bot dispatcher → Digest service: starts worker
app/__main__.py - Bot dispatcher → Analytics reporter: starts reporter
app/__main__.py - Finance handlers → Rate parser: requests conversions
app/handlers/inline_query.py - Rate parser → Bot data store: reads and writes rates
app/services/parser_service.py - Rate parser → Fiat parser: delegates fetching
app/services/parser_service.py - Rate parser → Crypto parser: delegates fetching
app/services/parser_service.py - Rate parser → Stocks parser: delegates fetching
app/services/parser_service.py - Rate parser → Alerts and volatility: checks prices
app/services/parser_service.py - Alerts and volatility → Bot data store: reads price data
app/services/alert_service.py - Finance handlers → Portfolio service: manages portfolios
- Finance handlers → Alerts and volatility: manages alerts
- Digest service → Alerts and volatility: uses alert service
app/services/digest_service.py - Analytics reporter → Bot data store: reads activity data
- Admin panel → Bot data store: reads admin statistics
app/handlers/admin.py - Admin panel → Localization: gets translated text
app/handlers/admin.py - Admin panel → Dashboard API: exports admin data
- Rate parser → Redis cache adapter: uses cache
app/services/parser_service.py - Redis cache adapter → Memory cache: falls back to
app/redis_client.py - Dashboard user → Dashboard interface: uses dashboard
- Dashboard interface → API client: uses API client
- API client → Dashboard API: calls API
- Dashboard API → Authentication API: registers routes
dashboard/API/Program.cs - Dashboard API → Statistics API: registers routes
dashboard/API/Program.cs - Dashboard API → User data API: registers routes
dashboard/API/Program.cs - Authentication API → OTP and JWT auth: delegates authentication
dashboard/API/Controllers/AuthController.cs - OTP and JWT auth → Dashboard data store: stores OTP data
dashboard/API/Services/AuthService.cs - Statistics API → Statistics service: requests statistics
dashboard/API/Controllers/StatsController.cs - Statistics service → Dashboard data store: queries metrics
dashboard/API/Services/StatsService.cs - User data API → User data service: delegates user queries
dashboard/API/Controllers/UsersController.cs - User data service → Dashboard data store: queries user data
dashboard/API/Services/UserDataService.cs - User data service → User entity: maps user records
dashboard/API/Services/UserDataService.cs