📌 About

DivulgaZAP is a simple web application that allows users to:

• Discover WhatsApp groups by category
• Share their own WhatsApp groups

🌐 Tech Stack:

• Nginx
• MySQL
• Docker
• Laravel
• JavaScript
• Cloudflare Turnstile

🎓 Purpose

This project was built as a learning project to explore:

• Laravel architecture
• MVC design patterns
• Dockerized development environments
• Web Scraping
• Cloudflare Turnstile

---

🖼️ Screenshots

---

📦 Installation and Setup

⚙️ Requirements

Before starting, make sure you have installed:

1. Git
2. Docker

🚀 Getting Started

Follow the steps below to run the project locally.

1. Clone the repository

git clone https://github.com/hnqca/divulgazap-laravel
cd divulgazap-laravel

2. Configure environment variables

Duplicate the .env.example file and rename it to .env.

3. Build and start the containers

docker compose up -d --build

4. Run composer setup

docker exec -it divulgazap-laravel composer setup

5. Access the application

Open your browser and go to: http://localhost:8000

---

🔒 Cloudflare Turnstile (Required)

This application uses Cloudflare Turnstile to mitigate automated bot submissions when users submit or join WhatsApp groups.

Important

Without valid keys, form submissions will not work.

Obtain your keys from Cloudflare and configure them in your .env file:

CLOUDFLARE_TURNSTILE_SITE_KEY=
CLOUDFLARE_TURNSTILE_SECRET_KEY=

⏱️ Scheduled Tasks

The application uses the Laravel Scheduler to periodically check whether shared WhatsApp group invitation links (older than 24 hours) are still valid.

If a link is no longer valid, the group is automatically hidden.

📄 License

This project is open-source and available under the MIT License.