Prefecture RDV Availability Checker Bot

This bot is designed to check for the availability of slots on the website of a French prefecture. It monitors the availability of time slots in the different guichets and logs the results. When a slot becomes available, it sends an email notification. The bot uses the selenium package to automate the web browser and interact with the website.

Features:

Allows users to specify the URL of the prefecture.
Sends an email notification when a guichet is available.
Checks for availability periodically.
Logs the availability status of each guichet.
Runs in a Docker container with a headless Chrome browser.

Prerequisites:

Docker installed on your system.
A Google email account (for SMTP).

Setup:

Clone the Repository:

git clone [repository-url]
cd [repository-name]

Setting up SMTP with Google:

Before the bot can send emails, you'll need to configure SMTP with Google:
- Go to your Google Account.
- In the left navigation panel, click on Security.
- Under “Signing in to Google,” select App Passwords. (You might need to sign in again).
- Create a new app specific password, and name it appropriately, such as RDV Prefecture Bot
- Note down the 16-character password. This will be your SMTP password.
Do note that for this to work, you must have 2-Step Verification enabled on your Google account.

Configure the bot using config.json:

Modify the config.json file in the root directory of the project to include your preferences and SMTP details:

{
    "prefecture_url": "YOUR_PREFECTURE_URL",
    "retry_period_seconds": YOUR_RETRY_PERIOD_IN_SECONDS,
    "to_email": "YOUR_NOTIFICATION_EMAIL_ADDRESS",
    "smtp": {
        "host": "smtp.gmail.com",
        "port": 587,
        "user": "YOUR_GOOGLE_EMAIL_ADDRESS",
        "password": "YOUR_GENERATED_APP_PASSWORD"
    }
}

Build the Docker Image:
```
docker build -t guichet-bot .
```

Usage:

Run the bot:
```
docker run guichet-bot
```

Code Overview:

main.py: Contains the primary logic for the bot. It automates the browser, navigates to the specified URL, checks availability, logs results, and sends email notifications.
Dockerfile: Describes the setup of the Docker container, including the installation of required packages and dependencies.

Note:

Ensure your system has sufficient resources allocated for Docker, as browser automation tools might require more memory.

Limitations:

This bot is specifically tailored for the structure of the website https://pprdv.interieur.gouv.fr. Changes to the website's layout or flow might necessitate modifications to the bot's logic.

Contributing:

Feel free to fork this repository, make changes, and create pull requests. Your contributions are appreciated!

License:

Please refer to the LICENSE file in the repository.

I hope this README helps you get started with the Guichet Availability Checker Bot! If you have any issues or questions, please open an issue in the repository.

issamemari / rdv-prefecture-bot