# Laravel Ticketing System - Copilot Instructions

This is a Laravel-based ticketing system for client service requests with complete project integration capabilities.

## Project Features
- Laravel 10+ with PHP 8.2
- MySQL database integration
- User role management (Solicitante, Responsable, Supervisor, Administrador)
- Ticket states (Abierto, En progreso, Resuelto, Cerrado)
- Priority levels (Baja, Media, Alta, Crítica)
- Project association and contract management
- File attachments support
- Comment history and audit trails
- Comprehensive reporting system
- RESTful API for web integration

## Development Guidelines
- Follow Laravel best practices and conventions
- Use Eloquent ORM for database operations
- Implement proper validation and security measures
- Create comprehensive API documentation
- Use Laravel's built-in authentication and authorization
- Implement proper error handling and logging
- Follow PSR-4 autoloading standards

## Database Design
- Users table with role-based permissions
- Projects table for client project management
- Tickets table with full lifecycle tracking
- Comments table for ticket communication
- Attachments table for file management
- Activity logs for audit trail

## API Integration
- RESTful endpoints for ticket CRUD operations
- Authentication via Laravel Sanctum
- JSON responses with proper status codes
- Rate limiting and security headers
- Comprehensive error handling