Skip to main content

Profile PS3 Application

Comprehensive erosion control project management system built with Laravel 12 and Filament 4.

Overview​

Profile PS3 is a sophisticated Laravel application providing complete lifecycle management for erosion control projects, from initial inquiry through project completion. The system includes dual panels (admin and user-facing), comprehensive material databases, dual calculator systems, and BDO integration for data export.

Platform: Laravel 12.x + Filament 4.1+
Frontend: Inertia.js + Vue 3.2.0
Database: MySQL/MariaDB/SQLite
PHP: 8.3+

Key Features​

Dual Panel System​

  • Admin Panel (/admin): Full administrative control with 20+ resources
  • App Panel (/app): User-facing interface for projects and calculators
  • Role-based access control with super-admin, admin, manager, user roles

Project Management​

  • Complete CRUD for projects with slopes, channels, soil tests
  • Attachment management with AWS S3 integration
  • Milestone achievement tracking
  • Equipment preferences (BYOB - Bring Your Own Bow)
  • Session-based calculations and recommendations

Dual Calculator Systems​

  1. Application Rate Calculator: Coverage calculations for erosion control products
  2. ProGanics BSM Calculator: Specialized calculator for ProGanics Biotic Soil Media

Material Database​

  • ECBs (Erosion Control Blankets): Specifications, coverage data
  • HECPs (Hydraulically Applied Erosion Control Products): Application rates
  • TRMs (Turf Reinforcement Mats): Load requirements, specifications

Geographic Management​

  • Countries, states, cities hierarchy
  • Sales regions with territory assignments
  • Regional notification preferences for sales team

BDO Export System​

  • Incremental data export with checkpoint tracking
  • Automated synchronization with external systems
  • Export history and audit trail

Customer Relationship Management​

  • Primary accounts with sub-accounts (family members)
  • JOAD membership tracking
  • USA Archery number storage
  • Custom notes and CRM functionality

Documentation​

This application includes comprehensive built-in documentation located at /docs in the repository.

Full Documentation: See Z:/Repos/profileps3/docs/ for:

  • Platform architecture and dependencies
  • Database schema (40+ tables documented)
  • Filament panel configuration
  • Authentication and authorization
  • Integrations (AWS S3, Mailgun)
  • BDO export system
  • Calculator implementations
  • Development setup and testing
  • Troubleshooting and deployment

Technology Stack​

Backend:

  • Laravel 12.x
  • Filament 4.1+ (admin panels)
  • Spatie packages (permissions, media library, query builder)
  • Laravel Auditing (audit trail)
  • Laravel Sanctum (API authentication)

Frontend:

  • Inertia.js 0.8+
  • Vue 3.2.0 (Composition API)
  • Tailwind CSS 2.0+
  • Headless UI (accessible components)
  • v-calendar (date selection)

Database:

  • 40+ tables
  • 37+ model policies
  • Global scopes for access control
  • JSON columns for flexible data

Testing:

  • Pest 4.x (100+ tests)
  • Playwright (browser tests)
  • PHPStan (static analysis)
  • Laravel Pint (code style)

Local Development​

# Clone and setup
cd Z:\Repos\profileps3
composer install && npm install

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

# Database
touch database/database.sqlite
php artisan migrate --seed

# Build assets
npm run build

# Start development servers
composer run dev
# This starts: HTTP server, queue worker, log viewer, Vite

Access Points:

Repository Location​

Git Repository: Z:/Repos/profileps3

For complete technical documentation, please refer to the /docs folder in the repository.