Lead Summaries
==============

Lead summaries are staff handoffs. They should report confirmed requirements,
real matching properties, and honest no-match guidance.

.. autofunction:: app.alba_core.leads.build_lead_summary

.. autofunction:: app.alba_core.leads.money

Example
-------

.. code-block:: python

   from app.alba_core.leads import build_lead_summary
   from app.alba_core.matching import PropertyMatcher
   from app.alba_core.models import RentalRequirements
   from app.propertyme.cache import load_property_cache

   properties = load_property_cache("data/propertyme_property_seed_latest.json")
   requirements = RentalRequirements(city="Auckland", budget_max=5000, bedrooms_min=4)
   matches = PropertyMatcher(top_n=3).match(requirements, properties).matches

   summary = build_lead_summary(requirements, matches)
   print(summary)

No-match example
----------------

.. code-block:: python

   summary = build_lead_summary(
       RentalRequirements(city="Auckland", budget_max=100, bedrooms_min=8),
       [],
   )

   print(summary)