@stevermeister/laravel-php

# Laravel Project - Project Guidelines

## Project Overview
Built with Laravel following PHP and Laravel best practices.

## Development Guidelines

### Project Architecture
- Follow MVC pattern
- Use service classes for business logic
- Repository pattern for data access
- Form requests for validation
- Resource classes for API responses
- Policy classes for authorization

### Coding Standards
- PHP 8.2+ features
- PSR-12 coding standard
- Type declarations everywhere
- Strict types enabled
- Proper DocBlocks
- Follow Laravel conventions
- Use Laravel helpers appropriately

### Code Quality Tools
- Pre-commit hooks:
  - PHP CS Fixer
  - PHPStan level 8
  - Psalm static analysis
  - PHPUnit tests
- Additional:
  - Larastan for Laravel-specific checks
  - Security scanning
  - Unused code detection

### Development Environment

#### Requirements
- PHP: 8.2+
- Composer: 2.x
- Laravel: 11.x
- Database: MySQL/PostgreSQL

#### Testing
- PHPUnit for unit tests
- Laravel Dusk for browser tests
- Feature tests for integration
- Coverage: 80%+

#### Dependencies
Core:
- Laravel Framework 11.x
- Laravel Sanctum for API auth
- Laravel Horizon for queues
- Spatie packages for common features

#### Production
- Octane for performance
- Queue workers
- Scheduler setup
- Cache configuration
- Session handling

### Database Guidelines
- Eloquent ORM
- Migration files
- Seeders for test data
- Factory classes
- Query optimization
- Eager loading

### Security
- CSRF protection
- XSS prevention
- SQL injection prevention
- Rate limiting
- Authentication gates
- Authorization policies

### Artisan Commands
- Custom commands for tasks
- Proper command structure
- Command testing
- Schedule definition

### Queue Management
- Queue jobs for async
- Job batching
- Failed job handling
- Job middleware

### Cache & Performance
- Cache strategies
- Route caching
- Config caching
- View caching
- Database query caching

### Frontend & API
- Blade templating
- API resources
- Form requests
- API versioning
- Pagination