Financial Management

class Pago extends Model
{
    protected $table = 'pagos';
    protected $primaryKey = 'id_pago';
    
    protected $fillable = [
        'fecha',                // Payment date
        'id_venta',             // Related sale
        'referencia_pago',      // Payment reference/transaction ID
        'id_concepto_pago',     // Payment concept
        'id_medio_pago',        // Payment method
        'descripcion',          // Description/notes
        'valor',                // Amount
        'id_cuota',            // Related installment (if applicable)
    ];
    
    protected $casts = [
        'fecha' => 'datetime',
        'valor' => 'decimal:2',
    ];
    
    public function venta()
    {
        return $this->belongsTo(Venta::class, 'id_venta');
    }
    
    public function conceptoPago()
    {
        return $this->belongsTo(ConceptoPago::class, 'id_concepto_pago');
    }
    
    public function medioPago()
    {
        return $this->belongsTo(MedioPago::class, 'id_medio_pago');
    }
}

class MedioPago extends Model
{
    // Common payment methods:
    // - Efectivo (Cash)
    // - Transferencia (Bank transfer)
    // - Cheque (Check)
    // - Tarjeta de Crédito (Credit card)
    // - Consignación (Bank deposit)
}

class PlanAmortizacionVenta extends Model
{
    protected $table = 'planes_amortizacion_venta';
    protected $primaryKey = 'id_plan';
    
    protected $fillable = [
        'id_venta',
        'tipo_plan',              // 'cuota_inicial' or 'financiacion'
        'valor_interes_anual',    // Annual interest rate
        'plazo_meses',            // Term in months
        'fecha_inicio',           // Start date
        'observacion',            // Notes
    ];
    
    protected $casts = [
        'fecha_inicio' => 'date',
        'valor_interes_anual' => 'decimal:2',
    ];
    
    public function venta()
    {
        return $this->belongsTo(Venta::class, 'id_venta');
    }
    
    public function cuotas()
    {
        return $this->hasMany(PlanAmortizacionCuota::class, 'id_plan');
    }
}

class PlanAmortizacionCuota extends Model
{
    protected $table = 'planes_amortizacion_cuota';
    protected $primaryKey = 'id_cuota';
    
    protected $fillable = [
        'id_plan',
        'numero_cuota',           // Installment number (1, 2, 3...)
        'fecha_vencimiento',      // Due date
        'valor_cuota',            // Installment amount
        'saldo_pendiente',        // Remaining balance after this payment
        'estado',                 // 'pendiente', 'pagada', 'vencida'
    ];
    
    protected $casts = [
        'fecha_vencimiento' => 'date',
        'valor_cuota' => 'decimal:2',
        'saldo_pendiente' => 'decimal:2',
    ];
}

public function regenerarPlanCuotaInicial($venta)
{
    // Delete existing plan
    if ($plan = $venta->planAmortizacion) {
        $plan->cuotas()->delete();
        $plan->delete();
    }
    
    // Calculate down payment details
    $cuotaInicial = (float)($venta->cuota_inicial ?? 0);
    $valorSeparacion = (float)($venta->valor_separacion ?? 0);
    $proyecto = $venta->proyecto;
    $valorMinSep = (float)($proyecto->valor_min_separacion ?? 0);
    
    // Amount to amortize = down payment - separation
    $montoAmortizar = $cuotaInicial - max($valorSeparacion, $valorMinSep);
    
    if ($montoAmortizar <= 0) {
        return; // Nothing to amortize
    }
    
    $plazo = (int)($venta->plazo_cuota_inicial_meses ?? 1);
    $frecuencia = (int)($venta->frecuencia_cuota_inicial_meses ?? 1);
    
    // Create plan
    $plan = PlanAmortizacionVenta::create([
        'id_venta' => $venta->id_venta,
        'tipo_plan' => 'cuota_inicial',
        'valor_interes_anual' => 0, // No interest on down payments
        'plazo_meses' => $plazo,
        'fecha_inicio' => $venta->fecha_venta,
    ]);
    
    // Calculate number of payments
    $numPagos = (int)ceil($plazo / $frecuencia);
    $cuotaBase = floor($montoAmortizar / $numPagos);
    $residuo = $montoAmortizar - ($cuotaBase * $numPagos);
    
    // Generate installments
    $fechaPago = Carbon::parse($venta->fecha_venta)->addMonths($frecuencia);
    $saldoPendiente = $montoAmortizar;
    
    for ($i = 1; $i <= $numPagos; $i++) {
        $valorCuota = $cuotaBase;
        
        // Add residue to last payment
        if ($i === $numPagos) {
            $valorCuota += $residuo;
        }
        
        $saldoPendiente -= $valorCuota;
        
        PlanAmortizacionCuota::create([
            'id_plan' => $plan->id_plan,
            'numero_cuota' => $i,
            'fecha_vencimiento' => $fechaPago->copy(),
            'valor_cuota' => $valorCuota,
            'saldo_pendiente' => max(0, $saldoPendiente),
            'estado' => 'pendiente',
        ]);
        
        $fechaPago->addMonths($frecuencia);
    }
}

class PoliticaComision extends Model
{
    protected $table = 'politicas_comision';
    protected $primaryKey = 'id_politica_comision';
    
    protected $fillable = [
        'id_proyecto',
        'aplica_a',             // 'asesor', 'director', etc.
        'base_calculo',         // 'valor_venta', 'cuota_inicial', etc.
        'porcentaje',           // Commission percentage
        'valor_fijo',           // Fixed commission amount (if applicable)
        'minimo_venta_estado',  // Minimum sale state required
        'descripcion',          // Description
        'vigente_desde',        // Effective from date
        'vigente_hasta',        // Effective until date
    ];
    
    protected $casts = [
        'vigente_desde' => 'date',
        'vigente_hasta' => 'date',
        'porcentaje' => 'decimal:3',
        'valor_fijo' => 'decimal:2',
    ];
    
    public function proyecto()
    {
        return $this->belongsTo(Proyecto::class, 'id_proyecto');
    }
}

// Sales advisor commission
$politicaAsesor = PoliticaComision::where('id_proyecto', $venta->id_proyecto)
    ->where('aplica_a', 'asesor')
    ->where('vigente_desde', '<=', $venta->fecha_venta)
    ->where(function ($q) use ($venta) {
        $q->whereNull('vigente_hasta')
          ->orWhere('vigente_hasta', '>=', $venta->fecha_venta);
    })
    ->first();

if ($politicaAsesor) {
    if ($politicaAsesor->porcentaje) {
        $comision = $venta->valor_total * ($politicaAsesor->porcentaje / 100);
    } else {
        $comision = $politicaAsesor->valor_fijo;
    }
}

public function planPagosCI(array $filtros, Carbon $desde, Carbon $hasta): array
{
    $ventas = Venta::with(['proyecto', 'apartamento', 'local', 'cliente'])
        ->where('tipo_operacion', 'venta')
        ->whereBetween('fecha_venta', [$desde, $hasta])
        ->get();
    
    // Generate month columns based on sale terms
    $encabezados = [];
    $filas = [];
    $totales = [];
    
    foreach ($ventas as $v) {
        $plazo = max(1, (int)($v->plazo_cuota_inicial_meses ?? 1));
        $frecuencia = max(1, (int)($v->frecuencia_cuota_inicial_meses ?? 1));
        
        $fechaBase = Carbon::parse($v->fecha_venta)->startOfMonth();
        $numPagos = (int)ceil($plazo / $frecuencia);
        
        // Month 0: Separation
        $mes0 = $fechaBase->format('Y-m');
        $separacion = (float)($v->valor_min_separacion ?? 0);
        
        // Months 1-N: Down payment installments
        $cuotaInicial = (float)($v->cuota_inicial ?? 0);
        $saldoAmortizar = max(0, $cuotaInicial - $separacion);
        $cuotaPorPago = $numPagos > 0 ? floor($saldoAmortizar / $numPagos) : 0;
        
        // Month N+1: Remaining value (mortgage/financing)
        $valorRestante = (float)($v->valor_restante ?? 0);
    }
    
    return [
        'encabezados' => $encabezados,
        'filas' => $filas,
        'totales' => $totales,
    ];
}

class FormaPago extends Model
{
    // Common payment forms:
    // - Contado (Cash/immediate)
    // - Cuota Inicial + Financiación (Down payment + financing)
    // - Subsidio (Government subsidy)
    // - Leasing
    // - Other custom forms
}

public function registrarPago(Request $request)
{
    $validated = $request->validate([
        'id_venta' => 'required|exists:ventas,id_venta',
        'fecha' => 'required|date',
        'valor' => 'required|numeric|min:0',
        'id_concepto_pago' => 'required|exists:conceptos_pago,id_concepto_pago',
        'id_medio_pago' => 'required|exists:medios_pago,id_medio_pago',
        'referencia_pago' => 'nullable|string|max:100',
        'id_cuota' => 'nullable|exists:planes_amortizacion_cuota,id_cuota',
        'descripcion' => 'nullable|string|max:300',
    ]);
    
    $pago = Pago::create($validated);
    
    // Update installment status if linked
    if ($pago->id_cuota) {
        $cuota = PlanAmortizacionCuota::find($pago->id_cuota);
        $cuota->update(['estado' => 'pagada']);
    }
    
    return redirect()
        ->route('ventas.show', $validated['id_venta'])
        ->with('success', 'Pago registrado exitosamente');
}