Struct AuditEngagement 

pub struct AuditEngagement {

    pub engagement_id: Uuid,
    pub engagement_ref: String,
    pub client_entity_id: String,
    pub client_name: String,
    pub engagement_type: EngagementType,
    pub fiscal_year: u16,
    pub period_end_date: NaiveDate,
    pub materiality: Decimal,
    pub performance_materiality: Decimal,
    pub clearly_trivial: Decimal,
    pub materiality_basis: String,
    pub materiality_percentage: f64,
    pub planning_start: NaiveDate,
    pub planning_end: NaiveDate,
    pub fieldwork_start: NaiveDate,
    pub fieldwork_end: NaiveDate,
    pub completion_start: NaiveDate,
    pub report_date: NaiveDate,
    pub engagement_partner_id: String,
    pub engagement_partner_name: String,
    pub engagement_manager_id: String,
    pub engagement_manager_name: String,
    pub team_member_ids: Vec<String>,
    pub status: EngagementStatus,
    pub current_phase: EngagementPhase,
    pub overall_audit_risk: RiskLevel,
    pub significant_risk_count: u32,
    pub fraud_risk_level: RiskLevel,
    pub created_at: DateTime<Utc>,
    pub updated_at: DateTime<Utc>,
    pub scope_id: Option<String>,
}

Audit engagement representing an audit project.

Fields

engagement_id: Uuid

Unique engagement ID

engagement_ref: String

External engagement reference (e.g., “AUD-2025-001”)

client_entity_id: String

Client entity being audited

client_name: String

Client name

engagement_type: EngagementType

Type of engagement

fiscal_year: u16

Fiscal year being audited

period_end_date: NaiveDate

Fiscal period end date

materiality: Decimal

Overall materiality

performance_materiality: Decimal

Performance materiality (typically 50-75% of materiality)

clearly_trivial: Decimal

Clearly trivial threshold (typically 3-5% of materiality)

materiality_basis: String

Materiality basis (e.g., “Total Revenue”, “Total Assets”)

materiality_percentage: f64

Materiality percentage applied

planning_start: NaiveDate

Planning phase start date

planning_end: NaiveDate

Planning phase end date

fieldwork_start: NaiveDate

Fieldwork start date

fieldwork_end: NaiveDate

Fieldwork end date

completion_start: NaiveDate

Completion phase start date

report_date: NaiveDate

Expected report date

engagement_partner_id: String

Engagement partner ID

engagement_partner_name: String

Engagement partner name

engagement_manager_id: String

Engagement manager ID

engagement_manager_name: String

Engagement manager name

team_member_ids: Vec<String>

All team member IDs

status: EngagementStatus

Current engagement status

current_phase: EngagementPhase

Current phase

overall_audit_risk: RiskLevel

Overall audit risk assessment

significant_risk_count: u32

Number of significant risks identified

fraud_risk_level: RiskLevel

Fraud risk assessment level

created_at: DateTime<Utc>

updated_at: DateTime<Utc>

scope_id: Option<String>

Audit scope identifier (FK → AuditScope.id). Populated during planning phase.

Implementations

impl AuditEngagement

pub fn new( client_entity_id: &str, client_name: &str, engagement_type: EngagementType, fiscal_year: u16, period_end_date: NaiveDate, ) -> Self

Create a new audit engagement.

pub fn with_materiality( self, materiality: Decimal, performance_materiality_factor: f64, clearly_trivial_factor: f64, basis: &str, percentage: f64, ) -> Self

Set materiality values.

pub fn with_team( self, partner_id: &str, partner_name: &str, manager_id: &str, manager_name: &str, team_members: Vec<String>, ) -> Self

Set the engagement team.

pub fn with_timeline( self, planning_start: NaiveDate, planning_end: NaiveDate, fieldwork_start: NaiveDate, fieldwork_end: NaiveDate, completion_start: NaiveDate, report_date: NaiveDate, ) -> Self

Set engagement timeline.

pub fn advance_phase(&mut self)

Advance to the next phase.

pub fn is_complete(&self) -> bool

Check if the engagement is complete.

pub fn days_until_report(&self, as_of: NaiveDate) -> i64

Calculate days until report date.

Trait Implementations

impl Clone for AuditEngagement

fn clone(&self) -> AuditEngagement

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AuditEngagement

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AuditEngagement

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for AuditEngagement

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl ToNodeProperties for AuditEngagement

fn node_type_name(&self) -> &'static str

Entity type name (snake_case), e.g. "uncertain_tax_position".

fn node_type_code(&self) -> u16

Numeric entity type code for registry, e.g. 416.

fn to_node_properties(&self) -> HashMap<String, GraphPropertyValue>

Convert all fields to a property map with camelCase keys.