Mejora de comentarios en las propiedades de los modelos

Model/EstadoProyecto.php

@@ -33,19 +33,19 @@ class EstadoProyecto extends ModelClass
 {
     use ModelTrait;
 
-    /** @var string */
+    /** Color de fondo asociado al estado. @var string */
     public $color;
 
-    /** @var bool */
+    /** Indica si los proyectos con este estado se pueden editar. @var bool */
     public $editable;
 
-    /** @var integer */
+    /** Identificador del estado. @var integer */
     public $idestado;
 
-    /** @var string */
+    /** Nombre del estado. @var string */
     public $nombre;
 
-    /** @var bool */
+    /** Indica si es el estado predeterminado para nuevos proyectos. @var bool */
     public $predeterminado;
 
     public function clear(): void

Model/FaseTarea.php

@@ -34,26 +34,36 @@ class FaseTarea extends ModelClass
     use ModelTrait;
 
     /**
+     * Estado de proyecto que se asigna al vincular esta fase.
+     *
      * @var integer
      */
     public $idestado;
 
     /**
+     * Identificador de la fase.
+     *
      * @var integer
      */
     public $idfase;
 
     /**
+     * Nombre de la fase.
+     *
      * @var string
      */
     public $nombre;
 
     /**
+     * Indica si es la fase predeterminada para nuevas tareas.
+     *
      * @var bool
      */
     public $predeterminado;
 
     /**
+     * Tipo de fase: completada, en proceso o cancelada.
+     *
      * @var integer
      */
     public $tipo;

Model/NotaProyecto.php

@@ -34,22 +34,22 @@ class NotaProyecto extends ModelClass
 {
     use ModelTrait;
 
-    /** @var string */
+    /** Texto de la nota. @var string */
     public $descripcion;
 
-    /** @var string */
+    /** Fecha de la nota. @var string */
     public $fecha;
 
-    /** @var integer */
+    /** Identificador de la nota. @var integer */
     public $idnota;
 
-    /** @var integer */
+    /** Identificador del proyecto al que pertenece la nota. @var integer */
     public $idproyecto;
 
-    /** @var integer */
+    /** Identificador de la tarea a la que pertenece la nota. @var integer */
     public $idtarea;
 
-    /** @var string */
+    /** Nick del usuario que crea la nota. @var string */
     public $nick;
 
     public function clear(): void

Model/Proyecto.php

@@ -39,49 +39,49 @@ class Proyecto extends ModelClass
 {
     use ModelTrait;
 
-    /** @var string */
+    /** Código del cliente asociado al proyecto. @var string */
     public $codcliente;
 
-    /** @var string */
+    /** Descripción del proyecto. @var string */
     public $descripcion;
 
-    /** @var bool */
+    /** Indica si el proyecto se puede editar. @var bool */
     public $editable;
 
-    /** @var string */
+    /** Fecha de creación del proyecto. @var string */
     public $fecha;
 
-    /** @var string */
+    /** Fecha de finalización del proyecto. @var string */
     public $fechafin;
 
-    /** @var string */
+    /** Fecha de inicio del proyecto. @var string */
     public $fechainicio;
 
-    /** @var int */
+    /** Identificador de la empresa. @var int */
     public $idempresa;
 
-    /** @var int */
+    /** Identificador del estado actual del proyecto. @var int */
     public $idestado;
 
-    /** @var int */
+    /** Identificador del proyecto. @var int */
     public $idproyecto;
 
-    /** @var string */
+    /** Nick del usuario que crea el proyecto. @var string */
     public $nick;
 
-    /** @var string */
+    /** Nombre del proyecto. @var string */
     public $nombre;
 
-    /** @var bool */
+    /** Indica si el proyecto es privado y solo lo pueden ver los usuarios asignados. @var bool */
     public $privado;
 
-    /** @var float */
+    /** Total de compras asociadas al proyecto. @var float */
     public $totalcompras;
 
-    /** @var float */
+    /** Total pendiente de facturar del proyecto. @var float */
     public $totalpendientefacturar;
 
-    /** @var float */
+    /** Total de ventas asociadas al proyecto. @var float */
     public $totalventas;
 
     public function clear(): void

Model/StockProyecto.php

@@ -37,28 +37,28 @@ class StockProyecto extends ModelClass
 
     const MAX_DECIMALS = 3;
 
-    /** @var float */
+    /** Cantidad total en stock para el proyecto. @var float */
     public $cantidad;
 
-    /** @var float */
+    /** Cantidad disponible (cantidad menos reservada). @var float */
     public $disponible;
 
-    /** @var int */
+    /** Identificador del registro. @var int */
     public $id;
 
-    /** @var int */
+    /** Identificador del producto. @var int */
     public $idproducto;
 
-    /** @var int */
+    /** Identificador del proyecto. @var int */
     public $idproyecto;
 
-    /** @var float */
+    /** Cantidad pendiente de recibir. @var float */
     public $pterecibir;
 
-    /** @var string */
+    /** Referencia de la variante del producto. @var string */
     public $referencia;
 
-    /** @var float */
+    /** Cantidad reservada para el proyecto. @var float */
     public $reservada;
 
     public function clear(): void

Model/TareaProyecto.php

@@ -40,34 +40,34 @@ class TareaProyecto extends ModelClass
     const TYPE_PROCESSING = 2;
     const TYPE_CANCELED = 1;
 
-    /** @var int */
+    /** Cantidad de unidades asociadas a la tarea. @var int */
     public $cantidad;
 
-    /** @var string */
+    /** Descripción de la tarea. @var string */
     public $descripcion;
 
-    /** @var string */
+    /** Fecha de creación de la tarea. @var string */
     public $fecha;
 
-    /** @var string */
+    /** Fecha de finalización de la tarea. @var string */
     public $fechafin;
 
-    /** @var string */
+    /** Fecha de inicio de la tarea. @var string */
     public $fechainicio;
 
-    /** @var int */
+    /** Identificador de la fase en la que se encuentra la tarea. @var int */
     public $idfase;
 
-    /** @var int */
+    /** Identificador del proyecto al que pertenece la tarea. @var int */
     public $idproyecto;
 
-    /** @var int */
+    /** Identificador de la tarea. @var int */
     public $idtarea;
 
-    /** @var string */
+    /** Nombre de la tarea. @var string */
     public $nombre;
 
-    /** @var string */
+    /** Nick del usuario asignado a la tarea. @var string */
     public $nick;
 
     public function clear(): void

Model/UserProyecto.php

@@ -35,21 +35,29 @@ class UserProyecto extends ModelClass
     use ModelTrait;
 
     /**
+     * Fecha en la que el usuario se asigna al proyecto.
+     *
      * @var string
      */
     public $fecha;
 
     /**
+     * Identificador del registro.
+     *
      * @var integer
      */
     public $id;
 
     /**
+     * Identificador del proyecto.
+     *
      * @var integer
      */
     public $idproyecto;
 
     /**
+     * Nick del usuario asignado al proyecto.
+     *
      * @var string
      */
     public $nick;