api_ddjj/app/Models/UaderUnidadAcademica.php

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;

/**
 * Modelo Eloquent para la tabla `uader_unidad_academica`.
 *
 * Este modelo representa (a pesar del confuso nombre de la tabla) una Sede en la base de datos.
 * Se utiliza para interactuar con la tabla `uader_unidad_academica` y realizar operaciones
 * como consultar datos de esta tabla.
 *
 * Esta tabla tiene relaciones en la base de datos (relaciones MySql) con las siguientes tablas:
 * uader_organica (fk id_sede)
 * uader_organica_versiones (fk id_sede)
 * uader_cumplimiento_semanal (fk lugar)
 * aux_cargos_persona (fk_uacad)
 * uader_cargos_persona (fk uacad)
 * uader_lugares (fk uacad)
 * 
 * Existen tablas en tienen relación con esta pero no a través de relaciones MySql,
 * sino que simplemente contienen campos con id de otras tablas pero no son FKs en el SGBD,
 * se relacionan en esta API a través relaciones de Eloquent.
 * Se desconoce cuantas tablas tiene relación con esta de esta forma,
 * pero se listaran las conocidas y relevantes para esta API:
 * 
 * uader_cargos_grupos (campo sede) => Representada por el Modelo 'UaderCargosGrupo':
 * Este modelo contiene una relación de Eloquent a esta tabla llamada 'Sede', y sirve para indicar
 * la Sede de tal CargoGrupo o 'designación'.
 * 
 * @package App\Models
 */
class UaderUnidadAcademica extends Model
{
    use HasFactory;
    
    /**
     * Nombre de la tabla asociada con el modelo.

     * @var string
     */
    protected $table = 'uader_unidad_academica';

    /**
     * Los atributos (campos de la tabla) que son asignables en masa.
     * uacad => PK.
     * ua_guarani => Codigo de la Unidad Academica a la que pertenece esta sede.
     * descripcion => Nombre de esta sede.
     * 
     * @var array
     */
    protected $fillable = [
        'uacad',
        'descripcion',
        'ua_guarani',
    ];
}