🔁 FLA – Flow-Trigger-Auto

⚙️ Requirements

• PHP: 8.2 or higher
• Node.js: 18.x or higher
• Composer and npm installed
• Docker and docker-compose (for local services)
• On Windows: PHP may require a CA certificate bundle for secure HTTPS connections (e.g., when using Twilio or other APIs). Download it and configure your php.ini as follows:

  curl.cainfo = "C:\\path\\to\\cacert.pem"
  openssl.cafile = "C:\\path\\to\\cacert.pem"
  

  This ensures secure HTTPS connections for all APIs.

---

🧩 What is FLA?

FLA (Flow-Trigger-Auto) is a full-stack, visual automation builder for communication workflows. Design flows like:

• When someone fills out a form,
• Send them an email or SMS,
• Wait a few minutes,
• Send another message,
• Or branch based on their data.

Built with React Flow (frontend) and Laravel (backend).

---

🚀 Quick Start

Note: You must run the database seeder after migrations to use the app's features.

1. Clone the Repository

git clone https://github.com/GregTrifan/flow-trigger-auto.git
cd flow-trigger-auto

2. Start Docker Services

docker-compose up -d

This launches:

• MySQL (with schema/init scripts from docker/mysql/init/)
• Mailhog (for email testing)
• Redis (for queues/caching)

3. Set Up Environment

cp .env.example .env

Edit .env if needed (DB, mail, etc. should match Docker defaults, You should also add your Twilio config vars).

4. Install Dependencies

composer install
npm install

5. Generate App Key

php artisan key:generate

6. Run Migrations

php artisan migrate

7. Seed the Database (Required)

php artisan db:seed

Seeding is required for the app to have initial flows and features.

8. Start the App

php artisan serve
npm run dev
php artisan queue:listen # watches for background jobs

• Visit: http://localhost:8000
• Mailhog UI: http://localhost:8025

---

Key App URLs

Here's where you'll find the main features, ready to explore:

• Workflow Builder: /dashboard/workflow
  • Design, edit, and visualize your automation flow.
• Execution History: /dashboard/executions
  • Track every run, step by step.
• Contact Form: /
  • Here you can try out the form trigger and see your flows in action.

---

🧱 Tech Stack

Layer	Technology
Frontend	React + Vite + React Flow
Backend	Laravel (API & Jobs)
Database	MySQL (Docker)
Email	SMTP (Mailhog, Gmail)
SMS	Twilio API
Queue/Cache	Redis (Docker)

---

🐳 Docker Services

Service	Host/Port	Notes
MySQL	localhost:3306	DB: fla_db, User: fla_user, Pass: fla_password
Mailhog	localhost:8025	Email testing UI
Redis	localhost:6379	Queue/cache

---

✨ Example Flow

[Form Submit]
    ↓
[IF phone exists]
    ↓ YES                      ↓ NO
[Wait 5 min]              [Send Email]
    ↓
[Send SMS]

All logic is visually constructed, stored in the DB, and executed by the backend.

---

🔒 Authentication

Note: In production, all flow/execution endpoints should be protected by authentication middleware.

---

📝 Useful Commands

# Start all services
docker-compose up -d

# Stop all services
docker-compose down

# View logs
docker-compose logs -f

# Reset database (deletes all data!)
docker-compose down -v
docker-compose up -d