backbone-banking 0.9.0

Cash & bank — bank/account master, statement import, reconciliation, and clearing postings (5th GL producer)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146

//! DTOs (Data Transfer Objects)
//!
//! Generated by metaphor-schema. Do not edit manually.
//!
//! This module provides DTOs for the presentation layer,
//! with OpenAPI schema support.

pub mod bank_dto;
pub mod bank_account_dto;
pub mod bank_clearance_dto;
pub mod bank_reconciliation_dto;
pub mod bank_statement_import_dto;
pub mod bank_transaction_dto;
pub mod fx_gain_loss_dto;
pub mod reconcile_preset_dto;

// Re-exports
pub use bank_dto::{
    CreateBankDto,
    UpdateBankDto,
    PatchBankDto,
    BankResponseDto,
    BankListResponseDto,
    BankSummaryDto,
};
pub use bank_account_dto::{
    CreateBankAccountDto,
    UpdateBankAccountDto,
    PatchBankAccountDto,
    BankAccountResponseDto,
    BankAccountListResponseDto,
    BankAccountSummaryDto,
};
pub use bank_clearance_dto::{
    CreateBankClearanceDto,
    UpdateBankClearanceDto,
    PatchBankClearanceDto,
    BankClearanceResponseDto,
    BankClearanceListResponseDto,
    BankClearanceSummaryDto,
};
pub use bank_reconciliation_dto::{
    CreateBankReconciliationDto,
    UpdateBankReconciliationDto,
    PatchBankReconciliationDto,
    BankReconciliationResponseDto,
    BankReconciliationListResponseDto,
    BankReconciliationSummaryDto,
};
pub use bank_statement_import_dto::{
    CreateBankStatementImportDto,
    UpdateBankStatementImportDto,
    PatchBankStatementImportDto,
    BankStatementImportResponseDto,
    BankStatementImportListResponseDto,
    BankStatementImportSummaryDto,
};
pub use bank_transaction_dto::{
    CreateBankTransactionDto,
    UpdateBankTransactionDto,
    PatchBankTransactionDto,
    BankTransactionResponseDto,
    BankTransactionListResponseDto,
    BankTransactionSummaryDto,
};
pub use fx_gain_loss_dto::{
    CreateFxGainLossDto,
    UpdateFxGainLossDto,
    PatchFxGainLossDto,
    FxGainLossResponseDto,
    FxGainLossListResponseDto,
    FxGainLossSummaryDto,
};
pub use reconcile_preset_dto::{
    CreateReconcilePresetDto,
    UpdateReconcilePresetDto,
    PatchReconcilePresetDto,
    ReconcilePresetResponseDto,
    ReconcilePresetListResponseDto,
    ReconcilePresetSummaryDto,
};

// Common pagination types
use serde::Serialize;

#[cfg(feature = "openapi")]
#[cfg(feature = "openapi")]
use utoipa::ToSchema;

/// Pagination parameters for list requests
#[derive(Debug, Clone, Default, serde::Deserialize)]
#[cfg_attr(feature = "openapi", derive(ToSchema))]
pub struct PaginationParams {
    /// Page number (1-indexed)
    #[serde(default = "default_page")]
    pub page: u32,
    /// Items per page
    #[serde(default = "default_per_page")]
    pub per_page: u32,
    /// Field to sort by
    pub sort_by: Option<String>,
    /// Sort order (asc/desc)
    pub sort_order: Option<String>,
}

fn default_page() -> u32 { 1 }
fn default_per_page() -> u32 { 20 }

/// API response wrapper
#[derive(Debug, Clone, Serialize)]
#[cfg_attr(feature = "openapi", derive(ToSchema))]
#[serde(rename_all = "camelCase")]
pub struct ApiResponse<T> {
    pub success: bool,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub data: Option<T>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub error: Option<ApiError>,
}

#[derive(Debug, Clone, Serialize)]
#[cfg_attr(feature = "openapi", derive(ToSchema))]
pub struct ApiError {
    pub code: String,
    pub message: String,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub details: Option<serde_json::Value>,
}

impl<T> ApiResponse<T> {
    pub fn ok(data: T) -> Self {
        Self { success: true, data: Some(data), error: None }
    }

    pub fn err(code: impl Into<String>, message: impl Into<String>) -> Self {
        Self {
            success: false,
            data: None,
            error: Some(ApiError {
                code: code.into(),
                message: message.into(),
                details: None,
            }),
        }
    }
}