Ir al contenido

Category

Una categoría clasifica los productos y se organiza en un árbol de hasta tres niveles. Una categoría raíz tiene category_father_id en null y level igual a 1. Es un catálogo de la pantalla Categorías de la configuración de Ventas.

Modelo App\Models\Category
Tabla categories
idinteger

Identificador de la categoría.

namestring

Nombre de la categoría. Es único.

descriptionstring

Descripción. Es opcional.

imagestring

Ruta de la imagen de la categoría.

thumbnailstring

Ruta de la miniatura de la categoría.

levelinteger

Nivel en el árbol. Lo calcula el servidor al crear: 1 si no tiene padre, o el nivel del padre más uno. El máximo es 3.

category_father_idinteger

Categoría padre. Es null en una categoría raíz.

statusstring

Estado del registro (ModelStatusEnum). Se asigna al crear.

previous_statusstring

Estado anterior. Lo llena el sistema al eliminar o restaurar.

status_update_commentstring

Comentario del último cambio de estado.

status_update_datedatetime

Fecha del último cambio de estado.

status_update_user_idinteger

Usuario que hizo el último cambio de estado.

create_user_idinteger

Usuario que creó el registro. Se asigna automáticamente.

update_user_idinteger

Usuario que hizo la última modificación.

delete_user_idinteger

Usuario que eliminó el registro.

restore_user_idinteger

Usuario que restauró el registro.

created_atdatetime

Fecha de creación.

updated_atdatetime

Fecha de la última modificación.

deleted_atdatetime

Fecha de eliminación lógica.

El objeto Category200
{
"id": 1,
"name": "Cables",
"description": "Cables eléctricos",
"image": null,
"thumbnail": null,
"level": 1,
"category_father_id": null,
"status": "activo",
"previous_status": null,
"status_update_comment": null,
"status_update_date": null,
"status_update_user_id": null,
"create_user_id": 1,
"update_user_id": null,
"delete_user_id": null,
"restore_user_id": null,
"created_at": "2026-11-19T10:40:15.000000Z",
"updated_at": "2026-11-19T10:40:15.000000Z",
"deleted_at": null
}
Relación Tipo Modelo
categoryFather belongsTo Category
children hasMany Category
productCategories hasMany ProductCategory

Además, BaseModelTrait agrega createUser, updateUser, deleteUser y restoreUser (belongsTo User).

productCategories es la única relación que se admite en count_relations; expone product_categories_count, la cantidad de productos de la categoría.

CategoryController::index agrega dos filtros al listado: category_father_id (solo las hijas directas de esa categoría) y single_fathers (con el valor true, solo las categorías raíz).

El modelo no define $orderFields; se usan los campos por defecto: id, name, created_at, updated_at, status.

El modelo no define columnas de búsqueda, por lo que search no filtra por ninguna columna.

El estado usa ModelStatusEnum. Una categoría nueva queda en activo; al eliminarla pasa a eliminado.