koprogo_api/domain/services/

owner_statement_exporter.rs

use crate::domain::entities::{Building, Expense, Owner, Unit};
use crate::domain::services::pdf_writer::{
    builtin_font, new_document, save_document, PdfPageBuilder,
};
use chrono::{DateTime, Utc};
use printpdf::BuiltinFont;
use rust_decimal::Decimal;

/// Owner Financial Statement Exporter - Generates PDF for Relevé de Charges
///
/// Generates statements showing an owner's expenses over a period.
///
/// MONETARY: ownership_percentage + sums use rust_decimal::Decimal (cf. ADR-0007).
pub struct OwnerStatementExporter;

#[derive(Debug, Clone)]
pub struct UnitWithOwnership {
    pub unit: Unit,
    pub ownership_percentage: Decimal, // 0.0 to 1.0
}

impl OwnerStatementExporter {
    /// Export owner financial statement to PDF bytes
    ///
    /// Generates a Relevé de Charges including:
    /// - Owner information
    /// - Period covered
    /// - Units owned with percentages
    /// - Expense breakdown by category
    /// - Payment status
    /// - Total due
    pub fn export_to_pdf(
        owner: &Owner,
        building: &Building,
        units: &[UnitWithOwnership],
        expenses: &[Expense],
        start_date: DateTime<Utc>,
        end_date: DateTime<Utc>,
    ) -> Result<Vec<u8>, String> {
        // Create PDF document (A4: 210mm x 297mm)
        let doc = new_document("Relevé de Charges");
        let mut current_layer = PdfPageBuilder::new();

        // Load fonts
        let font = builtin_font(BuiltinFont::Helvetica);
        let font_bold = builtin_font(BuiltinFont::HelveticaBold);

        let mut y = 270.0; // Start from top

        // === HEADER ===
        current_layer.text("RELEVÉ DE CHARGES".to_string(), 18.0, 20.0, y, &font_bold);
        y -= 15.0;

        // Building information
        current_layer.text(
            format!("Copropriété: {}", building.name),
            12.0,
            20.0,
            y,
            &font_bold,
        );
        y -= 7.0;

        current_layer.text(
            format!("Adresse: {}", building.address),
            10.0,
            20.0,
            y,
            &font,
        );
        y -= 10.0;

        // Period
        let period = format!(
            "Période: du {} au {}",
            start_date.format("%d/%m/%Y"),
            end_date.format("%d/%m/%Y")
        );
        current_layer.text(period, 10.0, 20.0, y, &font);
        y -= 10.0;

        // Owner information
        current_layer.text("COPROPRIÉTAIRE".to_string(), 14.0, 20.0, y, &font_bold);
        y -= 8.0;

        current_layer.text(
            format!("{} {}", owner.first_name, owner.last_name),
            11.0,
            20.0,
            y,
            &font,
        );
        y -= 6.0;

        current_layer.text(format!("Email: {}", owner.email), 10.0, 20.0, y, &font);
        y -= 6.0;

        if let Some(ref phone) = owner.phone {
            current_layer.text(format!("Téléphone: {}", phone), 10.0, 20.0, y, &font);
            y -= 6.0;
        }
        y -= 5.0;

        // === UNITS OWNED ===
        current_layer.text("LOTS DÉTENUS".to_string(), 14.0, 20.0, y, &font_bold);
        y -= 8.0;

        current_layer.text("Lot", 10.0, 20.0, y, &font_bold);
        current_layer.text("Étage", 10.0, 60.0, y, &font_bold);
        current_layer.text("Surface", 10.0, 90.0, y, &font_bold);
        current_layer.text("Quote-part", 10.0, 130.0, y, &font_bold);
        y -= 6.0;

        for unit_info in units {
            if y < 100.0 {
                // Reserve space for totals
                break;
            }

            current_layer.text(unit_info.unit.unit_number.as_str(), 9.0, 20.0, y, &font);

            if let Some(floor) = unit_info.unit.floor {
                current_layer.text(floor.to_string(), 9.0, 60.0, y, &font);
            }

            current_layer.text(
                format!("{:.2} m²", unit_info.unit.surface_area),
                9.0,
                90.0,
                y,
                &font,
            );

            current_layer.text(
                format!(
                    "{:.2}%",
                    unit_info.ownership_percentage * rust_decimal_macros::dec!(100)
                ),
                9.0,
                130.0,
                y,
                &font,
            );
            y -= 5.0;
        }
        y -= 8.0;

        // === EXPENSES ===
        current_layer.text("DÉTAIL DES CHARGES".to_string(), 14.0, 20.0, y, &font_bold);
        y -= 8.0;

        current_layer.text("Date", 10.0, 20.0, y, &font_bold);
        current_layer.text("Description", 10.0, 50.0, y, &font_bold);
        current_layer.text("Montant", 10.0, 140.0, y, &font_bold);
        current_layer.text("Statut", 10.0, 170.0, y, &font_bold);
        y -= 6.0;

        let mut total_amount = Decimal::ZERO;
        let mut total_paid = Decimal::ZERO;

        for expense in expenses {
            if y < 50.0 {
                // Reserve space for footer
                break;
            }

            current_layer.text(
                expense.expense_date.format("%d/%m/%Y").to_string(),
                9.0,
                20.0,
                y,
                &font,
            );

            let description = if expense.description.len() > 30 {
                format!("{}...", &expense.description[..30])
            } else {
                expense.description.clone()
            };
            current_layer.text(description, 9.0, 50.0, y, &font);

            current_layer.text(format!("{:.2} €", expense.amount), 9.0, 140.0, y, &font);

            let status = if expense.is_paid() {
                "Payée"
            } else {
                "En attente"
            };
            current_layer.text(status.to_string(), 9.0, 170.0, y, &font);

            total_amount += expense.amount;
            if expense.is_paid() {
                total_paid += expense.amount;
            }

            y -= 5.0;
        }
        y -= 10.0;

        // === SUMMARY ===
        current_layer.text("RÉCAPITULATIF".to_string(), 14.0, 20.0, y, &font_bold);
        y -= 8.0;

        current_layer.text(
            format!("Total des charges: {:.2} €", total_amount),
            11.0,
            20.0,
            y,
            &font,
        );
        y -= 6.0;

        current_layer.text(
            format!("Montant payé: {:.2} €", total_paid),
            11.0,
            20.0,
            y,
            &font,
        );
        y -= 6.0;

        let amount_due = total_amount - total_paid;
        current_layer.text(
            format!("Montant dû: {:.2} €", amount_due),
            12.0,
            20.0,
            y,
            &font_bold,
        );
        y -= 10.0;

        // Payment instructions
        if amount_due > Decimal::ZERO {
            current_layer.text(
                "Modalités de paiement:".to_string(),
                10.0,
                20.0,
                y,
                &font_bold,
            );
            y -= 6.0;

            current_layer.text(
                "Merci d'effectuer votre paiement par virement bancaire".to_string(),
                9.0,
                20.0,
                y,
                &font,
            );
            y -= 5.0;

            current_layer.text(
                "avec la référence suivante en communication.".to_string(),
                9.0,
                20.0,
                y,
                &font,
            );
        }

        // Save to bytes
        let page = current_layer.into_page(210.0, 297.0);
        Ok(save_document(doc, page))
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::domain::entities::ExpenseCategory;
    use uuid::Uuid;

    #[test]
    fn test_export_owner_statement_pdf() {
        let owner = Owner {
            id: Uuid::new_v4(),
            organization_id: Uuid::new_v4(),
            user_id: None,
            first_name: "Jean".to_string(),
            last_name: "Dupont".to_string(),
            email: "jean@example.com".to_string(),
            phone: Some("+32 2 123 45 67".to_string()),
            address: "123 Rue de Test".to_string(),
            city: "Bruxelles".to_string(),
            postal_code: "1000".to_string(),
            country: "Belgium".to_string(),
            created_at: Utc::now(),
            updated_at: Utc::now(),
        };

        let building = Building {
            id: Uuid::new_v4(),
            name: "Les Jardins de Bruxelles".to_string(),
            address: "123 Avenue Louise".to_string(),
            city: "Bruxelles".to_string(),
            postal_code: "1000".to_string(),
            country: "Belgium".to_string(),
            total_units: 10,
            total_tantiemes: 1000,
            construction_year: Some(1990),
            syndic_name: None,
            syndic_email: None,
            syndic_phone: None,
            syndic_address: None,
            syndic_office_hours: None,
            syndic_emergency_contact: None,
            slug: None,
            acp_id: Uuid::new_v4(),
            created_at: Utc::now(),
            updated_at: Utc::now(),
        };

        let unit = Unit {
            id: Uuid::new_v4(),
            acp_id: building.acp_id,
            building_id: building.id,
            unit_number: "A1".to_string(),
            unit_type: crate::domain::entities::UnitType::Apartment,
            floor: Some(1),
            surface_area: 75.5,
            quota: rust_decimal_macros::dec!(150),
            owner_id: None,
            created_at: Utc::now(),
            updated_at: Utc::now(),
        };

        let units = vec![UnitWithOwnership {
            unit,
            ownership_percentage: rust_decimal_macros::dec!(0.15), // 15%
        }];

        let expenses = vec![Expense {
            id: Uuid::new_v4(),
            acp_id: Uuid::new_v4(),
            building_id: building.id,
            organization_id: owner.organization_id,
            description: "Entretien ascenseur".to_string(),
            amount: rust_decimal_macros::dec!(150),
            amount_excl_vat: Some(rust_decimal_macros::dec!(123.97)),
            vat_rate: Some(rust_decimal_macros::dec!(21)),
            vat_amount: Some(rust_decimal_macros::dec!(26.03)),
            amount_incl_vat: Some(rust_decimal_macros::dec!(150)),
            expense_date: Utc::now(),
            invoice_date: None,
            due_date: None,
            paid_date: None,
            category: ExpenseCategory::Maintenance,
            approval_status: crate::domain::entities::ApprovalStatus::Approved,
            submitted_at: None,
            approved_by: None,
            approved_at: None,
            rejection_reason: None,
            payment_status: crate::domain::entities::PaymentStatus::Pending,
            supplier: None,
            invoice_number: Some("INV-001".to_string()),
            account_code: None,
            created_at: Utc::now(),
            updated_at: Utc::now(),
            contractor_report_id: None,
        }];

        let result = OwnerStatementExporter::export_to_pdf(
            &owner,
            &building,
            &units,
            &expenses,
            Utc::now() - chrono::Duration::days(30),
            Utc::now(),
        );

        assert!(result.is_ok());
        let pdf_bytes = result.unwrap();
        assert!(!pdf_bytes.is_empty());
        assert!(pdf_bytes.len() > 100);
    }
}