Architecture

Alba Core follows a small layered architecture inspired by Godot’s emphasis on clear subsystems.

Subsystem Overview

app.api: Thin HTTP layer. It validates request shape and delegates to Alba Core.
app.alba_core.pipeline: Orchestrates one full search turn.
app.alba_core.extraction: Converts text into RentalRequirements.
app.alba_core.matching: Filters and scores PropertyRecord objects.
app.alba_core.leads: Builds the staff-facing lead summary.
app.propertyme: Loads cached property data and prepares future PropertyMe OAuth/API access.