=============================================
Contractor Quotes System (Issue #91)
=============================================

Overview
========

Management of contractor quotes for building maintenance and renovation
works, with strict compliance to Belgian copropriété law requirements.

Belgian Legal Requirements
==========================

Belgian copropriété law mandates:

- **3 quotes minimum** for construction works exceeding **5,000€**
- **General assembly vote** required for major works
- **10-year structural warranty** ("décennale") for structural works
- **2-year warranty** for apparent defects

The system enforces these rules through automatic scoring and comparison.

Automatic Scoring Algorithm
============================

When comparing quotes, the system applies weighted scoring:

+------------+--------+----------------------------------+
| Criterion  | Weight | Logic                            |
+============+========+==================================+
| Price      | 40%    | Lower price = higher score       |
+------------+--------+----------------------------------+
| Delay      | 30%    | Shorter duration = higher score  |
+------------+--------+----------------------------------+
| Warranty   | 20%    | Longer warranty = higher score   |
+------------+--------+----------------------------------+
| Reputation | 10%    | Higher rating (0-100) = higher   |
+------------+--------+----------------------------------+

Quote Workflow
==============

::

    Requested → Received → UnderReview → Accepted
                                       → Rejected
                                       → Expired
                               ↓
                           Withdrawn

- **Requested**: Syndic sends quote request to contractor
- **Received**: Contractor submits pricing
- **UnderReview**: Syndic evaluates the quote
- **Accepted/Rejected**: Decision with audit trail
- **Expired**: Past validity_date
- **Withdrawn**: Contractor withdraws

Belgian VAT Rates
=================

- **6%** reduced rate (renovations of buildings >10 years old)
- **21%** standard rate (new construction)

Decision Audit Trail
====================

Each accept/reject records:

- ``decision_at``: Timestamp
- ``decision_by``: User UUID
- ``decision_notes``: Justification text

API Endpoints (15)
==================

- ``POST /quotes`` - Create quote request
- ``GET /quotes/:id`` - Get details
- ``GET /buildings/:id/quotes`` - List building quotes
- ``POST /quotes/:id/submit`` - Contractor submits pricing
- ``POST /quotes/:id/review`` - Start review
- ``POST /quotes/:id/accept`` - Accept (audit trail)
- ``POST /quotes/:id/reject`` - Reject (audit trail)
- ``POST /quotes/:id/withdraw`` - Contractor withdraws
- ``POST /quotes/compare`` - Compare multiple quotes (scoring)
- ``PUT /quotes/:id/contractor-rating`` - Update rating

Architecture
============

- **Domain**: ``quote.rs`` (661 lines, 7 state transitions)
- **Use Cases**: ``quote_use_cases.rs`` (20 methods including compare)
- **Migration**: ``20251120150000_create_quotes.sql``
- **BDD Tests**: ``quotes.feature`` (13 scenarios)
- **Total**: ~2,161 lines of code