Condition Reports

List all condition reports for a lease, with optional filters by type and status.

Permissions required: LeasesRead

Create a new condition report (état des lieux) for a lease — either entry or exit.

French law context:

• Loi ALUR art. 3-2 — Mandatory at entry and exit, established contradictorily.
• Décret 2016-382 — Defines required content: room-by-room description, structural elements, equipment, meters, keys.
• Art. 22 loi 89-462 — Without exit report, deposit deductions cannot be justified.

The report is created with DRAFT status and rooms are pre-populated from the estate's existing rooms.

Permissions required: LeasesWrite

Returns a structured diff between the entry and exit condition reports for the lease. Computes element-by-element condition changes, wear coefficients (décret 2016-1104), key diffs, and a summary indicating deposit deduction justification.

Used by: POST /leases/{id}/deposit/return to calculate justified deductions (art. 22 loi 89-462).

Permissions required: LeasesRead

Returns the full condition report including room conditions, element conditions, meter snapshots, and key snapshots.

Permissions required: LeasesRead

Update metadata of a condition report. Only allowed when status is DRAFT.

Permissions required: LeasesWrite

Delete a condition report. Only allowed when status is DRAFT.

Permissions required: LeasesDelete

Transitions the report from DRAFT to COMPLETED, locking all observations. Once completed, room conditions, meter readings, and key handovers cannot be modified.

Permissions required: LeasesWrite

Record or update structural element conditions for a specific room in the condition report. Uses batch upsert — all elements for the room are submitted at once.

Element types cover the mandatory structural categories from décret 2016-382: floors, walls, ceiling, doors, windows, electrical, plumbing, heating.

Only allowed when the report is in DRAFT status.

Permissions required: LeasesWrite

Record meter readings as dated snapshots. Does not update the current meter value — uses the snapshot pattern to capture the state at the time of the condition report.

References existing LeaseMeter entities via lease_meter_id.

Only allowed when the report is in DRAFT status.

Permissions required: LeasesWrite

Record key delivery/return as dated snapshots. Does not update the current key status — uses the snapshot pattern to capture the handover at the time of the condition report.

References existing EstateKey entities via estate_key_id. Missing keys at exit (key_diffs.missing > 0) constitute a justified deposit deduction.

Only allowed when the report is in DRAFT status.

Permissions required: LeasesWrite

Generate a filled condition report PDF via AnnexGenerationService.generate_condition_report_pdf(), which extends the existing generate_edl_annex() method by injecting recorded element conditions, meter snapshots, and key snapshots into the Typst template (etat_des_lieux.typ).

Equipment and inventory data are auto-captured from current state via EquipmentPort and RoomInventoryPort — no separate endpoints needed.

Meter readings are resolved via the lease_meter → meter → meter.type chain to map to the template's meter_readings: {electricity, gas, cold_water, hot_water} contract.

The generated PDF follows décret 2016-382 format requirements.

Note: This produces a filled PDF (from recorded observations). The existing system annex "etat_des_lieux" (via download_lease_annex) continues to produce a blank PDF for on-site use.

Permissions required: LeasesWrite

Initiate the contradictory electronic signature process for the condition report.

Prerequisites:

• Report must be in COMPLETED status (observations locked)
• document_url must be set (PDF generated via endpoint #11)

Flow (reuses existing signature system):

1. Uploads the filled PDF to Media system (security_level = Critical, entity_type = ConditionReport)
2. Creates a DocumentSignature record with document_type = "CONDITION_REPORT"
3. Creates SignatureRequest for the owner (Proprietaire) and each tenant (Locataire)
4. Sends signature requests to DO Global (external eIDAS provider)
5. Publishes notification events (same pattern as lease/amendment signatures)
6. Stores document_signature_id on the condition report

Each party signs via OTP (same flow as lease signatures).

Legal context: Art. 3-2 loi ALUR — L'état des lieux est établi contradictoirement. eIDAS art. 25 — La signature électronique avancée constitue une preuve recevable.

Permissions required: LeasesWrite

Finalize the signature process after all parties have signed.

Flow:

1. Verifies all SignatureRequest records are in Completed status
2. Retrieves the signed PDF (signed_media_id) from the DocumentSignature
3. Updates the condition report: signed_document_url, status → SIGNED
4. Generates eIDAS proof archive (JSON + PDF) if configured

Permissions required: LeasesWrite