Struct CollusionRing 

pub struct CollusionRing {

    pub ring_id: Uuid,
    pub ring_type: CollusionRingType,
    pub fraud_category: AcfeFraudCategory,
    pub members: Vec<Conspirator>,
    pub formation_date: NaiveDate,
    pub status: RingStatus,
    pub total_stolen: Decimal,
    pub transaction_count: u32,
    pub detection_risk: f64,
    pub behavior: RingBehavior,
    pub active_months: u32,
    pub transaction_ids: Vec<String>,
    pub metadata: HashMap<String, String>,
}

A collusion ring modeling multiple conspirators in a coordinated scheme.

Fields

ring_id: Uuid

Unique ring identifier.

ring_type: CollusionRingType

Type of collusion ring.

fraud_category: AcfeFraudCategory

ACFE fraud category.

members: Vec<Conspirator>

Members of the ring.

formation_date: NaiveDate

Date the ring was formed.

status: RingStatus

Current status.

total_stolen: Decimal

Total amount stolen by the ring.

transaction_count: u32

Number of successful transactions.

detection_risk: f64

Current detection risk (0.0-1.0).

behavior: RingBehavior

Behavioral parameters.

active_months: u32

Months the ring has been active.

transaction_ids: Vec<String>

Transaction IDs associated with this ring.

metadata: HashMap<String, String>

Metadata for tracking.

Implementations

impl CollusionRing

pub fn new( ring_type: CollusionRingType, fraud_category: AcfeFraudCategory, formation_date: NaiveDate, ) -> Self

Creates a new collusion ring.

pub fn add_member(&mut self, conspirator: Conspirator)

Adds a conspirator to the ring.

pub fn size(&self) -> usize

Returns the size of the ring.

pub fn initiators(&self) -> Vec<&Conspirator>

Returns the initiator(s) of the ring.

pub fn executors(&self) -> Vec<&Conspirator>

Returns the executor(s) of the ring.

pub fn approvers(&self) -> Vec<&Conspirator>

Returns the approver(s) of the ring.

pub fn record_transaction( &mut self, amount: Decimal, transaction_id: impl Into<String>, )

Records a successful transaction.

pub fn record_near_miss(&mut self)

Records a near miss event.

pub fn advance_month<R: Rng>(&mut self, rng: &mut R)

Advances the ring by one month.

pub fn detection_difficulty(&self) -> AnomalyDetectionDifficulty

Returns the detection difficulty for this ring.

pub fn avg_share_per_member(&self) -> Decimal

Calculates the average share per member.

pub fn description(&self) -> String

Returns descriptive summary of the ring.

Trait Implementations

impl Clone for CollusionRing

fn clone(&self) -> CollusionRing

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CollusionRing

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CollusionRing

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CollusionRing

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

where __S: Serializer,

Serialize this value into the given Serde serializer.