Ir al contenido

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
idinteger

Identificador del proyecto.

customer_idinteger

Cliente del proyecto.

opportunity_idinteger

Oportunidad de la que nace el proyecto. Solo la llena el flujo de cierre de cotizaciones; el endpoint de crear no la recibe.

namestring

Nombre del proyecto.

descriptionstring

Descripción del proyecto.

start_datedate

Fecha de inicio.

end_datedate

Fecha de fin.

investmentnumber

Inversió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.

codestring

Código del proyecto. Lo genera el sistema al crear (mes de dos dígitos y correlativo de cuatro dígitos).

duration_typestring

Tipo de duración. Existe en la tabla, pero ningún endpoint de proyectos lo recibe.

project_manager_idinteger

Usuario gerente del proyecto.

seller_idinteger

Usuario vendedor.

comercial_conditionsarray

Condiciones comerciales. Se castea a arreglo.

cost_center_type_idinteger

Tipo de centro de costo del proyecto. Al cambiarlo se actualiza en todos sus centros de costo.

warehouse_idinteger

Almacén temporal asignado al proyecto (inventario). Es un atajo de lectura; la dirección principal es warehouses.project_id.

statusstring

Estado del registro (ModelStatusEnum). Un proyecto nuevo queda en activo; al eliminarlo pasa a eliminado.

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 Project200
{
"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
}

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 cerrado en 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 a investment.
  • 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, code generado por el sistema, start_date y end_date iguales a la fecha actual, investment igual al total de la cotización y estado activo.
  • El tipo de centro de costo sale de la cotización. Si no lo tiene, se usa el primer tipo con is_for_project verdadero y, si no hay, el primer tipo existente. Sin ningún tipo responde 422 con No se encontró un tipo de centro de costo. Por favor, crea uno primero.
  • La cotización guarda el proyecto en quotations.project_id y las carpetas de presupuesto de la cotización reciben el mismo project_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.

Un proyecto tiene muchos centros de costo (cost_centers.project_id).

  • Al crear un proyecto con POST /api/project se 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 generales y caja chica. Cada subcentro recibe el monto enviado en cost_centers; si falta, se usa 50000. 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_id al 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.

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.

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

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.

  • search compara con las columnas name y code.
  • filters admite los campos terminados en _id que están en $fillable: customer_id, opportunity_id, project_manager_id, seller_id, cost_center_type_id y warehouse_id, además de los campos create_user_id, update_user_id, delete_user_id y restore_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.