ProjectFolder
Una carpeta de proyecto organiza las cotizaciones de un proyecto. Puede tener hasta dos niveles: carpetas de primer nivel y subcarpetas.
| Modelo | App\Models\ProjectFolder |
| Tabla | project_folders |
El objeto ProjectFolder
Sección titulada «El objeto ProjectFolder»Atributos
Sección titulada «Atributos»idintegerIdentificador de la carpeta.
project_idintegerProyecto al que pertenece la carpeta.
namestringNombre de la carpeta.
descriptionstringDescripción de la carpeta.
project_folder_parent_idintegerCarpeta padre. Es nulo en las carpetas de primer nivel.
levelintegerNivel de la carpeta: 1 para las de primer nivel y 2 para las subcarpetas. Lo calcula el servidor desde la carpeta padre; no hay un tercer nivel.
statusstringEstado del registro (ModelStatusEnum). Una carpeta nueva queda en activo; al eliminarla pasa a eliminado.
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": 4, "project_id": 1, "name": "Cotizaciones de materiales", "description": "Carpeta de primer nivel", "project_folder_parent_id": null, "level": 1, "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»El modelo no define allowedRelations: se admite cualquier relación pública, salvo tokens y notifications.
| Relación | Tipo | Modelo |
|---|---|---|
project |
belongsTo | Project |
projectFolderParent |
belongsTo | ProjectFolder |
projectFolderChildren |
hasMany | ProjectFolder |
quotations |
hasMany | Quotation (solo las originales, sin reference_quotation_id) |
createUser, updateUser, deleteUser, restoreUser |
belongsTo | User |
| Scope | Qué hace |
|---|---|
scopeWhenProjectId |
Filtra por project_id |
scopeWhenProjectFolderParentId |
Filtra por project_folder_parent_id |
scopeParentOnly |
Deja solo las carpetas sin padre |
El modelo no define orderFields, así que rigen los campos por defecto: id, name, created_at, updated_at, status. El orden por defecto es id|DESC.
Búsqueda
Sección titulada «Búsqueda»El modelo no define searchConfiguration: el parámetro search no filtra nada.
Conteos
Sección titulada «Conteos»El modelo no define allowedCountRelations: count_relations no tiene efecto.
Estados
Sección titulada «Estados»Usa ModelStatusEnum. Una carpeta nueva queda en activo; al eliminarla pasa a eliminado. No hay ruta para restaurar carpetas.
