Struct AccountUseCases 

pub struct AccountUseCases { /* private fields */ }

Use cases for managing accounts in the Belgian PCMN

This orchestrates account operations, including:

• CRUD operations for accounts
• Seeding Belgian PCMN chart of accounts (inspired by Noalyss mono-belge.sql)
• Hierarchical account management
• Account validation and business rules

Implementations

impl AccountUseCases

pub fn new(repository: Arc<dyn AccountRepository>) -> Self

pub async fn create_account( &self, code: String, label: String, parent_code: Option<String>, account_type: AccountType, direct_use: bool, organization_id: Uuid, ) -> Result<Account, String>

Create a new account

Arguments

• code - Account code (e.g., “700”, “604001”)
• label - Account description
• parent_code - Optional parent account code
• account_type - Account classification
• direct_use - Whether account can be used in transactions
• organization_id - Organization ID

Returns

Created account or error message

pub async fn get_account(&self, id: Uuid) -> Result<Option<Account>, String>

Get account by ID

pub async fn get_account_by_code( &self, code: &str, organization_id: Uuid, ) -> Result<Option<Account>, String>

Get account by code within an organization

pub async fn list_accounts( &self, organization_id: Uuid, ) -> Result<Vec<Account>, String>

List all accounts for an organization

pub async fn list_accounts_by_type( &self, account_type: AccountType, organization_id: Uuid, ) -> Result<Vec<Account>, String>

List accounts by type (for financial reports)

pub async fn list_child_accounts( &self, parent_code: &str, organization_id: Uuid, ) -> Result<Vec<Account>, String>

List child accounts of a parent

pub async fn list_direct_use_accounts( &self, organization_id: Uuid, ) -> Result<Vec<Account>, String>

List accounts that can be used directly in transactions

pub async fn search_accounts( &self, code_pattern: &str, organization_id: Uuid, ) -> Result<Vec<Account>, String>

Search accounts by code pattern (e.g., “60%” for all class 6 accounts)

pub async fn update_account( &self, id: Uuid, label: Option<String>, parent_code: Option<Option<String>>, account_type: Option<AccountType>, direct_use: Option<bool>, ) -> Result<Account, String>

Update an existing account

pub async fn delete_account(&self, id: Uuid) -> Result<(), String>

Delete an account

Validates:

• Account has no children
• Account is not used in expenses

pub async fn count_accounts(&self, organization_id: Uuid) -> Result<i64, String>

Count accounts in an organization

pub async fn seed_belgian_pcmn( &self, organization_id: Uuid, ) -> Result<i64, String>

Seed Belgian PCMN (Plan Comptable Minimum Normalisé) for a new organization

Creates a standard chart of accounts for Belgian property management. This seed data is inspired by Noalyss’ mono-belge.sql, curated for property management (syndic de copropriété).

Arguments

• organization_id - Organization to seed accounts for

Returns

Number of accounts created or error message

Belgian PCMN Structure

• Class 1: Liabilities (Capital, Reserves)
• Classes 2-5: Assets (Fixed assets, Receivables, Bank)
• Class 6: Expenses (Electricity, Maintenance, Insurance, etc.)
• Class 7: Revenue (Regular fees, Extraordinary fees, Interest)

Reference: Noalyss contrib/mono-dossier/mono-belge.sql