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 |
El objeto Category
Sección titulada «El objeto Category»Atributos
Sección titulada «Atributos»idintegerIdentificador de la categoría.
namestringNombre de la categoría. Es único.
descriptionstringDescripción. Es opcional.
imagestringRuta de la imagen de la categoría.
thumbnailstringRuta de la miniatura de la categoría.
levelintegerNivel 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_idintegerCategoría padre. Es null en una categoría raíz.
statusstringEstado del registro (ModelStatusEnum). Se asigna al crear.
previous_statusstringEstado anterior. Lo llena el sistema al eliminar o restaurar.
status_update_commentstringComentario del último cambio de estado.
status_update_datedatetimeFecha del último cambio de estado.
status_update_user_idintegerUsuario que hizo el último cambio de estado.
create_user_idintegerUsuario que creó el registro. Se asigna automáticamente.
update_user_idintegerUsuario que hizo la última modificación.
delete_user_idintegerUsuario que eliminó el registro.
restore_user_idintegerUsuario que restauró el registro.
created_atdatetimeFecha de creación.
updated_atdatetimeFecha de la última modificación.
deleted_atdatetimeFecha de eliminación lógica.
{ "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}Relaciones
Sección titulada «Relaciones»| 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.
Filtros propios
Sección titulada «Filtros propios»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.
Búsqueda
Sección titulada «Búsqueda»El modelo no define columnas de búsqueda, por lo que search no filtra por ninguna columna.
Estados
Sección titulada «Estados»El estado usa ModelStatusEnum. Una categoría nueva queda en activo; al eliminarla pasa a eliminado.
