README

This package is part of the Homeful ecosystem and represents a robust Eloquent-based product model for real estate or housing-related systems. It supports a wide range of property and product-related fields and implements the ProductInterface.

📦 Product Model Overview

The Product model captures both core product identity and extended metadata such as property location, pricing, appraisal, and requirements using the SchemalessAttributes via the meta field.

✅ Implements:

• ProductInterface
• Supports price casting using Whitecube\Price
• Configurable with Laravel's environment and configuration system

🧩 Traits Used

HasAdditionalAttributes

This trait defines metadata-backed accessors/mutators using the SchemalessAttributes package. Key functionalities include:

🔖 Property Metadata Fields

• Basic Fields: market_segment, location, destinations, directions, amenities, facade_url
• Property Info: project_location, project_code, property_name, phase, block, lot
• Dimensions: lot_area, floor_area, project_address
• Structure: property_type, unit_type, house_type
• Financials:
  • price
  • appraised_value
  • percent_down_payment
  • down_payment_term
  • percent_miscellaneous_fees
  • processing_fee
• Loan-Related:
  • balance_payment_interest_rate
  • balance_payment_term
  • mortgage_redemption_insurance_fee
  • income_requirement_multiplier
  • percent_gross_monthly_income
• Eligibility:
  • max_age
  • maximum_paying_age
• Status & Media:
  • status_code
  • key_location
  • digital_assets
  • phased_out

Each field is encapsulated via custom getXXXAttribute() and setXXXAttribute() accessors/mutators, backed by JSON metadata.

🏗️ Model Details

Key Properties

📥 Config Defaults (config/products.php)

return [
    'default' => [
        'processing_fee' => 10000,
        'percent_dp' => 0.10,       // 10%
        'dp_term' => 12,            // 12 months
        'percent_mf' => 0.085,      // 8.5%
    ],
];

🧪 Tests

Functional Coverage:

• Asserts all core and meta attributes are working as expected
• Verifies casting and type correctness (e.g., Price, float, int, string)
• Confirms that ProductData::fromModel() transformation works
• Tests updateOrCreate() and interface compliance

expect($product->getAppraisedValue()->equals($product->appraised_value))->toBeTrue();
expect($product->getPercentDownPayment())->toBe($product->percent_down_payment);

🧬 Data Transformation

ProductData

The ProductData class maps the Product model into a normalized, transport-ready DTO using Spatie Laravel Data:

$data = ProductData::fromModel($product);

Provides direct mapping to all relevant fields like:

• sku, name, brand, description, etc.
• Financial metrics and interest/multiplier values
• Metadata-rich project and unit identifiers

🏁 Conclusion

This package bridges the static nature of database tables and the flexibility needed for real estate product customization. By leveraging SchemalessAttributes, it ensures adaptability without schema bloat.

Behold, a new you awaits — in housing, and in code. 🏡✨