Struct Fund 

pub struct Fund {
    pub id: Uuid,
    pub acp_id: Uuid,
    pub kind: FundKind,
    pub name: String,
    pub purpose: Option<String>,
    pub target_amount: Option<Decimal>,
    pub balance: Decimal,
    pub created_at: DateTime<Utc>,
    pub updated_at: DateTime<Utc>,
}

Fonds de l’ACP — roulement, réserve légale, ou affecté (thésaurisation).

Fields

id: Uuid

acp_id: Uuid

kind: FundKind

name: String

purpose: Option<String>

Objet précis du chantier — uniquement pour FundKind::Earmarked.

target_amount: Option<Decimal>

Objectif d’épargne — uniquement pour FundKind::Earmarked.

balance: Decimal

created_at: DateTime<Utc>

updated_at: DateTime<Utc>

Implementations

impl Fund

pub fn new( acp_id: Uuid, kind: FundKind, name: String, purpose: Option<String>, target_amount: Option<Decimal>, ) -> Result<Self, FundError>

Crée un fonds de roulement ou de réserve (pas d’objet, pas d’objectif). Pour un fonds affecté, voir Fund::new_earmarked.

pub fn new_earmarked( acp_id: Uuid, name: String, purpose: String, target_amount: Decimal, majority_used: MajorityType, ) -> Result<Self, FundError>

Crée un fonds affecté, en exigeant la majorité des gros travaux (2/3, Art. 3.88 §1, 1°, b).

@security (story #635) : créer un fonds fléché à la majorité simple contournerait la majorité qui protège les copropriétaires du chantier lui-même.

pub fn contribute(&mut self, amount: Decimal) -> Result<(), FundError>

Alimente le fonds. Le solde ne se confond avec aucun autre fonds : chaque Fund porte le sien.

pub fn progress(&self) -> Option<Decimal>

Progression de l’épargne vers l’objectif (balance / target_amount). None pour un fonds sans objectif (roulement/réserve) ou à objectif nul.

pub fn reliquat(&self) -> Option<Decimal>

Le reliquat : ce que le fonds a accumulé au-delà de son objectif, une fois celui-ci atteint (chantier terminé sous budget).

None tant que l’objectif n’est pas dépassé, ou pour un fonds sans objectif (roulement/réserve).

pub fn assert_expense_matches_purpose( &self, expense_work_ref: &str, ag_override: Option<ResolutionStatus>, ) -> Result<(), FundError>

Autorise (ou refuse) une dépense imputée à ce fonds pour l’objet expense_work_ref.

Seul un fonds affecté restreint ainsi ses dépenses — roulement et réserve n’ont pas d’objet unique à comparer. ag_override lève la restriction quand il vaut Some(ResolutionStatus::Adopted) : « ne jamais bloquer une dépense au seul motif que le fonds était fléché ailleurs, dès lors qu’une décision d’AG l’autorise » (PO @gilmry).

pub fn reassign( &mut self, new_purpose: String, amount: Option<Decimal>, resolution_id: Uuid, resolution_status: ResolutionStatus, ) -> Result<FundReassignment, FundError>

Réaffecte tout ou partie du solde de ce fonds affecté vers une autre fin, sur décision d’AG adoptée. Retourne l’audit trail (FundReassignment) tracant l’affectation d’origine.

amount = None réaffecte la TOTALITÉ du solde disponible : le fonds sert alors intégralement la nouvelle fin (purpose change). amount = Some(x) avec x strictement inférieur au solde ne réaffecte qu’une partie : le reliquat continue de servir l’objet d’origine. Si x égale le solde entier, le résultat est le même que la totalité.

Trait Implementations

impl Clone for Fund

fn clone(&self) -> Fund

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl ComposeSchema for Fund

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

impl Debug for Fund

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Fund

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Fund

fn eq(&self, other: &Fund) -> 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 Fund

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 Fund

impl ToSchema for Fund

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.