Struct Building 

pub struct Building {

    pub id: Uuid,
    pub acp_id: Uuid,
    pub name: String,
    pub address: String,
    pub city: String,
    pub postal_code: String,
    pub country: String,
    pub total_units: i32,
    pub total_tantiemes: i32,
    pub construction_year: Option<i32>,
    pub syndic_name: Option<String>,
    pub syndic_email: Option<String>,
    pub syndic_phone: Option<String>,
    pub syndic_address: Option<String>,
    pub syndic_office_hours: Option<String>,
    pub syndic_emergency_contact: Option<String>,
    pub slug: Option<String>,
    pub created_at: DateTime<Utc>,
    pub updated_at: DateTime<Utc>,
}

Représente un immeuble en copropriété

Fields

id: Uuid

acp_id: Uuid

Story 1.2 — FK vers acps.id (anciennement organization_id). La migration 20260601040000 a DROP la colonne organization_id ; le scoping org se fait désormais via acps.organization_id.

name: String

address: String

city: String

postal_code: String

country: String

total_units: i32

total_tantiemes: i32

construction_year: Option<i32>

syndic_name: Option<String>

syndic_email: Option<String>

syndic_phone: Option<String>

syndic_address: Option<String>

syndic_office_hours: Option<String>

syndic_emergency_contact: Option<String>

slug: Option<String>

created_at: DateTime<Utc>

updated_at: DateTime<Utc>

Implementations

impl Building

pub fn new( acp_id: Uuid, name: String, address: String, city: String, postal_code: String, country: String, total_units: i32, total_tantiemes: i32, construction_year: Option<i32>, ) -> Result<Self, String>

pub fn update_info( &mut self, name: String, address: String, city: String, postal_code: String, country: String, total_units: i32, total_tantiemes: i32, construction_year: Option<i32>, )

pub fn update_syndic_info( &mut self, syndic_name: Option<String>, syndic_email: Option<String>, syndic_phone: Option<String>, syndic_address: Option<String>, syndic_office_hours: Option<String>, syndic_emergency_contact: Option<String>, )

Update syndic public information (Belgian legal requirement)

pub fn has_public_syndic_info(&self) -> bool

Check if building has public syndic information available

pub fn is_conformant(&self, metrics: &BuildingMetrics) -> bool

Méthode d’instance : l’immeuble est-il conformant, étant donné les métriques agrégées (count units + SUM quotas) ?

Strict Decimal — aucune tolérance d’arrondi (cf. ADR-0007 + mémoire no-f64-in-money). Un immeuble à 999/1000 millièmes est non-conformant. La cible est l’acte de base (self.total_tantiemes) — pas une constante (bug fix Story H1).

pub fn compute_is_conformant( _declared_units: i32, total_tantiemes: i32, metrics: &BuildingMetrics, ) -> bool

Variante statique (pour tests purs sans instancier Building).

Story H1 : total_tantiemes est paramètre (acte de base de l’immeuble, 1000 / 10000 / autre) — plus de constante hard-codée.

declared_units n’entre plus dans le verdict : la conformité ne porte que sur les quotités, seul axe que l’acte de base fixe et que le registre légal enregistre (Art. 3.85 § 1er al. 2). Le paramètre est conservé pour ne pas casser les appelants, et parce que l’écart de lots reste rapporté par assert_conformant — il renseigne sans bloquer.

Voir la note détaillée sur Acp::is_conformant et l’issue #770.

pub fn quota_delta(&self, metrics: &BuildingMetrics) -> Decimal

Delta des quotas vs acte de base (positif = manque, négatif = surplus). Utilisé par la fiche immeuble pour afficher un message explicite à l’utilisateur (FR11).

Story H1 : méthode d’instance qui lit self.total_tantiemes — plus de constante hard-codée. Convention : quota_delta = total_tantiemes - quota_sum. Un drift de 2.5 sur acte 1000 → +2.5 (manque). Un surplus de 50 sur acte 10000 → -50.

pub fn assert_conformant( &self, metrics: &BuildingMetrics, ) -> Result<(), BuildingNotConformantError>

Assertion typée (Track H Story H1) — retourne Err(BuildingNotConformantError) si l’immeuble n’est pas conforme. Erreur exploitable par les use-cases (validate-before-compute) et le frontend (toast 422 narratif).

pub fn validate_unit_shares_distribution( units: &[Unit], total_tantiemes: i32, ) -> Result<(), String>

Validate unit shares distribution according to Art. 577-2 §4 Code Civil belge. Sum of unit shares must equal building total_shares (typically 1000 ou 10000 millièmes). Returns Ok(()) if valid, Err if invalid or excessive.

Story H1 : total_tantiemes est paramètre (acte de base) au lieu d’être hard-codé à 1000.

Belgian legal requirement: All units’ shares must sum to the building’s total_shares to ensure proper copropriété governance and voting/cost allocation.

Trait Implementations

impl Clone for Building

fn clone(&self) -> Building

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl ComposeSchema for Building

fn compose(generics: Vec<RefOr<Schema>>) -> RefOr<Schema>

impl Debug for Building

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Building

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<Building> for PublicSyndicInfoResponse

fn from(building: Building) -> Self

Converts to this type from the input type.

impl PartialEq for Building

fn eq(&self, other: &Building) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Building

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Building

impl ToSchema for Building

fn name() -> Cow<'static, str>

Return name of the schema.

fn schemas(schemas: &mut Vec<(String, RefOr<Schema>)>)

Implement reference [utoipa::openapi::schema::Schema]s for this type.