# API de Evidencias - Órdenes de Servicio

## Subir Evidencia a Orden de Servicio

**URL:** `https://aliat.api.s10plus.com/public/evidencias`  
**Método:** `POST`  
**Content-Type:** `multipart/form-data`  
**Headers:** `Authorization: Bearer <JWT_TOKEN>`

### Parámetros (Multipart):

| Campo | Tipo | Descripción | Ejemplo |
|-------|------|-------------|---------|
| `entidad_tipo` | text/plain | Tipo de entidad (debe ser "orden") | `"orden"` |
| `entidad_id` | text/plain | ID de la orden de servicio | `"125"` |
| `imagen` | file | Archivo de imagen (jpg, jpeg, png, webp) | `foto_17140...jpg` |

### Ejemplo de uso con cURL:

```bash
curl -X POST "https://aliat.api.s10plus.com/public/evidencias" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -F "entidad_tipo=orden" \
  -F "entidad_id=125" \
  -F "imagen=@/path/to/foto_17140.jpg"
```

### Respuesta exitosa:

```json
{
  "success": true,
  "data": {
    "id_evidencia": 45,
    "ruta": "storage/evidencias/orden_125_64f8a1b2c3d4e.jpg"
  }
}
```

### Respuestas de error:

```json
{
  "success": false,
  "message": "entidad_tipo debe ser log, aspirante u orden. entidad_id es requerido"
}
```

```json
{
  "success": false,
  "message": "Orden de servicio no encontrada"
}
```

## Obtener Evidencias de una Orden

**URL:** `https://aliat.api.s10plus.com/public/ordenes/{id_orden}/evidencias`  
**Método:** `GET`  
**Headers:** `Authorization: Bearer <JWT_TOKEN>`

### Ejemplo:

```bash
curl -X GET "https://aliat.api.s10plus.com/public/ordenes/125/evidencias" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"
```

### Respuesta:

```json
{
  "success": true,
  "data": [
    {
      "id_evidencia": 45,
      "id_usuario": 1,
      "entidad_tipo": "orden",
      "entidad_id": 125,
      "ruta_archivo": "storage/evidencias/orden_125_64f8a1b2c3d4e.jpg",
      "nombre_original": "foto_17140.jpg",
      "created_at": "2024-01-15 10:30:00"
    }
  ]
}
```

## Flujo Recomendado:

1. **Crear orden de servicio** usando `POST /ordenes`
2. **Obtener el ID** de la orden creada de la respuesta
3. **Subir evidencias** usando `POST /evidencias` con:
   - `entidad_tipo: "orden"`
   - `entidad_id: [ID_DE_LA_ORDEN]`
4. **Consultar evidencias** usando `GET /ordenes/{id}/evidencias`

## Notas Importantes:

- El sistema valida que la orden de servicio exista antes de permitir subir evidencias
- Solo se permiten archivos de imagen: jpg, jpeg, png, webp
- Cada evidencia se asocia específicamente a una orden de servicio
- Las evidencias se almacenan en `storage/evidencias/` con nombres únicos