Project
Un proyecto agrupa las carpetas, las cotizaciones y los centros de costo de una obra o servicio de un cliente. Se crea a mano o, de forma automática, cuando se cierra una cotización de una oportunidad.
| Modelo | App\Models\Project |
| Tabla | projects |
El objeto Project
Sección titulada «El objeto Project»Atributos
Sección titulada «Atributos»idintegerIdentificador del proyecto.
customer_idintegerCliente del proyecto.
opportunity_idintegerOportunidad de la que nace el proyecto. Solo la llena el flujo de cierre de cotizaciones; el endpoint de crear no la recibe.
namestringNombre del proyecto.
descriptionstringDescripción del proyecto.
start_datedateFecha de inicio.
end_datedateFecha de fin.
investmentnumberInversión total. Al crear por el endpoint se calcula como la suma de los montos de los subcentros de costo. Al cerrar cotizaciones se suma el total de cada cotización.
codestringCódigo del proyecto. Lo genera el sistema al crear (mes de dos dígitos y correlativo de cuatro dígitos).
duration_typestringTipo de duración. Existe en la tabla, pero ningún endpoint de proyectos lo recibe.
project_manager_idintegerUsuario gerente del proyecto.
seller_idintegerUsuario vendedor.
comercial_conditionsarrayCondiciones comerciales. Se castea a arreglo.
cost_center_type_idintegerTipo de centro de costo del proyecto. Al cambiarlo se actualiza en todos sus centros de costo.
warehouse_idintegerAlmacén temporal asignado al proyecto (inventario). Es un atajo de lectura; la dirección principal es warehouses.project_id.
statusstringEstado del registro (ModelStatusEnum). Un proyecto nuevo queda en activo; al eliminarlo 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": 1, "customer_id": 5, "opportunity_id": 12, "name": "Instalación eléctrica Planta Norte", "description": "Instalación de tableros y cableado", "start_date": "2026-11-02T00:00:00.000000Z", "end_date": "2027-11-02T00:00:00.000000Z", "investment": 300000, "code": "110001", "duration_type": null, "project_manager_id": 3, "seller_id": 4, "comercial_conditions": null, "cost_center_type_id": 2, "warehouse_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 con la cotización aprobada
Sección titulada «Relación con la cotización aprobada»El proyecto no se crea a partir de un estado aprobado. Según el código, nace cuando una cotización de la oportunidad pasa al estado cerrado. Hay dos puertas de entrada y ambas ejecutan la misma lógica (createProjectFromQuotation):
- Al mover una cotización a
cerradoen el flujo de la cotización (QuotationWorkflowController). - Al cerrar la oportunidad con
POST /api/opportunity-workflow/close/quotation(OpportunityWorkflowController::closeOpportunityWorkflow), que cierra cada cotización indicada.
Reglas de ese flujo:
- Hay un solo proyecto por oportunidad (
opportunity_id). Si ya existe, no se crea otro: se suma el total de la cotización ainvestment. - Si no existe, se crea con el título y la descripción de la oportunidad como nombre y descripción, el cliente, el gerente y el vendedor de la cotización,
codegenerado por el sistema,start_dateyend_dateiguales a la fecha actual,investmentigual al total de la cotización y estadoactivo. - El tipo de centro de costo sale de la cotización. Si no lo tiene, se usa el primer tipo con
is_for_projectverdadero y, si no hay, el primer tipo existente. Sin ningún tipo responde422conNo se encontró un tipo de centro de costo. Por favor, crea uno primero. - La cotización guarda el proyecto en
quotations.project_idy las carpetas de presupuesto de la cotización reciben el mismoproject_id. Las demás versiones de la cotización se descartan.
El modelo Project no declara la relación inversa hacia las cotizaciones; se consultan por quotations.project_id o por las carpetas del proyecto.
Relación con el centro de costos
Sección titulada «Relación con el centro de costos»Un proyecto tiene muchos centros de costo (cost_centers.project_id).
- Al crear un proyecto con
POST /api/projectse crea un centro de costo padre con el nombre, las fechas, el tipo de centro y la inversión del proyecto, y seis subcentros por defecto:materiales,mano de obra,equipo y herramientas,subcontratos,gastos generalesycaja chica. Cada subcentro recibe el monto enviado encost_centers; si falta, se usa50000. El presupuesto del padre se recalcula como la suma de sus subcentros. Los centros se crean con la moneda predeterminada (o la primera moneda existente). - El flujo de cierre de cotizaciones crea el proyecto sin centros de costo.
- Si cambia
cost_center_type_idal actualizar, todos los centros de costo del proyecto reciben el nuevo tipo. - Al eliminar el proyecto se eliminan sus centros de costo, salvo que alguno tenga movimientos de caja activos: en ese caso la operación se revierte y responde
422. - Al restaurar el proyecto se restauran sus centros de costo eliminados.
Estados
Sección titulada «Estados»El proyecto usa ModelStatusEnum en la columna status. El código solo asigna dos valores: activo al crear (por el endpoint o por el cierre de cotizaciones) y eliminado al eliminar; al restaurar vuelve al estado anterior (previous_status). No existe un enum de estados propio del proyecto ni un endpoint para cambiar el estado.
Relaciones
Sección titulada «Relaciones»Se cargan con el parámetro relations. El modelo no define allowedRelations, así que se admite cualquier relación pública, salvo tokens y notifications.
| Relación | Tipo | Modelo |
|---|---|---|
customer |
belongsTo | Customer |
opportunity |
belongsTo | Opportunity |
warehouse |
belongsTo | Warehouse |
projectManager |
belongsTo | User |
seller |
belongsTo | User |
costCenterType |
belongsTo | CostCenterType |
costCenters |
hasMany | CostCenter |
rootCostCenter |
hasOne | CostCenter (el que no tiene padre) |
projectFolders |
hasMany | ProjectFolder |
projectFolderSingles |
hasMany | ProjectFolder (carpetas sin padre) |
projectFolderParents |
hasMany | ProjectFolder (carpetas sin padre) |
investmentProjects |
hasMany | InvestmentProject |
investments |
belongsToMany | Investment (tabla investment_projects) |
createUser, updateUser, deleteUser, restoreUser |
belongsTo | User |
Conteos
Sección titulada «Conteos»El modelo no define allowedCountRelations: count_relations no tiene efecto.
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 y filtros
Sección titulada «Búsqueda y filtros»searchcompara con las columnasnameycode.filtersadmite los campos terminados en_idque están en$fillable:customer_id,opportunity_id,project_manager_id,seller_id,cost_center_type_idywarehouse_id, además de los camposcreate_user_id,update_user_id,delete_user_idyrestore_user_id.
ModelStatusEnum: estado del proyecto (ver arriba).ProjectCostCenterDefaultNameEnum: nombres válidos de los subcentros al crear:materiales,mano de obra,equipo y herramientas,subcontratos,gastos generales,caja chica.
