Footprints Domain

The Footprints domain handles supply chain impact calculations including modern slavery risk, carbon emissions, and biodiversity metrics.

Data Flow

Key Concepts

Scope Emissions

The platform focuses on Scope 3 emissions (supply chain), but understanding all scopes is important:

Calculation Requirements

To calculate a footprint, a transaction needs three pieces of information:

Transactions missing any of these are skipped in calculations.

ClickHouse Integration

Footprint calculations use ClickHouse for analytical queries (not Neo4j):

Business Rules

1. Country and industry are required for calculation
2. All amounts converted to USD before calculation
3. Historical amounts adjusted for CPI inflation
4. Risk thresholds determine high/medium/low classification
5. Results cached for 60 seconds for performance
6. Satellites are versioned by year; default is latest

Common Operations

Calculating Organisation Footprint

import { CalculateOrganisationFootprint } from '@repo/core';

const useCase = new CalculateOrganisationFootprint();
const footprint = await useCase.execute({
  organisationId: 'org-123',
  year: 2024,
});

// Result includes:
// - modernSlaveryRisk: { impact, intensity, riskLevel }
// - emissions: { impact, intensity, riskLevel }
// - biodiversity: { impact, intensity, riskLevel }

Getting Portfolio Footprint

import { GetPortfolioFootprint } from '@repo/core';

const useCase = new GetPortfolioFootprint();
const portfolio = await useCase.execute({
  accountId: 'account-123',
  filters: { year: 2024, country: 'AU' },
});

Risk Levels

Footprint results include risk classifications:

Related Files