Struct Journal 

pub struct Journal {

    pub id: Uuid,
    pub journal_number: String,
    pub reference_number: Option<String>,
    pub journal_type: JournalType,
    pub branch_id: Option<Uuid>,
    pub transaction_date: NaiveDate,
    pub posting_date: Option<NaiveDate>,
    pub fiscal_period_id: Option<Uuid>,
    pub fiscal_year: Option<i32>,
    pub fiscal_month: Option<i32>,
    pub description: String,
    pub notes: Option<String>,
    pub currency: String,
    pub total_debit: Decimal,
    pub total_credit: Decimal,
    pub line_count: i32,
    pub source: JournalSource,
    pub source_type: Option<String>,
    pub source_id: Option<Uuid>,
    pub source_reference: Option<String>,
    pub is_reversed: bool,
    pub reversed_by_id: Option<Uuid>,
    pub reversed_at: Option<DateTime<Utc>>,
    pub reversal_reason: Option<String>,
    pub reverses_id: Option<Uuid>,
    pub is_reversing: bool,
    pub auto_reverse: bool,
    pub auto_reverse_date: Option<NaiveDate>,
    pub status: JournalStatus,
    pub requires_approval: bool,
    pub approval_threshold: Option<Decimal>,
    pub submitted_at: Option<DateTime<Utc>>,
    pub submitted_by: Option<Uuid>,
    pub approved_at: Option<DateTime<Utc>>,
    pub approved_by: Option<Uuid>,
    pub rejected_at: Option<DateTime<Utc>>,
    pub rejected_by: Option<Uuid>,
    pub rejection_reason: Option<String>,
    pub posted_at: Option<DateTime<Utc>>,
    pub posted_by: Option<Uuid>,
    pub is_voided: bool,
    pub voided_at: Option<DateTime<Utc>>,
    pub voided_by: Option<Uuid>,
    pub void_reason: Option<String>,
    pub attachments: Value,
    pub metadata: AuditMetadata,
}

Fields

id: Uuid

journal_number: String

reference_number: Option<String>

journal_type: JournalType

branch_id: Option<Uuid>

transaction_date: NaiveDate

posting_date: Option<NaiveDate>

fiscal_period_id: Option<Uuid>

fiscal_year: Option<i32>

fiscal_month: Option<i32>

description: String

notes: Option<String>

currency: String

total_debit: Decimal

total_credit: Decimal

line_count: i32

source: JournalSource

source_type: Option<String>

source_id: Option<Uuid>

source_reference: Option<String>

is_reversed: bool

reversed_by_id: Option<Uuid>

reversed_at: Option<DateTime<Utc>>

reversal_reason: Option<String>

reverses_id: Option<Uuid>

is_reversing: bool

auto_reverse: bool

auto_reverse_date: Option<NaiveDate>

status: JournalStatus

requires_approval: bool

approval_threshold: Option<Decimal>

submitted_at: Option<DateTime<Utc>>

submitted_by: Option<Uuid>

approved_at: Option<DateTime<Utc>>

approved_by: Option<Uuid>

rejected_at: Option<DateTime<Utc>>

rejected_by: Option<Uuid>

rejection_reason: Option<String>

posted_at: Option<DateTime<Utc>>

posted_by: Option<Uuid>

is_voided: bool

voided_at: Option<DateTime<Utc>>

voided_by: Option<Uuid>

void_reason: Option<String>

attachments: Value

metadata: AuditMetadata

Implementations

impl Journal

pub fn builder() -> JournalBuilder

Create a builder for Journal

pub fn new( journal_number: String, journal_type: JournalType, transaction_date: NaiveDate, description: String, currency: String, total_debit: Decimal, total_credit: Decimal, line_count: i32, source: JournalSource, is_reversed: bool, is_reversing: bool, auto_reverse: bool, status: JournalStatus, requires_approval: bool, is_voided: bool, attachments: Value, ) -> Self

Create a new Journal with required fields

pub fn id(&self) -> &Uuid

Get the entity’s unique identifier

pub fn typed_id(&self) -> JournalId

Get a strongly-typed ID for this entity

pub fn created_at(&self) -> Option<&DateTime<Utc>>

Get when this entity was created

pub fn updated_at(&self) -> Option<&DateTime<Utc>>

Get when this entity was last updated

pub fn is_deleted(&self) -> bool

Check if this entity is soft deleted

pub fn is_active(&self) -> bool

Check if this entity is active (not deleted)

pub fn deleted_at(&self) -> Option<&DateTime<Utc>>

Get when this entity was deleted

pub fn created_by(&self) -> Option<&Uuid>

Get who created this entity

pub fn updated_by(&self) -> Option<&Uuid>

Get who last updated this entity

pub fn deleted_by(&self) -> Option<&Uuid>

Get who deleted this entity

pub fn status(&self) -> &JournalStatus

Get the current status

pub fn with_reference_number(self, value: String) -> Self

Set the reference_number field (chainable)

pub fn with_branch_id(self, value: Uuid) -> Self

Set the branch_id field (chainable)

pub fn with_posting_date(self, value: NaiveDate) -> Self

Set the posting_date field (chainable)

pub fn with_fiscal_period_id(self, value: Uuid) -> Self

Set the fiscal_period_id field (chainable)

pub fn with_fiscal_year(self, value: i32) -> Self

Set the fiscal_year field (chainable)

pub fn with_fiscal_month(self, value: i32) -> Self

Set the fiscal_month field (chainable)

pub fn with_notes(self, value: String) -> Self

Set the notes field (chainable)

pub fn with_source_type(self, value: String) -> Self

Set the source_type field (chainable)

pub fn with_source_id(self, value: Uuid) -> Self

Set the source_id field (chainable)

pub fn with_source_reference(self, value: String) -> Self

Set the source_reference field (chainable)

pub fn with_reversed_by_id(self, value: Uuid) -> Self

Set the reversed_by_id field (chainable)

pub fn with_reversed_at(self, value: DateTime<Utc>) -> Self

Set the reversed_at field (chainable)

pub fn with_reversal_reason(self, value: String) -> Self

Set the reversal_reason field (chainable)

pub fn with_reverses_id(self, value: Uuid) -> Self

Set the reverses_id field (chainable)

pub fn with_auto_reverse_date(self, value: NaiveDate) -> Self

Set the auto_reverse_date field (chainable)

pub fn with_approval_threshold(self, value: Decimal) -> Self

Set the approval_threshold field (chainable)

pub fn with_submitted_at(self, value: DateTime<Utc>) -> Self

Set the submitted_at field (chainable)

pub fn with_submitted_by(self, value: Uuid) -> Self

Set the submitted_by field (chainable)

pub fn with_approved_at(self, value: DateTime<Utc>) -> Self

Set the approved_at field (chainable)

pub fn with_approved_by(self, value: Uuid) -> Self

Set the approved_by field (chainable)

pub fn with_rejected_at(self, value: DateTime<Utc>) -> Self

Set the rejected_at field (chainable)

pub fn with_rejected_by(self, value: Uuid) -> Self

Set the rejected_by field (chainable)

pub fn with_rejection_reason(self, value: String) -> Self

Set the rejection_reason field (chainable)

pub fn with_posted_at(self, value: DateTime<Utc>) -> Self

Set the posted_at field (chainable)

pub fn with_posted_by(self, value: Uuid) -> Self

Set the posted_by field (chainable)

pub fn with_voided_at(self, value: DateTime<Utc>) -> Self

Set the voided_at field (chainable)

pub fn with_voided_by(self, value: Uuid) -> Self

Set the voided_by field (chainable)

pub fn with_void_reason(self, value: String) -> Self

Set the void_reason field (chainable)

pub fn apply_patch(&mut self, fields: HashMap<String, Value>)

Apply partial updates from a map of field name to JSON value

Trait Implementations

impl ApplyUpdateDto<UpdateJournalDto> for Journal

fn apply_update(self, dto: UpdateJournalDto) -> ServiceResult<Self>

impl Clone for Journal

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl CrudRepository<Journal> for JournalRepository

fn fetch_related_json<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, table: &'life1 str, ids: &'life2 [String], ) -> Pin<Box<dyn Future<Output = Vec<Value>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Hydrate ?include= relations: fetch rows from table by id list, as JSON (raw row_to_json). table comes from EntityRepoMeta::relations() (generator-emitted), never client input. Default: no expansion. The Postgres-backed generated repos override this via impl_crud_repository!.

fn create<'life0, 'async_trait>( &'life0 self, entity: Journal, ) -> Pin<Box<dyn Future<Output = Result<Journal, RepositoryError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Create a new entity

fn find_by_id<'life0, 'life1, 'async_trait>( &'life0 self, id: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Option<Journal>, RepositoryError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Find entity by ID (excluding soft-deleted)

fn find_by_id_including_deleted<'life0, 'life1, 'async_trait>( &'life0 self, id: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Option<Journal>, RepositoryError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Find entity by ID (including soft-deleted, for trash operations)

fn update<'life0, 'async_trait>( &'life0 self, entity: Journal, ) -> Pin<Box<dyn Future<Output = Result<Journal, RepositoryError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Update an existing entity

fn soft_delete<'life0, 'life1, 'async_trait>( &'life0 self, id: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<bool, RepositoryError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Soft delete an entity

fn restore<'life0, 'life1, 'async_trait>( &'life0 self, id: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Option<Journal>, RepositoryError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Restore a soft-deleted entity

fn hard_delete<'life0, 'life1, 'async_trait>( &'life0 self, id: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<bool, RepositoryError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Permanently delete an entity

fn list<'life0, 'async_trait>( &'life0 self, page: u32, limit: u32, ) -> Pin<Box<dyn Future<Output = Result<(Vec<Journal>, u64), RepositoryError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

List entities with pagination (excluding soft-deleted)

fn list_filtered<'life0, 'async_trait>( &'life0 self, page: u32, limit: u32, filters: HashMap<String, String>, ) -> Pin<Box<dyn Future<Output = Result<(Vec<Journal>, u64), RepositoryError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

List entities with pagination and filters (excluding soft-deleted)

fn list_filtered_with_info<'life0, 'async_trait>( &'life0 self, page: u32, limit: u32, filters: HashMap<String, String>, ) -> Pin<Box<dyn Future<Output = Result<(Vec<Journal>, PaginationInfo), RepositoryError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

list_filtered, carrying the pagination info (cursor positions included) so the HTTP layer can surface keyset paging. Default: the tuple form with the cursor fields absent; the generated Postgres repositories override this with the real keyset walk.

fn table_name(&self) -> Option<&str>

Group and reduce entities under the same filters as list_filtered.

fn aggregate_filtered<'life0, 'life1, 'async_trait>( &'life0 self, spec: &'life1 AggregateSpec, filters: HashMap<String, String>, ) -> Pin<Box<dyn Future<Output = Result<AggregateResult, RepositoryError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

fn list_deleted<'life0, 'async_trait>( &'life0 self, page: u32, limit: u32, ) -> Pin<Box<dyn Future<Output = Result<(Vec<Journal>, u64), RepositoryError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

List soft-deleted entities with pagination

fn count<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<u64, RepositoryError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Count all entities (excluding soft-deleted)

fn count_deleted<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<u64, RepositoryError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Count soft-deleted entities

fn bulk_create<'life0, 'async_trait>( &'life0 self, entities: Vec<Journal>, ) -> Pin<Box<dyn Future<Output = Result<Vec<Journal>, RepositoryError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Bulk create entities

fn empty_trash<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<u64, RepositoryError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Permanently delete all soft-deleted entities

fn bulk_soft_delete<'life0, 'life1, 'async_trait>( &'life0 self, ids: &'life1 [String], ) -> Pin<Box<dyn Future<Output = Result<u64, RepositoryError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Soft-delete many entities by id. Returns the number affected.

fn bulk_restore<'life0, 'life1, 'async_trait>( &'life0 self, ids: &'life1 [String], ) -> Pin<Box<dyn Future<Output = Result<Vec<Journal>, RepositoryError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Restore many soft-deleted entities by id. Returns the restored entities.

fn bulk_hard_delete<'life0, 'life1, 'async_trait>( &'life0 self, ids: &'life1 [String], ) -> Pin<Box<dyn Future<Output = Result<u64, RepositoryError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Permanently delete many entities by id. Returns the number affected.

fn restore_all<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Vec<Journal>, RepositoryError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Restore every soft-deleted entity. Returns the restored entities.

fn bulk_update<'life0, 'async_trait>( &'life0 self, entities: Vec<Journal>, ) -> Pin<Box<dyn Future<Output = Result<Vec<Journal>, RepositoryError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Update many entities atomically. Returns the updated entities.

fn exists<'life0, 'life1, 'async_trait>( &'life0 self, id: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<bool, RepositoryError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, Self: 'async_trait,

Check if an entity exists by ID

impl Debug for Journal

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Journal

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Entity for Journal

type Id = Uuid

The type of the entity’s unique identifier

fn entity_id(&self) -> &Self::Id

Get the entity’s unique identifier

fn entity_type() -> &'static str

Get the entity type name

impl EntityRepoMeta for Journal

fn column_types() -> HashMap<String, String>

PostgreSQL type hints for filter/sort (e.g. {"id": "uuid"}).

fn search_fields() -> &'static [&'static str]

Text columns to include in full-text / ILIKE search.

fn relations() -> &'static [(&'static str, &'static str, &'static str)]

To-one relations expandable via ?include=<name>, as (relation_name, target_table, local_fk_field) — all response keys (relation_name/local_fk in camelCase; target_table is the DB table). Default: none.

fn private_fields() -> &'static [&'static str]

Response fields visible only to the row owner and platform/root callers (@private). Stripped for everyone else.

fn secret_fields() -> &'static [&'static str]

Response fields (camelCase) that never leave the server (@sensitive): no caller is served them, a platform caller or the row’s owner included.

fn relation_secret_fields(_relation: &str) -> &'static [&'static str]

The @sensitive fields (camelCase response keys) of the model a to-one relation points at, stripped from the related row an ?include= expands. Keyed by the relation name of relations. Default: none.

fn owner_field() -> Option<&'static str>

The response field (camelCase) holding the owner/company id (@owner), compared against the caller’s access scope to decide private-field visibility. None = the entity has no owner concept.

fn company_field() -> Option<&'static str>

The DB column that scopes rows to a company (snake_case, e.g. company_id). None = the entity is global (reference data) and is not fenced.

impl From<&Journal> for JournalResponseDto

fn from(entity: &Journal) -> Self

Converts to this type from the input type.

impl From<CreateJournalDto> for Journal

fn from(dto: CreateJournalDto) -> Self

Converts to this type from the input type.

impl From<Journal> for JournalResponseDto

fn from(entity: Journal) -> Self

Converts to this type from the input type.

impl From<Journal> for JournalSummaryDto

fn from(entity: Journal) -> Self

Converts to this type from the input type.

impl FromCreateDto<CreateJournalDto> for Journal

fn from_create_dto(dto: CreateJournalDto) -> ServiceResult<Self>

impl<'a, R: Row> FromRow<'a, R> for Journal

where &'a str: ColumnIndex<R>, Uuid: Decode<'a, R::Database> + Type<R::Database>, String: Decode<'a, R::Database> + Type<R::Database>, Option<String>: Decode<'a, R::Database> + Type<R::Database>, JournalType: Decode<'a, R::Database> + Type<R::Database>, Option<Uuid>: Decode<'a, R::Database> + Type<R::Database>, NaiveDate: Decode<'a, R::Database> + Type<R::Database>, Option<NaiveDate>: Decode<'a, R::Database> + Type<R::Database>, Option<i32>: Decode<'a, R::Database> + Type<R::Database>, Decimal: Decode<'a, R::Database> + Type<R::Database>, i32: Decode<'a, R::Database> + Type<R::Database>, JournalSource: Decode<'a, R::Database> + Type<R::Database>, bool: Decode<'a, R::Database> + Type<R::Database>, Option<DateTime<Utc>>: Decode<'a, R::Database> + Type<R::Database>, JournalStatus: Decode<'a, R::Database> + Type<R::Database>, Option<Decimal>: Decode<'a, R::Database> + Type<R::Database>, Value: Decode<'a, R::Database> + Type<R::Database>, Json<AuditMetadata>: Decode<'a, R::Database> + Type<R::Database>,

fn from_row(__row: &'a R) -> Result<Self>

impl PersistentEntity for Journal

fn entity_id(&self) -> String

Get the entity’s unique identifier

fn set_entity_id(&mut self, id: String)

Set the entity’s unique identifier

fn created_at(&self) -> Option<DateTime<Utc>>

Get creation timestamp

fn set_created_at(&mut self, ts: DateTime<Utc>)

Set creation timestamp

fn updated_at(&self) -> Option<DateTime<Utc>>

Get last update timestamp

fn set_updated_at(&mut self, ts: DateTime<Utc>)

Set last update timestamp

fn deleted_at(&self) -> Option<DateTime<Utc>>

Get soft delete timestamp (None if not deleted)

fn set_deleted_at(&mut self, ts: Option<DateTime<Utc>>)

Set soft delete timestamp

fn is_deleted(&self) -> bool

Check if entity is soft-deleted

fn mark_deleted(&mut self)

Mark entity as deleted (soft delete)

fn restore(&mut self)

Restore a soft-deleted entity

fn touch(&mut self)

Touch the entity (update timestamp)

fn generate_id() -> String

Generate a new ID for this entity type

fn write_protected_fields() -> &'static [&'static str]

Fields that a generic write (PUT, PATCH and their bulk forms) may not change, by their serialized name.

impl Serialize for Journal

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl WriteGuard<Journal> for JournalRowRules

fn check<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, ctx: &'life1 WriteCtx<'life2, Journal>, ) -> Pin<Box<dyn Future<Output = GuardOutcome> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,