ccstudent8731/cc-login-bot

CC Login Bot - Docker Hub Overview

🚀 CC Login Bot - Automatische Zeiterfassung für CC Portal

Ein intelligenter Bot für die automatische Zeiterfassung im CC Student Portal mit ***-Benachrichtigungen und robusten Fehlerbehandlungsmechanismen. Erkennt automatisch die freien Tage, und loggt immer an Schultagen gegen 13.20 Uhr ein, und gegen 17.30 Uhr aus.

✨ Features

🔐 Robuste Authentifizierung

• Intelligente Login-Button-Erkennung mit dynamischen IDs
• Mehrere Fallback-Selektoren für maximale Kompatibilität
• Human-like Interaktionen zur Vermeidung von Bot-Erkennung

⏰ Intelligente Zeiterfassung

• Automatisches Starten (Kommen) und Beenden (Gehen) der Zeiterfassung
• Robuste Dialog-Button-Erkennung mit dynamischen IDs
• Vollständige Screenshots der Zeiterfassungsseite
• Intelligente Status-Erkennung und -Validierung

📅 Smart Caching System

• 30-Tage-Cache für Feiertage zur Reduzierung von Portal-Zugriffen
• Automatische Filterung nur zukünftiger Termine
• 30x schnellere Ladezeiten bei wiederholten Läufen
• Intelligente Cache-Erneuerung nach 30 Tagen

📱 ***** Integration**

• Automatische Benachrichtigungen mit Screenshots
• Detaillierte Status-Informationen
• Graceful Behandlung von Rate-Limits
• Vollständige Fehlerbehandlung

🛡️ Robuste Fehlerbehandlung

• Timeout-Management für alle Operationen
• Graceful Behandlung von Netzwerkfehlern
• Umfassende Logging-Funktionalität
• Automatische Wiederholungsmechanismen

🐳 Docker Images

Latest Version: 0.0.3

bash
docker pull ccstudent8731/cc-login-bot:latest

Alle verfügbaren Tags

• ccstudent8731/cc-login-bot:0.0.3 - Latest stable
• ccstudent8731/cc-login-bot:latest - Latest stable

🚀 Schnellstart

1. Docker Container starten

bash
docker run -d \
  --name cc-login-bot \
  -e CC_USERNAME="dein_username" \
  -e CC_PASSWORD="dein_password" \
  -e CC_HOSTNAME="portal_hostname" \
  -e CC_BOT_TOKEN="dein_telegram_bot_token" \
  -e CC_CHAT_ID="dein_telegram_chat_id" \
  ccstudent8731/cc-login-bot:0.0.3

2. Manuelle Ausführung

bash
docker run --rm \
  -e CC_USERNAME="dein_username" \
  -e CC_PASSWORD="dein_password" \
  -e CC_HOSTNAME="portal_hostname" \
  -e CC_BOT_TOKEN="dein_telegram_bot_token" \
  -e CC_CHAT_ID="dein_telegram_chat_id" \
  ccstudent8731/cc-login-bot:0.0.3 \
  python -m src.cli --mode start

⚙️ Konfiguration

Erforderliche Umgebungsvariablen

Optionale Parameter

📋 Verfügbare Modi

Start (Kommen)

bash
docker run --rm \
  -e CC_USERNAME="..." \
  -e CC_PASSWORD="..." \
  -e CC_HOSTNAME="..." \
  -e CC_BOT_TOKEN="..." \
  -e CC_CHAT_ID="..." \
  ccstudent8731/cc-login-bot:0.0.3 \
  python -m src.cli --mode start

Stop (Gehen)

bash
docker run --rm \
  -e CC_USERNAME="..." \
  -e CC_PASSWORD="..." \
  -e CC_HOSTNAME="..." \
  -e CC_BOT_TOKEN="..." \
  -e CC_CHAT_ID="..." \
  ccstudent8731/cc-login-bot:0.0.3 \
  python -m src.cli --mode stop

Test

bash
docker run --rm \
  -e CC_USERNAME="..." \
  -e CC_PASSWORD="..." \
  -e CC_HOSTNAME="..." \
  -e CC_BOT_TOKEN="..." \
  -e CC_CHAT_ID="..." \
  ccstudent8731/cc-login-bot:0.0.3 \
  python -m src.cli --mode test

🔄 Automatisierung mit Cron

Docker Compose Beispiel

yaml
version: '3.8'
services:
  cc-login-bot:
    image: ccstudent8731/cc-login-bot:0.0.3
    environment:
      - CC_USERNAME={CC_USERNAME}
      - CC_PASSWORD={CC_PASSWORD}
      - CC_HOSTNAME={CC_HOSTNAME}
      - CC_BOT_TOKEN={CC_BOT_TOKEN}
      - CC_CHAT_ID={CC_CHAT_ID}
    volumes:
      - ./artifacts:/app/artifacts
    restart: unless-stopped

📊 Performance & Optimierungen

Caching-System

• 30-Tage-Cache für Feiertage
• 30x schnellere Ladezeiten bei wiederholten Läufen
• Intelligente Filterung nur zukünftiger Termine
• Automatische Cache-Erneuerung

Robustheit

• Dynamische ID-Behandlung für alle Portal-Elemente
• Mehrere Fallback-Selektoren für maximale Kompatibilität
• Graceful Fehlerbehandlung für alle Edge Cases
• Timeout-Management für alle Operationen

🔧 Technische Details

Basis-Image

• python:3.12-slim - Leichtgewichtiges Python-Image
• Chromium Browser für Web-Automation
• Alle notwendigen System-Dependencies

Größe

• ~500MB - Optimiert für Produktion
• Schnelle Startzeiten durch intelligentes Caching
• Minimale Ressourcennutzung

Sicherheit

• Keine Credentials im Image - Nur über Umgebungsvariablen
• Isolierte Ausführung in Docker-Container
• Minimale Angriffsfläche durch slim Image

📈 Changelog

Version 0.0.3 (Latest)

• ✅ Robuste dynamische ID-Behandlung für alle Portal-Elemente
• ✅ Intelligente Fallback-Mechanismen für Button-Erkennung
• ✅ Vollständige Tests für Start (Kommen) und Stop (Gehen) Modi
• ✅ Verbesserte Debugging-Ausgaben
• ✅ Optimierte Screenshot-Reihenfolge

Version 0.0.2

• ✅ Intelligentes 30-Tage-Caching für Feiertage
• ✅ Zukunftsfilter für relevante Termine
• ✅ Graceful *** Rate-Limit-Behandlung
• ✅ Vollständige Seiten-Screenshots
• ✅ Robuste Login-Button-Erkennung

Version 0.0.1

• ✅ Grundlegende Zeiterfassungs-Funktionalität
• ✅ ***-Integration
• ✅ Docker-Containerisierung

🆘 Support & Troubleshooting

Häufige Probleme

Login-Fehler:

***-Probleme:

• Bot-Token überprüfen
• Chat-ID korrekt setzen
• Rate-Limits beachten

Portal-Zugriff:

• Hostname korrekt setzen
• Credentials überprüfen
• Netzwerk-Ver***dung testen

Logs anzeigen

bash
docker logs cc-login-bot

🔗 Links

• GitHub Repository: https://github.com/ccstudent8731/CC-Login-Bot
• Docker Hub: https://hub.docker.com/r/ccstudent8731/cc-login-bot

📄 Lizenz

MIT License - Siehe https://github.com/ccstudent8731/CC-Login-Bot/blob/main/LICENSE für Details.

---