How fantom292992-dot/crm_analist_bot works
This is a Telegram lead-generation bot that accepts search parameters, collects company records, scores them, and presents prioritized results. The README documents the FSM, access control, per-user run isolation, pagination, and result download; however, the tree omits the referenced handlers/ and services/ implementations, so those internals are represented as an undocumented pipeline rather than assigned invented paths. The collector, scorer, and offline viewer are visible in the supplied sources. Edges into the pipeline rely on README statements; its exact internal orchestration cannot be verified from the excerpts.
Main entry points: bot.py Bot runtime · lead_collector.py Place collector · lead_scorer.py Lead scorer · scored_leads.csv Scored CSV
Components 13
Telegram bot
- Bot runtime
bot.py - Bot configuration
config.py - Lead pipeline
Lead collection
- Place collector
lead_collector.py - Lead CSV
leads.csv
Lead scoring
- Lead scorer
lead_scorer.py - Scored CSV
scored_leads.csv
Result viewing
- Offline viewer generator
lead_viewer.py - Lead board
leads.html
Other components
- Telegram user
- Telegram
- Nominatim geocoder
- Overture Places
Connections 15
- Telegram user → Telegram: sends parameters
README.md - Telegram → Bot runtime: delivers updates
bot.py - Bot configuration → Bot runtime: configures polling
bot.py - Bot runtime → Lead pipeline: starts pipeline
bot.py - Lead pipeline → Place collector: runs collection
README.md - Place collector → Nominatim geocoder: geocodes cities
lead_collector.py - Place collector → Overture Places: queries places
lead_collector.py - Place collector → Lead CSV: writes leads
lead_collector.py - Lead pipeline → Lead scorer: runs scoring
README.md - Lead scorer → Lead CSV: reads leads
lead_scorer.py - Lead scorer → Scored CSV: writes scores
lead_scorer.py - Telegram user → Bot runtime: requests results
README.md - Bot runtime → Scored CSV: reloads results
README.md - Scored CSV → Offline viewer generator: loads CSV
lead_viewer.py - Offline viewer generator → Lead board: generates board
lead_viewer.py