# BackendAliat - Ejemplos de JSON (App → Servidor)

Base URL: `https://tudominio.com/backend/public`

---

## 1. POST /login
```json
{
  "user": "admin",
  "password": "admin123"
}
```
**Respuesta exitosa:**
```json
{
  "success": true,
  "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
  "data": {
    "id_usuario": 1,
    "nombre": "Administrador",
    "a_paterno": "Sistema",
    "username": "admin",
    "id_rol": 1,
    "desc_rol": "Administrador"
  }
}
```

> Todas las peticiones siguientes requieren el header:
> `Authorization: Bearer <token>`

---

## 2. POST /registrar_actividad
```json
{
  "id_actividad": 3,
  "id_sucursal": 2,
  "comentarios": "Salí a comer al restaurante cercano",
  "latitud": 25.6866,
  "longitud": -100.3161
}
```
**Respuesta:**
```json
{
  "success": true,
  "data": {
    "id_log": 42,
    "id_log_anterior": 41,
    "actividad": {
      "id_actividad": 3,
      "codigo_estatus": "CO01",
      "nombre": "Salí a comer",
      "prefijo": "CO"
    }
  }
}
```

---

## 3. POST /guardar_aspirante
```json
{
  "id_sucursal": 1,
  "nombre": "Juan",
  "a_paterno": "Garcia",
  "a_materno": "Lopez",
  "procedencia": "Preparatoria UANL",
  "telefono_cel": "8112345678",
  "telefono_casa": "8183456789",
  "correo": "aspirante@email.com",
  "grado_estudios": "Preparatoria",
  "programa_interes": "Ingenieria en Sistemas",
  "medio_contacto": "whatsapp",
  "nivel_interes": "Alto",
  "horario_contacto": "Manana 9-12",
  "comentarios": "Interesado en beca"
}
```
**Respuesta:**
```json
{
  "success": true,
  "id_aspirante": 15
}
```

---

## 4. GET /get_ordenes
```
GET /get_ordenes?id_sucursal=1
```
**Respuesta:**
```json
{
  "success": true,
  "data": [
    {
      "id_orden": 1,
      "numero_orden": "OS-2026-001",
      "campus": "FORUM",
      "empresa_escuela": "Empresa XYZ",
      "meta_bdd": "50 alumnos",
      "programa": "Ingenieria",
      "responsable": "Carlos Perez",
      "accion": "Visita programada",
      "fecha_orden": "2026-01-15",
      "nombre_sucursal": "FORUM"
    }
  ]
}
```

---

## 5. PUT /update_orden/{id}
```json
{
  "accion": "Visita realizada - pendiente seguimiento",
  "responsable": "Maria Gonzalez",
  "fecha_orden": "2026-01-20"
}
```

---

## 6. GET /sucursales
**Respuesta:**
```json
{
  "success": true,
  "data": [
    { "id_sucursal": 1, "clave": "FORUM",    "nombre": "FORUM" },
    { "id_sucursal": 2, "clave": "HUASTECA", "nombre": "HUASTECA" }
  ]
}
```

---

## 7. GET /pdis?id_sucursal=1
**Respuesta:**
```json
{
  "success": true,
  "data": [
    {
      "id_pdi": 1,
      "nombre_empresa": "Empresa ABC",
      "domicilio": "Av. Principal 123, Col. Centro",
      "distancia_km": 2.5,
      "estatus_visita": "CF",
      "nombre_sucursal": "FORUM"
    }
  ]
}
```

---

## 8. PUT /pdis/{id}/estatus
```json
{
  "estatus_visita": "CV"
}
```
> Valores validos: `CF` (Confirmado), `CV` (Visitado), `pendiente`

---

## 9. POST /evidencias (multipart/form-data)
```
POST /evidencias
Content-Type: multipart/form-data

entidad_tipo = "log"
entidad_id   = 42
imagen       = <archivo.jpg>
```
**Respuesta:**
```json
{
  "success": true,
  "data": {
    "id_evidencia": 7,
    "ruta": "storage/evidencias/log_42_abc123.jpg"
  }
}
```

---

## 10. GET /actividades/por_prefijo?prefijo=CO
> Filtra logs por prefijo: `IT`, `CO`, `PE`, `DE`, `ACT`

**Respuesta:**
```json
{
  "success": true,
  "data": [
    {
      "id_log": 42,
      "id_usuario": 1,
      "codigo_estatus": "CO01",
      "nombre_actividad": "Sali a comer",
      "prefijo": "CO",
      "fecha_hora": "2026-01-15 13:05:22",
      "latitud": 25.6866,
      "longitud": -100.3161,
      "nombre_sucursal": "FORUM"
    }
  ]
}
```