Contributing Guidelines

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\HasMany;

class Cliente extends Model
{
    // 1. Constants
    public const STATUS_ACTIVE = 'active';
    public const STATUS_INACTIVE = 'inactive';

    // 2. Properties
    protected $table = 'clientes';
    protected $primaryKey = 'id_cliente';
    
    protected $fillable = [
        'nombres',
        'apellidos',
        'nro_documento',
        'correo',
        'telefono',
    ];

    protected $casts = [
        'created_at' => 'datetime',
    ];

    // 3. Relationships
    public function vehiculos(): HasMany
    {
        return $this->hasMany(Vehiculo::class, 'id_cliente', 'id_cliente');
    }

    // 4. Accessors & Mutators
    public function getFullNameAttribute(): string
    {
        return "{$this->nombres} {$this->apellidos}";
    }

    // 5. Methods
    public function isActive(): bool
    {
        return $this->status === self::STATUS_ACTIVE;
    }
}

<?php

namespace App\Http\Controllers;

use App\Models\Cliente;
use Illuminate\Http\Request;
use Illuminate\Http\RedirectResponse;
use Illuminate\View\View;

class ClienteController extends Controller
{
    public function index(): View
    {
        $clientes = Cliente::all();

        return view('clientes.index', compact('clientes'));
    }

    public function store(Request $request): RedirectResponse
    {
        $data = $request->validate([
            'nombres' => 'required|string|max:255',
            'apellidos' => 'required|string|max:255',
            'nro_documento' => 'required|string|unique:clientes',
            'correo' => 'required|email|unique:clientes',
            'telefono' => 'required|string|max:20',
        ]);

        Cliente::create($data);

        return redirect()
            ->route('clientes.index')
            ->with('success', 'Cliente creado correctamente.');
    }
}

# Run full test suite
composer test

# Or run steps individually
php artisan config:clear
composer lint:check
php artisan test

# Check coverage (requires Xdebug)
./vendor/bin/pest --coverage --min=80

## Description
Clear description of the bug

## Steps to Reproduce
1. Go to '...'
2. Click on '...'
3. Scroll down to '...'
4. See error

## Expected Behavior
What should happen

## Actual Behavior
What actually happens

## Environment
- PHP Version: 8.2.x
- Laravel Version: 12.x
- Browser: Chrome 120
- OS: Windows 11 / macOS / Linux

## Screenshots
(If applicable)

## Additional Context
Any other relevant information

## Feature Description
Clear description of the proposed feature

## Use Case
Why is this feature needed? What problem does it solve?

## Proposed Solution
How you envision this working

## Alternatives Considered
Other approaches you've thought about

## Additional Context
Mockups, examples, references

# First-time setup
composer setup

# Start development
composer dev

# Before committing
composer lint      # Fix style
composer test      # Run tests

# Check without changes
composer lint:check