Source code for brushline.exchange.bids

"""Bid normalization and fair-price comparison."""

from __future__ import annotations

from pydantic import BaseModel, ConfigDict, Field

from brushline.exchange.contractor import ContractorBid
from brushline.exchange.plan import PlanExchange


[docs] class BidComparison(BaseModel): """Owner-plan versus contractor-bid comparison.""" model_config = ConfigDict(extra="forbid", frozen=True) plan_id: str owner_total: float = Field(ge=0) bid_total: float = Field(ge=0) delta: float fair_low: float = Field(ge=0) fair_high: float = Field(ge=0) within_fair_range: bool named_assumptions: list[str] rate_differences: dict[str, float] scope_differences: list[str] attributable: bool
[docs] def compare_bid( exchange: PlanExchange, bid: ContractorBid, *, fair_low: float, fair_high: float, ) -> BidComparison: """Compare a bid to the shared plan and record every difference source.""" if bid.plan_id != exchange.plan.header.plan_id: raise ValueError("bid references a different plan") owner_total = exchange.cost_buildup.total_cost rate_differences: dict[str, float] = {} for action in exchange.plan.actions: for line in action.cost_lines: rate_differences[line.category] = rate_differences.get(line.category, 0.0) + line.amount for category, amount in bid.cost_lines.items(): rate_differences[category] = round(amount - rate_differences.get(category, 0.0), 2) assumptions = list(bid.assumptions) if bid.access_cost: assumptions.append("Bid includes access cost.") scope = ( [] if set(bid.quantities) == {a.action_id for a in exchange.plan.actions} else ["quantity scope differs"] ) attributable = bool(rate_differences or assumptions or scope or bid.access_cost) return BidComparison( plan_id=bid.plan_id, owner_total=owner_total, bid_total=bid.total_cost, delta=round(bid.total_cost - owner_total, 2), fair_low=fair_low, fair_high=fair_high, within_fair_range=fair_low <= bid.total_cost <= fair_high, named_assumptions=assumptions, rate_differences={k: v for k, v in rate_differences.items() if abs(v) > 0.001}, scope_differences=scope, attributable=attributable, )