- Admin Panel based on
Flask-Admin-Dashboard
(Flask-Admin
+AdminLTE
= โค๏ธ ) - Product Analytics System: using
Amplitude
orPosthog
orGoogle Analytics
- Performance Monitoring System: using
Prometheus
andGrafana
- Tracking System: using
Sentry
- Seamless use of
Docker
andDocker Compose
- Export all users in
.csv
(or.xlsx
,.json
,yaml
from admin panel) - Configured CI pipeline from git hooks to github actions
-
SQLAlchemy V2
is used to communicate with the database - Database Migrations with
Alembic
- Ability to cache using decorator
- Convenient validation using
Pydantic V2
- Internationalization (i18n) using GNU gettex and
Babel
-
configure environment variables in
.env
file -
start services
docker compose up -d --build
-
make migrations
docker compose exec bot alembic upgrade head
-
install dependencies using Poetry
poetry install
-
start the necessary services (at least the database and redis)
-
configure environment variables in
.env
file -
start telegram bot
poetry run python -m bot
-
start admin panel
poetry run gunicorn -c admin/gunicorn_conf.py
-
make migrations
poetry run alembic upgrade head
to launch the bot you only need a token bot, database and redis settings, everything else can be left out
name | description |
---|---|
BOT_TOKEN |
Telegram bot API token |
RATE_LIMIT |
Maximum number of requests allowed per minute for rate limiting |
DEBUG |
Enable or disable debugging mode (e.g., True or False ) |
USE_WEBHOOK |
Flag to indicate whether the bot should use a webhook for updates (e.g., True or False ) |
WEBHOOK_BASE_URL |
Base URL for the webhook |
WEBHOOK_PATH |
Path to receive updates from Telegram |
WEBHOOK_SECRET |
Secret key for securing the webhook communication |
WEBHOOK_HOST |
Hostname or IP address for the main application |
WEBHOOK_PORT |
Port number for the main application |
ADMIN_HOST |
Hostname or IP address for the admin panel |
ADMIN_PORT |
Port number for the admin panel |
DEFAULT_ADMIN_EMAIL |
Default email for the admin user |
DEFAULT_ADMIN_PASSWORD |
Default password for the admin user |
SECURITY_PASSWORD_HASH |
Hashing algorithm for user passwords (e.g., bcrypt ) |
SECURITY_PASSWORD_SALT |
Salt value for user password hashing |
DB_HOST |
Hostname or IP address of the PostgreSQL database |
DB_PORT |
Port number for the PostgreSQL database |
DB_USER |
Username for authenticating with the PostgreSQL database |
DB_PASS |
Password for authenticating with the PostgreSQL database |
DB_NAME |
Name of the PostgreSQL database |
REDIS_HOST |
Hostname or IP address of the Redis database |
REDIS_PORT |
Port number for the Redis database |
REDIS_PASS |
Password for authenticating with the Redis database |
SENTRY_DSN |
Sentry DSN (Data Source Name) for error tracking |
AMPLITUDE_API_KEY |
API key for Amplitude analytics |
POSTHOG_API_KEY |
API key for PostHog analytics |
PROMETHEUS_PORT |
Port number for the Prometheus monitoring system |
GRAFANA_PORT |
Port number for the Grafana monitoring and visualization platform |
GRAFANA_ADMIN_USER |
Admin username for accessing Grafana |
GRAFANA_ADMIN_PASSWORD |
Admin password for accessing Grafana |
.
โโโ admin # Source code for admin panel
โย ย โโโ __init__.py
โย ย โโโ app.py # Main application module for the admin panel
โย ย โโโ config.py # Configuration module for the admin panel
โย ย โโโ Dockerfile # Dockerfile for admin panel
โย ย โโโ gunicorn_conf.py # Gunicorn configuration file for serving admin panel
โย ย โโโ static # Folder for static assets
โย ย โย ย โโโ css/
โย ย โย ย โโโ fonts/
โย ย โย ย โโโ img/
โย ย โย ย โโโ js/
โย ย โย ย โโโ plugins/
โย ย โโโ templates # HTML templates for the admin panel
โย ย โย ย โโโ admin/
โย ย โย ย โโโ index.html
โย ย โย ย โโโ my_master.html
โย ย โย ย โโโ security/
โย ย โโโ views # Custom View modules for handling web requests
โย ย โโโ __init__.py
โย ย โโโ users.py
โ
โโโ bot # Source code for Telegram Bot
โย ย โโโ __init__.py
โย ย โโโ __main__.py # Main entry point to launch the bot
โย ย โโโ analytics/ # Interaction with analytics services (e.g., Amplitude or Google Analytics)
โย ย โโโ cache/ # Logic for using Redis cache
โย ย โโโ core/ # Settings for application and other core components
โย ย โโโ database/ # Database functions and SQLAlchemy Models
โย ย โโโ filters/ # Filters for processing incoming messages or updates
โย ย โโโ handlers/ # Handlers for processing user commands and interactions
โย ย โโโ keyboards # Modules for creating custom keyboards
โย ย โย ย โโโ default_commands.py # Default command keyboards
โย ย โย ย โโโ __init__.py
โย ย โย ย โโโ inline/ # Inline keyboards
โย ย โย ย โโโ reply/ # Reply keyboards
โย ย โโโ locales/ # Localization files for supporting multiple languages
โย ย โโโ middlewares/ # Middleware modules for processing incoming updates
โย ย โโโ services/ # Business logic for application
โย ย โโโ utils/ # Utility functions and helper modules
โ
โโโ migrations # Database Migrations managed by Alembic
โย ย โโโ env.py # Environment setup for Alembic
โย ย โโโ __init__.py
โย ย โโโ README
โย ย โโโ script.py.mako # Script template for generating migrations
โย ย โโโ versions/ # Folder containing individual migration scripts
โ
โโโ configs # Config folder for Monitoring (Prometheus, Node-exporter and Grafana)
โย ย โโโ grafana # Configuration files for Grafana
โย ย โย ย โโโ datasource.yml
โย ย โโโ prometheus # Configuration files for Prometheus
โย ย โโโ prometheus.yml
โ
โโโ alembic.ini # Configuration file for migrations
โโโ docker-compose.yml # Docker Compose configuration file for orchestrating containers
โโโ Dockerfile # Dockerfile for Telegram Bot
โโโ LICENSE.md # License file for the project
โโโ poetry.lock # Lock file for Poetry dependency management
โโโ pyproject.toml # Configuration file for Python projects, including build tools, dependencies, and metadata
โโโ README.md # Documentation
sqlalchemy
โ object-relational mapping (ORM) library that provides a set of high-level API for interacting with relational databasesasyncpg
โ asynchronous PostgreSQL database client libraryaiogram
โ asynchronous framework for Telegram Bot APIflask-admin
โ simple and extensible administrative interface frameworkloguru
โ third party library for logging in Pythonpoetry
โ development workflowdocker
โ to automate deploymentpostgres
โ powerful, open source object-relational database systempgbouncer
โ connection pooler for PostgreSQL databaseredis
โ in-memory data structure store used as a cache and FSMprometheus
โ time series database for collecting metrics from various systemsgrafana
โ visualization and analysis from various sources, including Prometheus
First off, thanks for taking the time to contribute! Contributions are what makes the open-source community such an amazing place to learn, inspire, and create. Any contributions you make will benefit everybody else and are greatly appreciated.
If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!
Fork
this repository- Create a
branch
Commit
your changesPush
yourcommits
to thebranch
- Submit a
pull request
Distributed under the LGPL-3.0 license. See LICENSE
for more information.