🚀 TaskMaster Pro

TaskMaster Pro is an AI-powered, intelligent task management platform built with Laravel 11+, Tailwind CSS, and Laravel AI. It enables users to streamline project planning through natural language AI task generation, vector-based semantic search, and real-time background queue processing.

---

✨ Features

• 🤖 AI Project & Task Generation: Generate structured project plans and actionable task lists using AI models (Gemini, Groq, OpenAI, etc.).
• 🔍 Vector Semantic Search: Search tasks using natural language semantic embeddings powered by Laravel AI Embeddings.
• ⚡ Background Queue Processing: Asynchronous job handling for task generation and embedding calculation.
• 📋 Comprehensive Task Management: Filter, sort, and organize tasks by status (To-Do, In-Progress, Done), priority (High, Medium, Low), and due date.
• 🔒 Secure Authentication: Authentication and profile management powered by Laravel Fortify.
• 🔔 Notification System: Built-in user notification management for system and task updates.
• 🐳 Production & Container Ready: Pre-configured Docker, Nginx, PostgreSQL, and Redis setup for instant deployment.

---

🛠️ Tech Stack

• Backend: PHP 8.3+, Laravel 11/13 Framework
• AI Engine: Laravel AI SDK (laravel/ai), Vector Embeddings
• Frontend: Vite, Tailwind CSS 4, JavaScript, Blade Templates
• Database: PostgreSQL (with vector support) / MySQL / SQLite
• Caching & Queues: Redis, Database Queue Driver
• Authentication: Laravel Fortify

---

🚀 Quick Start (Local Development)

Prerequisites

• PHP >= 8.3
• Composer >= 2.x
• Node.js >= 20.x
• PostgreSQL or SQLite / MySQL

Setup Instructions

1. Clone the Repository:

   git clone https://github.com/your-username/taskmaster.git
   cd taskmaster

2. Install Dependencies:

   composer install
   npm install

3. Configure Environment:

   cp .env.example .env
   php artisan key:generate

   Configure your database and AI Provider credentials in .env:

   DB_CONNECTION=pgsql
   DB_HOST=127.0.0.1
   DB_PORT=5432
   DB_DATABASE=taskmaster
   DB_USERNAME=postgres
   DB_PASSWORD=secret
   
   # AI Provider API Keys
   GEMINI_API_KEY=your_gemini_api_key
   GROQ_API_KEY=your_groq_api_key

4. Run Database Migrations:

   php artisan migrate

5. Start Development Server & Background Worker:

   npm run dev
   # In another terminal:
   php artisan serve
   # In another terminal (for AI queue jobs):
   php artisan queue:work

---

🐳 Docker Deployment (Recommended)

Run TaskMaster Pro instantly using Docker Compose:

cp .env.example .env
# Edit .env with your environment secrets
docker-compose up -d --build

Access the app at http://localhost:8000.

For detailed production deployment instructions (Docker, VPS, Nginx, SSL, Supervisor), see DEPLOYMENT.md.

---

🧪 Running Tests

Execute the automated test suite using PHPUnit / Artisan:

php artisan test

---

🚀 Production Build & Optimization

To prepare assets and cache for production deployment:

# Build production frontend bundle
npm run build

# Cache configurations, routes, and views
php artisan config:cache
php artisan route:cache
php artisan view:cache
php artisan event:cache

---

📄 License

This project is licensed under the MIT License.