CheckPoint Shop Bot 🛒

Telegram bot for university shop operations, enabling students to order products with dormitory delivery. Features role-based access, payment processing, and real-time order tracking.

---

✨ Core Features

• Role System:
  • 👤 Student registration with room details
  • 👨‍💼 Admin panel for inventory/order management
• Shopping Experience:
  • 🛍️ Product catalog browsing with intuitive navigation
  • 📦 Order creation with quantity selection
  • 🏠 Dormitory room delivery
• Payment & Tracking:
  • 💳 Screenshot-based payment confirmation
  • 📊 Real-time order status updates
  • 🔄 Admin order processing workflow

---

🧰 Tech Stack

• Backend:
• Database:
• Telegram Integration:

---

⚙️ Installation & Setup

1. Clone repository

   git clone https://github.com/Zebaro24/Check-Point-SHOP.git
   cd checkpoint-shop-bot

2. Configure environment
   Create .env file:

   DATABASE_URL=postgres://user:password@localhost:5432/shop_db
   TELEGRAM_TOKEN=your_bot_token_here

3. Install dependencies

   python -m venv .venv
   source .venv/bin/activate  # Linux/Mac
   .venv\Scripts\activate    # Windows
   pip install -r requirements.txt

4. Initialize database

   python database.py

---

🚀 Launching the Bot

python runner.py

Client Flow

1. Start bot with /start command
2. Register with room number
3. Browse products → Select items → Confirm payment
4. Track order status in real-time

Admin Flow

1. Access admin panel (pre-configured accounts)
2. Manage product inventory
3. Process orders: Confirm payments → Update statuses → Track deliveries

---

🗂️ Project Structure

handlers/
├── admin_handler.py    # Admin commands processing
├── client_handler.py   # Student interactions
└── base_handler.py     # Core handler logic
db_orm/
├── product.py          # Product data model
├── order.py            # Order management
└── roles.py            # User role definitions
config.py               # Environment configuration
database.py             # DB connection manager
telegram_bot.py         # Bot entry point

---

📸 Interface Preview

Student View	Admin Panel

---

📬 Contact

• Developer: Denys Shcherbatyi
• Email: zebaro.work@gmail.com