AutoAppoint Engine | Enterprise-Grade Appointment Automation Suite

An advanced, asynchronous browser automation system designed to optimize, monitor, and automate high-demand appointment scheduling workflows. Built for speed, resiliency, and stealth operations.

---

The Challenge & The Solution

The Challenge: High-demand booking platforms suffer from slot scarcity, strict rate-limiting, complex Captchas, and aggressive anti-bot fingerprints, making manual applicant management inefficient and prone to failure.

The Solution: This project provides a robust, modular automation engine that continuously monitors availability, bypasses anti-bot barriers safely (via advanced DOM overriding), handles dynamic configuration loading, and triggers instant alerts through decentralized notification channels.

---

Key Features

🛡️ Core Automation & Anti-Fingerprinting

• Persistent Session Isolation: Browser profile state isolation (browser_sessions/) to preserve cookies and local storage, avoiding repetitive re-authentications.
• Stealth Fingerprint Patches: Deep injection of custom JavaScript initialization scripts (navigator.webdriver removal, custom WebGL vendor spoofing) to counter anti-bot scripts like Sannysoft.
• AI-Powered Captcha Hook: Native, decoupled asynchronous integration layer ready for external third-party solvers (2Captcha, Anti-Captcha).

⚡ Scheduling & Workflow Resiliency

• Dynamic Slot Detection: Optimized DOM analysis searching for real-time validation keywords without blocking the runtime loop.
• Automated Evidence Collection: Full-page photographic evidence generation (screenshots/) instantly saved upon target object identification for audit trails.
• Fail-Safe Orchestration: Centralized error control capturing network exceptions, structural timeouts, and lifecycle hooks.

🔔 Instant Notification Subsystem

• Decoupled Alert Dispatches: Implements an asynchronous dispatching layout supporting real-time Discord webhooks and localized SMS routing protocols.

---

Technical Stack

• Backend & Core Engine: Python 3.12+ (Asynchronous architecture via asyncio)
• Browser Automation: Playwright (Chromium Driver under persistent contexts)
• HTTP Client: HTTPX (Async communication layers)
• Configuration: Python-Dotenv (Strict environment abstraction)

---

Architecture & Data Flow

       ┌─────────────────────────── [ .env Local Configuration ]
       ▼
[ main.py Orchestrator ] ──> [ config.settings ]
       │
       ├──> [ core.browser (StealthBrowserManager) ] ──> Launch Chromium (Persistent Profile)
       ├──> [ scrapers.portal_scraper (PortalScraper) ] ──> Scan DOM & Extract Tokens
       │         │
       │         └─> [ If Slots Detected ] ──> Take Full-Page Screenshot
       │
       ├──> [ core.captcha (CaptchaSolverManager) ] ──> Handle Remote Bypasses
       └──> [ notifications.notifier (NotificationManager) ] ──> Dispatch Alerts (Discord / SMS)

---

Repository Structure

AutoAppoint-Engine/
│
├── config/
│   ├── __init__.py
│   └── settings.py          # Centralized secure settings & .env validation logic
│
├── core/
│   ├── __init__.py
│   ├── browser.py           # Playwright stealth manager & JS injection engine
│   └── captcha.py           # Asynchronous 2Captcha API contract layout
│
├── scrapers/
│   ├── __init__.py
│   └── portal_scraper.py    # Target DOM parsing, keyword scan & screenshot system
│
├── notifications/
│   ├── __init__.py
│   └── notifier.py         # Multi-channel routing engine (Discord Webhooks & SMS)
│
├── browser_sessions/        # Dynamic storage for cookies & state persistence (Git ignored)
├── screenshots/             # Automatically generated audit trail captures
│
├── .env                     # Local environment file (Your private credentials)
├── main.py                  # Main asynchronous workflow engine orchestrator
├── README.md                # System documentation
└── requirements.txt         # Project requirements

---

Quick Start

1. Clone & Install Dependencies

git clone [https://github.com/yourusername/autoappoint-engine.git](https://github.com/yourusername/autoappoint-engine.git)
cd autoappoint-engine
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
pip install -r requirements.txt
playwright install chromium

---

2. Configure Environment Variables (.env)

Create a .env file in the root directory of the project:

# Core Configuration
HEADLESS_MODE=False
DEFAULT_TIMEOUT_MS=30000

# Client & Notifications Data
TARGET_PHONE_NUMBER=+221787184584
DISCORD_WEBHOOK_URL=[https://discord.com/api/webhooks/your_actual_webhook_here](https://discord.com/api/webhooks/your_actual_webhook_here)

# Third-Party Integrations
TWOCAPTCHA_API_KEY=your_actual_2captcha_api_key

---

3. Run the System Test

Execute the main orchestrator loop to observe the anti-bot benchmark scanning and evidence pipeline execution:

python main.py

---

Business Use Cases & Impact

• Visa & Immigration Agencies: Scale client processing by automating thousands of profile submissions simultaneously.
• High-Demand Services: Ensure 100% booking efficiency for local administrative appointments or high-value service slots.
• Workflow Optimization: Saves hundreds of man-hours by replacing manual refreshing with structured, data-driven automation.

Developed by Prince Boyard - Network & System Security Engineer & Python Automation Specialist.