# 🐾 Pet Adoption Platform

A complete, production-ready pet adoption management system built for animal rescue organizations. Manage pets, process adoption applications, run fundraising draws, and handle memberships — all from a beautiful multi-panel admin interface.

---

## ✨ Key Features

### 🐶 Pet Management

- 📋 Full pet profiles: species, breed, age, gender, size, color, medical records
- 🖼️ Photo gallery with automatic image compression and optimization
- 💉 Vaccination status, special needs flags, and intake date tracking
- 🔄 Status lifecycle: available → fostered → adopted, with full audit trail

### 📝 Adoption & Fostering Workflow

- 🛠️ Customizable application forms (build your own questions per application type)
- 📂 Three application types: adoption, fostering, and financial assistance
- 📅 Interview scheduling and rescheduling with calendar (`.ics`) export
- 🕓 Status history log for every application — nothing is lost
- 🗒️ Internal staff notes per application
- 📧 Automated email notifications at every stage

### 💳 Membership Program

- 🏷️ Tiered membership plans with configurable pricing
- 💰 PayPal payment integration (IPN webhook processing)
- ⏰ Automated expiration tracking and renewal reminders
- 🧾 Full transaction history per member

### 🎟️ Fundraising & Draws

- 🎰 Raffle/draw system with configurable ticket price tiers
- 💸 PayPal IPN integration for ticket purchase processing
- 🏆 Automatic random winner selection (50% of proceeds as prize)
- 📊 Revenue and ticket analytics

### 🖥️ Four Specialized Admin Panels (Filament 4)

| Panel | Path | Purpose |
|-------|------|---------|
| 🔵 Admin | `/admin` | Core adoption workflow, pet management, applications |
| 🟡 Config | `/config` | Content, form builder, species/breeds, settings |
| 🟣 Fundraising | `/fundraising` | Draws, memberships, revenue analytics |
| ⬛ Server | `/server` | Health monitoring, logs, queue jobs, licensing |

### 🌐 Public-Facing Site

- 📈 Homepage with live pet statistics
- 🔍 Browseable pet listings with filters
- 🐱 Individual pet detail pages
- 📰 Blog with articles and news
- 👤 User dashboard and account settings (2FA supported)
- 📱 Fully responsive — mobile and desktop ready

### 👨‍💻 Developer-Friendly

- ⚡ Laravel 13 + PHP 8.5
- 🎛️ Filament 4 admin panels
- 🔁 Livewire 3 + Volt single-file components
- 🎨 Flux UI component library
- 💨 Tailwind CSS 4
- 🧪 Pest 5 test suite (unit, feature, and browser tests)
- 💳 PayPal IPN for payments
- ⚙️ Queue-based background jobs
- 📤 Data export (CSV/Excel) for all application types
- 🔐 Built-in licensing system (RSA-SHA256 signed keys)

---

## 📦 Requirements

- 🐘 PHP 8.5+
- 🗄️ MySQL / MariaDB / PostgreSQL
- 🎼 Composer
- 🟢 Node.js + npm (for asset building)
- 🌐 Laravel-compatible web server (Apache, Nginx, or Laravel Herd/Valet)
- 💳 PayPal account (for membership and draw payments)
- ⏱️ Cron job for Laravel scheduler

---

## 📁 What's Included

- 📦 Full Laravel 13 source code
- 🗃️ Database migrations and seeders
- 📖 Installation documentation
- 🖥️ Pre-built admin panels for all roles
- ✉️ Email templates (27 included)
- 🧪 Pest test suite

---

## 🎯 Use Cases

Perfect for:

- 🐕 Animal rescue organizations
- 🏛️ Humane societies
- 🐩 Breed-specific rescue groups
- 🏠 Foster network coordinators
- 💚 Non-profit animal welfare organizations
