LIVE

CrowdKeeper

Telegram group management and moderation platform with web admin panel, premium tiers, and background workers.

01 Project Overview

CrowdKeeper is a comprehensive Telegram group management platform. It combines a Telegram bot for group moderation with a Django web admin panel for configuration and analytics. The system supports premium subscription tiers, auto-moderation rules, group statistics, and Celery background workers for scheduled tasks. Nginx handles the web panel serving.

02 Key Features

Auto-Moderation

Configurable warn/mute/ban rules, spam detection, link filtering, and new member restrictions.

Web Admin Panel

Django-powered web interface for group configuration, user management, logs, and analytics dashboards.

Premium Tiers

Subscription system with tiered features: free, premium, and pro levels with different moderation capabilities.

Group Statistics

Activity tracking, member growth analytics, message volume trends, and moderation action reports.

03 System Architecture

Telegram API → Bot Webhook
Aiogram 3.x → Middleware | Moderation Handlers | Admin Handlers
↕ shared database
Django Web Panel → Admin Dashboard | Statistics | Config
Celery Workers → Scheduled cleanup | Statistics collection | Notification dispatch
Data → PostgreSQL | Redis (Broker/Cache/Sessions) | Nginx (Web Panel)

04 Technology Stack

Python Aiogram 3.x Django Celery Redis PostgreSQL Nginx Docker

05 Challenges

Bot + Web Hybrid Architecture

The biggest challenge was coordinating between the async Telegram bot and the synchronous Django web panel. Both services share the same database but run in different process models. Solution: Clear data access patterns, shared models, and Redis for cross-service event signaling.

Scalable Moderation Rules

Different groups need different moderation configurations. Solution: Per-group configuration stored in the database with Redis caching for fast rule evaluation on every message.

06 Results

CrowdKeeper manages moderation for active Telegram groups. The hybrid bot + web panel architecture provides both instant in-chat moderation and a comprehensive admin experience for group managers. The premium tier system enables sustainable operation.

Contest Hub