Processing Sales

tipo_operacion: 'venta' | 'separacion'

// Required fields
documento: string
tipo_documento: 'CC' | 'CE' | 'NIT' | 'Pasaporte'
nombre: string
apellido: string
telefono: string
email: email
tipo_cliente: 'Natural' | 'Jurídica'

// Backend filtering
$apartamentos = Apartamento::with(['torre.proyecto', 'estadoInmueble'])
    ->whereHas('estadoInmueble', fn($q) => $q->where('nombre', 'Disponible'))
    ->get();

id_parqueadero: nullable|exists:parqueaderos,id_parqueadero

$valorTotal = $valorBaseInmueble + $precioParqueadero

valor_separacion: number              // Deposit amount
fecha_limite_separacion: date         // Deadline (max: plazo_max_separacion_dias)

$valorSeparacion >= $proyecto->valor_min_separacion
$fechaLimite <= today()->addDays($proyecto->plazo_max_separacion_dias)

cuota_inicial: number                 // Down payment amount
plazo_cuota_inicial_meses: integer    // Term (1 to proyecto.plazo_cuota_inicial_meses)
frecuencia_cuota_inicial_meses: integer // Payment frequency
id_forma_pago: integer                // Payment method

// Only divisors of plazo are valid
const opcionesFrecuencia = computed(() => {
  const plazo = Number(form.plazo_cuota_inicial_meses)
  return frecuenciasDisponibles.filter(f => plazo % f.valor === 0)
})

// Example: plazo = 12 months
// Valid: 1 (monthly), 2 (bimonthly), 3 (quarterly), 4, 6 (semiannual), 12 (annual)

$porcentajeMinimo = $proyecto->porcentaje_cuota_inicial_min
$cuotaMinimaRequerida = $valorTotal * ($porcentajeMinimo / 100)

if ($cuotaInicial < $cuotaMinimaRequerida) {
    throw ValidationException::withMessages([
        'cuota_inicial' => "Mínimo {$porcentajeMinimo}%"
    ]);
}

// Base property price
valor_base = inmueble.valor_final || inmueble.valor_total

// Add parking if selected
valor_total = valor_base + (parqueadero?.precio || 0)

// For ventas: calculate balance
valor_restante = valor_total - cuota_inicial

// Down payment percentage
porcentaje = (cuota_inicial / valor_total) * 100

descripcion: 'nullable|max:300'

// VentaWebController::store
DB::transaction(function () use ($validated) {
    // 1. Validate and create venta record
    $venta = $this->ventaService->crearOperacion($validated);
    
    // 2. Update property state
    $inmueble->update([
        'id_estado_inmueble' => $estadoDestino // "Separado" or "Vendido"
    ]);
    
    // 3. Reserve parking (if applicable)
    if ($id_parqueadero && $id_apartamento) {
        Parqueadero::where('id_parqueadero', $id_parqueadero)
            ->update(['id_apartamento' => $id_apartamento]);
    }
    
    // 4. Generate payment plan (for ventas)
    if ($tipo_operacion === 'venta') {
        $this->ventaService->regenerarPlanCuotaInicial($venta);
    }
    
    // 5. Recalculate project pricing
    app(PriceEngine::class)->recalcularProyectoPorVenta($venta);
});

id_forma_pago: integer                // Payment method
cuota_inicial: numeric                // Total down payment (>= separacion)
plazo_cuota_inicial_meses: integer
frecuencia_cuota_inicial_meses: integer
descripcion: string (optional)
id_parqueadero: integer (optional)    // Can add/change parking

$cuotaInicial >= $venta->valor_separacion

// VentaWebController::convertirStore
DB::transaction(function () use ($validated, $venta) {
    // Update venta record
    $venta->update([
        'tipo_operacion' => 'venta',
        'fecha_limite_separacion' => null,
        'estado_operacion' => 'convertida',
        'cuota_inicial' => $validated['cuota_inicial'],
        'plazo_cuota_inicial_meses' => $validated['plazo_cuota_inicial_meses'],
        'frecuencia_cuota_inicial_meses' => $validated['frecuencia_cuota_inicial_meses'],
        'valor_restante' => $valorTotal - $validated['cuota_inicial'],
        'valor_separacion' => null,
    ]);
    
    // Update property state
    $inmueble->update([
        'id_estado_inmueble' => EstadoInmueble::where('nombre', 'Vendido')->first()->id
    ]);
    
    // Handle parking reassignment if changed
    if ($newParqueaderoId !== $oldParqueaderoId) {
        // Release old, assign new
    }
    
    // Generate payment plan
    app(VentaService::class)->regenerarPlanCuotaInicial($venta);
    
    // Recalculate pricing
    app(PriceEngine::class)->recalcularProyectoPorVenta($venta);
});

// VentaWebController::cancelarSeparacion

// 1. Release property
$inmueble->update([
    'id_estado_inmueble' => EstadoInmueble::where('nombre', 'Disponible')->first()->id
]);

// 2. Release parking
if ($venta->id_parqueadero) {
    Parqueadero::where('id_parqueadero', $venta->id_parqueadero)
        ->update(['id_apartamento' => null]);
}

// 3. Delete venta record
$venta->delete();

// 4. Recalculate pricing
app(PriceEngine::class)->recalcularProyecto($proyecto);

// VentaWebController::update
DB::transaction(function () use ($validated, $venta) {
    // Update venta
    $venta->update($validated);
    
    // Recalculate totals
    $venta->valor_total = $valorBase + $precioParqueadero;
    $venta->valor_restante = $venta->valor_total - $venta->cuota_inicial;
    $venta->save();
    
    // Regenerate payment plan (if plazo/frecuencia changed)
    if ($venta->tipo_operacion === 'venta') {
        $plan = $venta->planAmortizacion;
        if ($plan) {
            $plan->cuotas()->delete();
            $plan->delete();
        }
        app(VentaService::class)->regenerarPlanCuotaInicial($venta);
    }
    
    // Recalculate pricing
    app(PriceEngine::class)->recalcularProyectoPorVenta($venta);
});

// Loaded with sale
$venta->load(['planAmortizacion.cuotas', 'pagos']);

fecha_pago: date
monto: numeric
medio_pago: integer      // Transfer, Cash, Check, Card
concepto_pago: integer   // Down payment, Monthly, etc.
numero_recibo: string
observaciones: text

// Create payment record
Pago::create($data);

// Update cuota status
$cuota->update(['estado' => 'pagada']);

// Recalculate sale balance if needed

// VentaWebController::destroy
DB::transaction(function () use ($venta) {
    // Release property
    $inmueble = $venta->apartamento ?? $venta->local;
    if ($inmueble) {
        $inmueble->update([
            'id_estado_inmueble' => 1 // Disponible
        ]);
    }
    
    // Release parking
    if ($venta->id_parqueadero) {
        app(VentaService::class)->liberarParqueaderoDeApartamento(
            $venta->id_parqueadero,
            $venta->id_apartamento
        );
    }
    
    // Delete venta (cascades to plan/cuotas)
    $venta->delete();
    
    // Recalculate pricing
    app(PriceEngine::class)->recalcularProyecto($proyecto);
});