PHP code example of azaharizaman / nexus-aml-compliance

    
        
<?php
require_once('vendor/autoload.php');

/* Start to develop here. Best regards https://php-download.com/ */

    

azaharizaman / nexus-aml-compliance example snippets

use Nexus\AmlCompliance\Services\AmlRiskAssessor;
use Nexus\AmlCompliance\Contracts\AmlRiskAssessorInterface;

// Inject via constructor
public function __construct(
    private readonly AmlRiskAssessorInterface $amlAssessor
) {}

// Assess party risk
$riskScore = $this->amlAssessor->assessParty(
    partyId: 'party-12345'
);

// Get overall score (0-100)
$score = $riskScore->getScore(); // e.g., 75

// Get risk level (HIGH/MEDIUM/LOW)
$level = $riskScore->getRiskLevel(); // RiskLevel::HIGH

// Get risk factors breakdown
$factors = $riskScore->getFactors();
// [
//     'jurisdiction_risk' => 30,
//     'business_type_risk' => 20,
//     'sanctions_match' => 25,
//     'transaction_patterns' => 0
// ]

use Nexus\AmlCompliance\Services\TransactionMonitor;
use Nexus\AmlCompliance\Contracts\TransactionMonitorInterface;

public function __construct(
    private readonly TransactionMonitorInterface $transactionMonitor
) {}

// Monitor transaction
$result = $this->transactionMonitor->monitorTransaction(
    transactionId: 'tx-67890',
    amount: Money::of(50000, 'USD'),
    fromPartyId: 'party-12345',
    toPartyId: 'party-67890',
    transactionDate: new \DateTimeImmutable()
);

if ($result->isSuspicious()) {
    $suspicionReasons = $result->getReasons();
    // ['velocity_anomaly', 'amount_threshold_exceeded', 'high_risk_jurisdiction']
}

use Nexus\AmlCompliance\Services\SarGenerator;
use Nexus\AmlCompliance\Contracts\SarGeneratorInterface;

public function __construct(
    private readonly SarGeneratorInterface $sarGenerator
) {}

// Generate SAR
$sar = $this->sarGenerator->generateSar(
    partyId: 'party-12345',
    reason: 'Unusual transaction patterns detected',
    suspiciousActivities: [
        'Multiple transactions just below $10,000 threshold',
        'Transactions with high-risk jurisdictions',
    ],
    amount: Money::of(45000, 'USD')
);

// SAR 

interface AmlRiskAssessorInterface
{
    /**
     * Assess AML risk for a party
     * 
     * @return AmlRiskScore Risk score (0-100) with factor breakdown
     */
    public function assessParty(string $partyId): AmlRiskScore;
    
    /**
     * Reassess risk for all parties above threshold
     */
    public function reassessHighRiskParties(int $threshold = 70): array;
}

interface TransactionMonitorInterface
{
    /**
     * Monitor transaction for suspicious patterns
     */
    public function monitorTransaction(
        string $transactionId,
        Money $amount,
        string $fromPartyId,
        string $toPartyId,
        \DateTimeImmutable $transactionDate
    ): TransactionMonitoringResult;
}

interface SarGeneratorInterface
{
    /**
     * Generate Suspicious Activity Report
     */
    public function generateSar(
        string $partyId,
        string $reason,
        array $suspiciousActivities,
        Money $amount
    ): SuspiciousActivityReport;
}

// app/Providers/AmlServiceProvider.php
use Nexus\AmlCompliance\Contracts\AmlRiskAssessorInterface;
use App\Repositories\Aml\EloquentAmlRepository;

$this->app->singleton(AmlRiskAssessorInterface::class, function ($app) {
    return new AmlRiskAssessor(
        repository: new EloquentAmlRepository(),
        sanctionsScreener: $app->make(SanctionsScreenerInterface::class),
        logger: $app->make(LoggerInterface::class)
    );
});