telegram-groupfactory

A Telegram bot for managing user groups with MongoDB backend and admin-only configuration.

Features

✅ Create and manage Telegram groups with default user lists
✅ Admin-only configuration (requires STAFF_CHAT_ID)
✅ User management with MongoDB storage
✅ QR code backup for session replication
✅ Interactive admin role selection for group creators
✅ Modular architecture with separation of concerns
✅ Telegram bot integration using Telethon

Architecture

The application follows a modular architecture with the following components:

Configuration: src/config.py - Application configuration with admin access control
Data Models: src/models/ - Data models for users and groups
Services: src/services/ - Business logic for user and group operations
Handlers:
- src/handlers/user_handler.py - User management commands
- src/handlers/group_handler.py - Group management commands
- src/handlers/admin_handler.py - Admin-only configuration commands
Main Application: src/main.py - Entry point with callback and message routing

Setup

Create a .env file with your Telegram API credentials:

TELETHON_API_ID=your_api_id
TELETHON_API_HASH=your_api_hash
TELEGRAM_BOT_TOKEN=your_bot_token
TELETHON_TOKEN=your_session_token

MONGODB_URI=mongodb://localhost:27017
MONGODB_DATABASE=groupfactory
MONGODB_COLLECTION=ghconfig

STAFF_CHAT_ID=your_admin_chat_id
FACTORY_BOT_ID=your_bot_id

Install dependencies:
```
pip install -r requirements.txt
```
Run the application:
```
python src/main.py
```

Docker

To run with Docker:

docker build -t telegram-groupfactory .
docker run telegram-groupfactory

Documentation

ADMIN_IMPLEMENTATION.md - Admin-only configuration features
CONFIGURATION_GUIDE.md - Complete user guide

Quick Start

Admin Commands (Admin Chat Only)

/admin_add_user <username>        - Add user to database
/admin_set_users <id1> <id2> ...  - Set default users for groups
/admin_add_users <id1> <id2> ...  - Add users to default list
/admin_remove_users <id1> <id2>   - Remove users from default list
/admin_get_users                  - Show current default users
/admin_set_qr <qr_code>           - Store QR backup data
/admin_get_qr                     - Retrieve QR backup data

User Commands

/create_group <name>              - Create group with default users
/users                            - List all users
/user <user_id>                   - Get user info
/help                             - Show all available commands

Available Commands

/create_group <name> - Create a new group
/add_users <group_id> <user_ids> - Add users to a group
/get_group <group_id> - Get group information
/users - List all users
/user <user_id> - Get user information
/add_user <user_id> <username> <name> - Add a new user
/delete_user <user_id> - Delete a user

3.0 KiB Raw Permalink Blame History