control/grupo/carguero/agregar - [agregarCarguero]

Path: /var/www/html/qaservicesapp/app/Http/Controllers/ShalomControl/GrupoController.php

🧾 Descripción

Agrega un carguero (cap_id) a un grupo de cargueros de desembarque (grp_id).
El servicio valida que:

• Exista el grupo.

• El grupo tenga su lista de cargueros almacenados en formato JSON.

• El carguero no esté ya incluido en el grupo.

• Luego actualiza la tabla agregando el carguero al listado.

Este servicio modifica directamente la tabla:

emp_grupo_cargueros_desembarque

---

🚀 Endpoint

---

📥 Request Body

Parámetros requeridos

---

🔐 Seguridad

Protegido por autenticación del sistema (middleware).
El servicio no valida permisos dentro de la función.

---

🧠 Flujo del Servicio (resumen real)

1. Validación inicial de parámetros
   

   • Si falta grp_id → retorna error.

   • Si falta cap_id → retorna error.
     
     

2. Obtiene información del grupo

   
   

   SELECT grupo FROM emp_grupo_cargueros_desembarque WHERE id = grp_id

   • Si no existe → error “Grupo no encontrado”.
     
     

3. Decodifica el campo grupo

   • Si el campo grupo tiene JSON → se convierte en array.

   • Si está vacío → se crea array vacío.
     
     

4. Verifica si el carguero ya está en el grupo

   • Si cap_id ya existe → error “El carguero ya se encuentra en el grupo”.
     
     

5. Agrega el nuevo carguero al grupo

   • Inserta cap_id dentro del array.

   • Convierte el array nuevamente a JSON.
     

6. Actualiza la BD

   
   

   UPDATE emp_grupo_cargueros_desembarque SET grupo = json_encode(arreglo_actualizado) WHERE id = grp_id
   
   

7. Retorna éxito

   
   

   "Carguero agregado al grupo"

---

📤 Response 200 – Ejemplo

---

❗ Posibles Errores

1. Falta grp_id

(El mensaje es incorrecto en el código, pero lo dejamos tal cual está implementado.)

---

2. Falta cap_id

---

3. Grupo no existe

---

4. Carguero repetido

---

📚 Schemas (estructuras usadas)

Tabla: emp_grupo_cargueros_desembarque

Ejemplo del campo grupo: ["123", "245", "300"]

---

🗃 Lógica en pseudo-código