Data Contracts

4 contracts across 1 domains

Data Contract

exploration-traceability-explored-id
Open Data Contract Standard v3.1.0

Fundamentals

Basic information about the data contract

Name
Traceability Explored
Version
1.0.0
Status
active
Tenant
FairlyMade
Purpose
Retrieve traceability data for the customer's product either collected from the customer or from the supplier during a supplier data collection.
Usage
Exposes traceability data through the App Extracts.
Limitations
Provides near-real time data

Entity Relationship Diagram

Visual representation of data model relationships

                    erDiagram
	"**traceability_mart**" {
	id🔑🔒 string
	registry_customer_id string
	registry_customer_id_hash integer
	collection string
	color_code string
	brand_product_id🔒 string
	product_name string
	product_ref string
	product_unique_identifier string
	purchase_order string
	product_category string
	product_weight number
	declared_suppliers array
	step_id string
	traceability_step string
	declaration_source string
	item_id string
	step_index string
	item_type string
	item_category string
	item_unique_identifier string
	item_certifications string
	component_category string
	component_unique_identifier string
	raw_material string
	material_percentage number
	step_supplier object
	step_country string
	km_to_next_step number
	transports_to_next_steps object
	supplier_certifications string
	traceability_start_date timestamp
	theoretical_traceability_end_date timestamp
	last_traceability_update timestamp
	is_rearchi boolean
}

Schema

The data schema and structure

traceability_mart table
This table contains all the production processes of a product analyzed by Fairly Made Each row corresponds to a step. A step is for instance "SPINNING", "MANUFACTURING", ... A step can be applied at product level, component level or material level
Granularity: One row per customer product, item and traceability step
Property Business Name Type Required Description
id
Primary Key 		-
string
 Yes Unique identifier (generated by Fairly Made) traceabillity step. It corresponds to the concatenation of the legacy study id, the item index and the step id
registry_customer_id
 -
string
 Yes Unique registry identifier (generated by Fairly Made) of the customer
registry_customer_id_hash
 -
integer
 Yes Customer hash of the registry customer unique identifier
collection
 -
string
 Yes Name of the collection the product belongs to
color_code
 -
string
 No Color of the product, as declared by the customer
brand_product_id
 -
string
 Yes Unique identifier (generated by Fairly Made) of the product. It corresponds to the legacy study id
product_name
 -
string
 No Name of the product
product_ref
 -
string
 No Reference of the product in the customer's system
product_unique_identifier
 -
string
 No Unique identifier of the product
purchase_order
 -
string
 No Purchase order number of the product, as declared by the customer or the supplier
product_category
 -
string
 Yes The category of product, according to Fairly Made taxonomy
product_weight
 -
number
 No Weight of the product
declared_suppliers
 -
array
 No Suppliers of the product, as declared by the customer
  ↳ items
 -
object
 No -
    ↳ supplier_id
 -
string
 No Unique identifier (generated by Fairly Made) of the supplier
    ↳ name
 -
string
 No Name of the declared supplier
    ↳ ref
 -
string
 No Declared supplier reference in the customer systems
step_id
 -
string
 No Unique identifier (generated by Fairly Made) of the supply chain step
traceability_step
 -
string
 No Name of the process, according to Fairly Made taxonomy
declaration_source
 -
string
 No Source of the declaration. Coded from 01 (peer-to-peer verified) to 04 (industry knowledge), reflecting the data hierarchy for the rearchi
item_id
 -
string
 No Unique identifier (generated by Fairly Made) of the product, component or material
step_index
 -
string
 No The position of the step in the chain. Th numbers represents the position of the item and the letter the position of the step regarding the item
item_type
 -
string
 No The type of the item. Can be MATERIAL, COMPONENT or PRODUCT
item_category
 -
string
 No Category of the item, according to Fairly Made taxonomy
item_unique_identifier
 -
string
 No Unique identifier of the item, NULL for the legacy
item_certifications
 -
string
 No Transaction certificates of the item
component_category
 -
string
 No Category of the first component after the PRODUCT to COMPONENT scope change, according to Fairly Made taxonomy
component_unique_identifier
 -
string
 No Unique identifier of the first component after the PRODUCT to COMPONENT scope change
raw_material
 -
string
 No Name of the first material after the COMPONENT to MATERIAL scope change, according to Fairly Made taxonomy
material_percentage
 -
number
 No Percentage of the first material after the COMPONENT to MATERIAL scope change in the component
step_supplier
 -
object
 No Supplier that performs the step. Empty if the supplier is not known
  ↳ supplier_id
 -
string
 No Unique identifier (generated by Fairly Made) of the supplier that performs the step
  ↳ name
 -
string
 No Name of the supplier that performs the step
  ↳ external_ref
 -
string
 No Supplier that performs the step reference in the customer systems
step_country
 -
string
 No Country where the step is performed, can be different from the supplier country, if declared as so
km_to_next_step
 -
number
 No Total distance travelled between the step and the next step
transports_to_next_steps
 -
object
 No The type of transport and the distance travelled between the step and the next step
supplier_certifications
 -
string
 No Scope certificates of the supplier that performs the step
traceability_start_date
 -
timestamp
 No Date and time when the supplier data collection started
theoretical_traceability_end_date
 -
timestamp
 No Theoretical date and time when the supplier data collection ends, it is 49 days after the start
last_traceability_update
 -
timestamp
 Yes Date and time when the traceability was last updated in operational database
is_rearchi
 -
boolean
 Yes True if the product comes from the rearchi data

Support

Support channels and resources

  • #tech-support

    slack

Team

Team members and their roles

Exploration Squad
Providing access to customers and end-customers to aggregated data. Helping our customers to take data-driven decisions thanks to data visualisation, interaction and ecodesign scenarios.
Username Role Date In Date Out Comment
Martin Boby Product Manager 2026-01-01 - -
Alice Haupais Tech Lead 2026-01-01 - -
Charlie Beltran Analytics Engineer 2026-01-01 - -
Gustave Constans Software Engineer 2026-01-01 - -

Servers

Infrastructure servers of the data contract

  • Server
    dev
    Type
    bigquery
    Project
    fairlymade-data-platform-dev
    Dataset
    dev_exploration_traceability_explored
    Location
    europe-west1
  • Server
    stg
    Type
    bigquery
    Project
    fairlymade-data-platform-dev
    Dataset
    stg_exploration_traceability_explored
    Location
    europe-west1
  • Server
    prd
    Type
    bigquery
    Project
    fairlymade-data-platform-prd
    Dataset
    exploration_traceability_explored
    Location
    europe-west1
  • Server
    sandbox
    Type
    bigquery
    Project
    fairlymade-data-platform-dev
    Dataset
    data_product_dataset
    Location
    europe-west1
Created at 27 May 2026 15:46:57 UTC with Data Contract CLI v0.11.1

Data Contract YAML

version: 1.0.0
kind: DataContract
apiVersion: v3.1.0
id: exploration-traceability-explored-id
name: Traceability Explored
tenant: FairlyMade
tags: []
status: active
servers:
- server: dev
  type: bigquery
  dataset: dev_exploration_traceability_explored
  location: europe-west1
  project: fairlymade-data-platform-dev
- server: stg
  type: bigquery
  dataset: stg_exploration_traceability_explored
  location: europe-west1
  project: fairlymade-data-platform-dev
- server: prd
  type: bigquery
  dataset: exploration_traceability_explored
  location: europe-west1
  project: fairlymade-data-platform-prd
- server: sandbox
  type: bigquery
  dataset: data_product_dataset
  location: europe-west1
  project: fairlymade-data-platform-dev
description:
  usage: Exposes traceability data through the App Extracts.
  purpose: Retrieve traceability data for the customer's product either collected
    from the customer or from the supplier during a supplier data collection.
  limitations: Provides near-real time data
domain: exploration
schema:
- name: traceability_mart
  physicalType: table
  description: 'This table contains all the production processes of a product analyzed
    by Fairly Made

    Each row corresponds to a step. A step is for instance "SPINNING", "MANUFACTURING",
    ...

    A step can be applied at product level, component level or material level

    '
  tags:
  - exploration
  - traceability_explored
  dataGranularityDescription: One row per customer product, item and traceability
    step
  properties:
  - name: id
    description: Unique identifier (generated by Fairly Made) traceabillity step.
      It corresponds to the concatenation of the legacy study id, the item index and
      the step id
    primaryKey: true
    logicalType: string
    required: true
    unique: true
  - name: registry_customer_id
    description: Unique registry identifier (generated by Fairly Made) of the customer
    logicalType: string
    required: true
    unique: false
  - name: registry_customer_id_hash
    description: Customer hash of the registry customer unique identifier
    logicalType: integer
    required: true
    unique: false
  - name: collection
    description: Name of the collection the product belongs to
    logicalType: string
    required: true
    unique: false
  - name: color_code
    description: Color of the product, as declared by the customer
    logicalType: string
    required: false
    unique: false
  - name: brand_product_id
    description: Unique identifier (generated by Fairly Made) of the product. It corresponds
      to the legacy study id
    logicalType: string
    required: true
    unique: true
  - name: product_name
    description: Name of the product
    logicalType: string
    required: false
    unique: false
  - name: product_ref
    description: Reference of the product in the customer's system
    logicalType: string
    required: false
    unique: false
  - name: product_unique_identifier
    description: Unique identifier of the product
    logicalType: string
    required: false
    unique: false
  - name: purchase_order
    description: Purchase order number of the product, as declared by the customer
      or the supplier
    logicalType: string
    required: false
    unique: false
  - name: product_category
    description: The category of product, according to Fairly Made taxonomy
    logicalType: string
    required: true
    unique: false
  - name: product_weight
    description: Weight of the product
    logicalType: number
    required: false
    unique: false
  - name: declared_suppliers
    description: Suppliers of the product, as declared by the customer
    logicalType: array
    required: false
    unique: false
    items:
      logicalType: object
      properties:
      - name: supplier_id
        description: Unique identifier (generated by Fairly Made) of the supplier
        logicalType: string
      - name: name
        description: Name of the declared supplier
        logicalType: string
      - name: ref
        description: Declared supplier reference in the customer systems
        logicalType: string
  - name: step_id
    description: Unique identifier (generated by Fairly Made) of the supply chain
      step
    logicalType: string
    required: false
    unique: false
  - name: traceability_step
    description: Name of the process, according to Fairly Made taxonomy
    logicalType: string
    required: false
    unique: false
  - name: declaration_source
    description: Source of the declaration. Coded from 01 (peer-to-peer verified)
      to 04 (industry knowledge), reflecting the data hierarchy for the rearchi
    logicalType: string
    required: false
    unique: false
  - name: item_id
    description: Unique identifier (generated by Fairly Made) of the product, component
      or material
    logicalType: string
    required: false
    unique: false
  - name: step_index
    description: The position of the step in the chain. Th numbers represents the
      position of the item and the letter the position of the step regarding the item
    logicalType: string
    required: false
    unique: false
  - name: item_type
    description: The type of the item. Can be MATERIAL, COMPONENT or PRODUCT
    logicalType: string
    required: false
    unique: false
  - name: item_category
    description: Category of the item, according to Fairly Made taxonomy
    logicalType: string
    required: false
    unique: false
  - name: item_unique_identifier
    description: Unique identifier of the item, NULL for the legacy
    logicalType: string
    required: false
    unique: false
  - name: item_certifications
    description: Transaction certificates of the item
    logicalType: string
    required: false
    unique: false
  - name: component_category
    description: Category of the first component after the PRODUCT to COMPONENT scope
      change, according to Fairly Made taxonomy
    logicalType: string
    required: false
    unique: false
  - name: component_unique_identifier
    description: Unique identifier of the first component after the PRODUCT to COMPONENT
      scope change
    logicalType: string
    required: false
    unique: false
  - name: raw_material
    description: Name of the first material after the COMPONENT to MATERIAL scope
      change, according to Fairly Made taxonomy
    logicalType: string
    required: false
    unique: false
  - name: material_percentage
    description: Percentage of the first material after the COMPONENT to MATERIAL
      scope change in the component
    logicalType: number
    required: false
    unique: false
  - name: step_supplier
    description: Supplier that performs the step. Empty if the supplier is not known
    logicalType: object
    required: false
    unique: false
    properties:
    - name: supplier_id
      description: Unique identifier (generated by Fairly Made) of the supplier that
        performs the step
      logicalType: string
    - name: name
      description: Name of the supplier that performs the step
      logicalType: string
    - name: external_ref
      description: Supplier that performs the step reference in the customer systems
      logicalType: string
  - name: step_country
    description: Country where the step is performed, can be different from the supplier
      country, if declared as so
    logicalType: string
    required: false
    unique: false
  - name: km_to_next_step
    description: Total distance travelled between the step and the next step
    logicalType: number
    required: false
    unique: false
  - name: transports_to_next_steps
    description: The type of transport and the distance travelled between the step
      and the next step
    logicalType: object
    required: false
    unique: false
  - name: supplier_certifications
    description: Scope certificates of the supplier that performs the step
    logicalType: string
    required: false
    unique: false
  - name: traceability_start_date
    description: Date and time when the supplier data collection started
    logicalType: timestamp
    required: false
    unique: false
  - name: theoretical_traceability_end_date
    description: Theoretical date and time when the supplier data collection ends,
      it is 49 days after the start
    logicalType: timestamp
    required: false
    unique: false
  - name: last_traceability_update
    description: Date and time when the traceability was last updated in operational
      database
    logicalType: timestamp
    required: true
    unique: false
  - name: is_rearchi
    description: True if the product comes from the rearchi data
    logicalType: boolean
    required: true
    unique: false
support:
- channel: '#tech-support'
  tool: slack
team:
  name: Exploration Squad
  description: Providing access to customers and end-customers to aggregated data.  Helping
    our customers to take data-driven decisions thanks to data visualisation, interaction
    and ecodesign scenarios.
  members:
  - username: Martin Boby
    role: Product Manager
    dateIn: '2026-01-01'
  - username: Alice Haupais
    role: Tech Lead
    dateIn: '2026-01-01'
  - username: Charlie Beltran
    role: Analytics Engineer
    dateIn: '2026-01-01'
  - username: Gustave Constans
    role: Software Engineer
    dateIn: '2026-01-01'

Data Contract YAML

version: 1.0.0
kind: DataContract
apiVersion: v3.1.0
id: exploration-supplier-explored-id
name: Supplier Explored
tenant: FairlyMade
tags: []
status: active
servers:
- server: dev
  type: bigquery
  dataset: dev_data_product_dataset
  location: europe-west1
  project: fairlymade-data-platform-dev
- server: stg
  type: bigquery
  dataset: stg_data_product_dataset
  location: europe-west1
  project: fairlymade-data-platform-dev
- server: prd
  type: bigquery
  dataset: data_product_dataset
  location: europe-west1
  project: fairlymade-data-platform-prd
- server: sandbox
  type: bigquery
  dataset: data_product_dataset
  location: europe-west1
  project: fairlymade-data-platform-dev
description:
  usage: Exposes product explored to several interfaces (App Suppliers Table, Extracts,
    SCI).
  purpose: Supplier data for the customer's suppliers. A supplier corresponds to an
    entity who performs a process on a product, on a component, or on a material belonging
    to the customer's brand product OR a supplier declared by the customer.
  limitations: Provides near-real time data
domain: exploration
schema:
- name: table_1
  physicalType: table
  description: One line by element treated
  businessName: Master Data
  tags:
  - customer
  properties:
  - name: id
    description: Unique identifier of element
    primaryKey: true
    logicalType: string
    required: true
    unique: true
    classification: restricted
  - name: name
    description: The name of the element
    logicalType: string
    required: true
    unique: false
    classification: public
    quality:
    - type: sql
      mustBeLessThan: 1000
      query: 'SELECT COUNT(*) FROM {object} WHERE {property} IS NOT NULL

        '
- name: table_2
  physicalType: table
  description: A element that display costs of the element
  dataGranularityDescription: Aggregation on columns ref
  properties:
  - name: id
    description: Unique identifier of element
    tags:
    - uid
    primaryKey: true
    primaryKeyPosition: 1
    logicalType: string
    required: true
    unique: true
  - name: table_1_id
    description: Link to table_1
    primaryKey: true
    primaryKeyPosition: 2
    logicalType: string
    required: false
    unique: false
    classification: public
    relationships:
    - type: foreignKey
      to: table_1.id
  - name: business_date
    description: The business date of the element
    logicalType: timestamp
    required: true
    classification: public
    transformSourceObjects:
    - table_name_1
    - table_name_2
    - table_name_3
    transformLogic: COALESCE(table_name_1.business_date, table_name_2.business_date,
      table_name_3.business_date)
    transformDescription: defines the logic in business terms; logic for dummies
    quality:
    - businessImpact: operational
      description: column should not contain null values
      severity: error
      type: library
      metric: nullValues
      mustBe: 0
  relationships:
  - type: foreignKey
    from:
    - table_1.id
    to:
    - table_2.table_1_id
    customProperties:
    - property: description
      value: Composite key linking to table_1 table
    - property: cardinality
      value: many-to-one
support:
- channel: '#tech-support'
  tool: slack
team:
  name: Exploration Squad
  description: Providing access to customers and end-customers to aggregated data.  Helping
    our customers to take data-driven decisions thanks to data visualisation, interaction
    and ecodesign scenarios.
  members:
  - username: Martin Boby
    role: Product Manager
    dateIn: '2026-01-01'
  - username: Alice Haupais
    role: Tech Lead
    dateIn: '2026-01-01'
  - username: Charlie Beltran
    role: Analytics Engineer
    dateIn: '2026-01-01'
  - username: Gustave Constans
    role: Software Engineer
    dateIn: '2026-01-01'

Data Contract YAML

version: 1.0.0
kind: DataContract
apiVersion: v3.1.0
id: exploration-agec-explored-id
name: AGEC Explored
tenant: FairlyMade
tags: []
status: active
servers:
- server: dev
  type: bigquery
  dataset: dev_exploration_agec_explored
  location: europe-west1
  project: fairlymade-data-platform-dev
- server: stg
  type: bigquery
  dataset: stg_exploration_agec_explored
  location: europe-west1
  project: fairlymade-data-platform-dev
- server: prd
  type: bigquery
  dataset: exploration_agec_explored
  location: europe-west1
  project: fairlymade-data-platform-prd
- server: sandbox
  type: bigquery
  dataset: data_product_dataset
  location: europe-west1
  project: fairlymade-data-platform-dev
description:
  usage: Exposes agec results through the App Extracts.
  purpose: AGEC results for the customer's products. Each row corresponds to either
    a product-component pair for ready-to-wear products or a product for shoe products.
  limitations: Provides near-real time data
domain: exploration
schema:
- name: agec_mart
  physicalType: table
  description: This table contains the agec results of all products and components
    analyzed by Fairly Made
  tags:
  - exploration
  - agec_explored
  dataGranularityDescription: One line by either a product-component pair for ready-to-wear
    products or a product for shoe products
  properties:
  - name: id
    description: Unique identifier (generated by Fairly Made) of the product. It corresponds
      to the legacy study id
    primaryKey: true
    logicalType: string
    required: true
    unique: true
  - name: registry_customer_id
    description: Unique registry identifier (generated by Fairly Made) of the customer
    logicalType: string
    required: true
    unique: false
  - name: registry_customer_id_hash
    description: Customer hash of the registry customer unique identifier
    logicalType: integer
    required: true
    unique: false
  - name: collection
    description: Name of the collection the product belongs to
    logicalType: string
    required: true
    unique: false
  - name: product_name
    description: Name of the product
    logicalType: string
    required: false
    unique: false
  - name: product_ref
    description: Reference of the product in the customer's system
    logicalType: string
    required: false
    unique: false
  - name: color_code
    description: Color of the product, as declared by the customer
    logicalType: string
    required: false
    unique: false
  - name: brand_product_id
    description: Unique identifier (generated by Fairly Made) of the product. It corresponds
      to the legacy study id
    logicalType: string
    required: true
    unique: false
  - name: purchase_order
    description: Purchase order number of the product, as declared by the customer
      or the supplier
    logicalType: string
    required: false
    unique: false
  - name: product_weight
    description: Weight of the product
    logicalType: number
    required: false
    unique: false
  - name: product_category
    description: The category of product, according to Fairly Made taxonomy
    logicalType: string
    required: true
    unique: false
  - name: product_unique_identifier
    description: Unique identifier of the product
    logicalType: string
    required: false
    unique: false
  - name: traceability_status
    description: The status of the analysis
    logicalType: string
    required: false
    unique: false
  - name: component_id
    description: Unique registry identifier (generated by Fairly Made) of the component
    logicalType: string
    required: false
    unique: false
  - name: component_unique_identifier
    description: Unique identifier of the component
    logicalType: string
    required: false
    unique: false
  - name: component_category
    description: The category of component, according to Fairly Made taxonomy
    logicalType: string
    required: false
    unique: false
  - name: composition
    logicalType: array
    items:
      description: Composition of the component
      logicalType: object
      required: false
      unique: false
      properties:
      - name: raw_material
        description: Material in the component
        logicalType: string
      - name: percentage
        description: Percentage of the material in the component
        logicalType: number
  - name: country
    description: Country where the step is performed, can be different from the supplier
      country, if declared as so
    logicalType: object
    required: false
    unique: false
    properties:
    - name: manufacturing
      description: ISO code of the countries where the manufacturing is performed
      logicalType: string
    - name: printing
      description: ISO code of the countries where the printing is performed
      logicalType: string
    - name: dyeing
      description: ISO code of the countries where the dyeing is performed
      logicalType: string
    - name: knitting
      description: ISO code of the countries where the knitting is performed
      logicalType: string
    - name: weaving
      description: ISO code of the countries where the weaving is performed
      logicalType: string
    - name: non_woven
      description: ISO code of the countries where the non-woven processing is performed
      logicalType: string
    - name: assembly
      description: ISO code of the countries where the assembly is performed
      logicalType: string
    - name: finishing
      description: ISO code of the countries where the finishing is performed
      logicalType: string
    - name: stitching
      description: ISO code of the countries where the stitching is performed
      logicalType: string
  - name: microplastics_percentage
    description: Percentage of synthetic fibers in the product
    logicalType: number
    required: true
    unique: false
  - name: recycled_materials_percentage
    description: Percentage of recycled materials in the product
    logicalType: number
    required: true
    unique: false
  - name: eco_modulation
    description: Eco-modulation of the product as declared by the customer, following
      the Fairly Made taxonomy
    logicalType: string
    required: false
    unique: false
  - name: component_in_agec_scope
    description: True if the component is concerned by AGEC
    logicalType: boolean
    required: false
    unique: false
  - name: component_agec_compliant
    description: True if the component is compliant regarding the traceability for
      AGEC
    logicalType: boolean
    required: false
    unique: false
  - name: product_in_agec_scope
    description: True if the product is concerned by AGEC
    logicalType: boolean
    required: true
    unique: false
  - name: product_agec_compliant
    description: True if the product is compliant regarding the traceability for AGEC
    logicalType: boolean
    required: false
    unique: false
  - name: traceability_start_date
    description: Date and time when the supplier data collection started
    logicalType: timestamp
    required: false
    unique: false
  - name: theoretical_traceability_end_date
    description: Theoretical date and time when the supplier data collection ends,
      it is 49 days after the start
    logicalType: timestamp
    required: false
    unique: false
  - name: is_rearchi
    description: True if the product comes from the rearchi data
    logicalType: boolean
    required: true
    unique: false
support:
- channel: '#tech-support'
  tool: slack
team:
  name: Exploration Squad
  description: Providing access to customers and end-customers to aggregated data.  Helping
    our customers to take data-driven decisions thanks to data visualisation, interaction
    and ecodesign scenarios.
  members:
  - username: Martin Boby
    role: Product Manager
    dateIn: '2026-01-01'
  - username: Alice Haupais
    role: Tech Lead
    dateIn: '2026-01-01'
  - username: Charlie Beltran
    role: Analytics Engineer
    dateIn: '2026-01-01'
  - username: Gustave Constans
    role: Software Engineer
    dateIn: '2026-01-01'

Data Contract YAML

version: 1.0.0
kind: DataContract
apiVersion: v3.1.0
id: exploration-product-explored-id
name: Product Explored
tenant: FairlyMade
tags: []
status: active
servers:
- server: dev
  type: bigquery
  dataset: dev_exploration_product_explored
  location: europe-west1
  project: fairlymade-data-platform-dev
- server: stg
  type: bigquery
  dataset: stg_exploration_product_explored
  location: europe-west1
  project: fairlymade-data-platform-dev
- server: prd
  type: bigquery
  dataset: exploration_product_explored
  location: europe-west1
  project: fairlymade-data-platform-prd
- server: sandbox
  type: bigquery
  dataset: data_product_dataset
  location: europe-west1
  project: fairlymade-data-platform-dev
description:
  usage: Exposes product explored to several interfaces (App Products Table, Extracts)
  purpose: Product with its Analysis, its Supply Chain and its Supply Chain Analysis
    considered as the truth for the customer at a current time
  limitations: Provides near-real time data
domain: exploration
schema:
- name: products_mart
  physicalType: table
  description: This table contains all products analyzed by Fairly Made
  tags:
  - exploration
  - product_explored
  dataGranularityDescription: One row per customer product
  properties:
  - name: id
    description: Unique identifier (generated by Fairly Made) of the product
    primaryKey: true
    logicalType: string
    required: true
    unique: true
  - name: unique_identifier
    description: Unique identifier of the product
    logicalType: string
    required: false
    unique: false
  - name: collection
    description: Name of the collection the product belongs to
    logicalType: string
    required: true
    unique: false
  - name: registry_customer_id
    description: Unique registry identifier (generated by Fairly Made) of the customer
    logicalType: string
    required: true
    unique: false
  - name: registry_customer_id_hash
    description: Customer hash of the registry customer unique identifier
    logicalType: integer
    required: true
    unique: false
  - name: product_name
    description: Name of the product
    logicalType: string
    required: false
    unique: false
  - name: product_ref
    description: Reference of the product in the customer's system
    logicalType: string
    required: false
    unique: false
  - name: product_public_name
    description: Name of the product, as displayed to the final customer (website,
      hangtag, ...)
    logicalType: object
    required: false
    unique: false
    properties:
    - name: en
      description: Name of the product (EN)
      logicalType: string
    - name: fr
      description: Name of the product (FR)
      logicalType: string
    - name: it
      description: Name of the product (IT)
      logicalType: string
    - name: es
      description: Name of the product (ES)
      logicalType: string
  - name: color_code
    description: Color of the product, as declared by the customer
    logicalType: string
    required: false
    unique: false
  - name: purchase_order
    description: Purchase order number of the product, as declared by the customer
      or the supplier
    logicalType: string
    required: false
    unique: false
  - name: gtins
    description: Global Trade Item Numbers of the product. There are multiple GTINs
      per product because of the different product formats
    logicalType: array
    required: false
    unique: false
    items:
      logicalType: string
  - name: product_category
    description: The category of product, according to Fairly Made taxonomy
    logicalType: string
    required: true
    unique: false
  - name: product_weight
    description: Weight of the product
    logicalType: number
    required: false
    unique: false
  - name: number_of_components
    description: Number of components in the product
    logicalType: integer
    required: false
    unique: false
  - name: components_categories
    description: Categories of the components in the product
    logicalType: array
    required: false
    unique: false
    items:
      logicalType: string
  - name: number_of_materials
    description: Number of materials in the product
    logicalType: integer
    required: false
    unique: false
  - name: materials
    description: Materials in the product
    logicalType: array
    required: false
    unique: false
    items:
      logicalType: string
  - name: composition
    description: The composition of the product, component per component
    logicalType: string
    required: false
    unique: false
  - name: declared_suppliers
    description: Suppliers of the product, as declared by the customer
    logicalType: array
    required: false
    unique: false
    items:
      logicalType: object
      properties:
      - name: supplier_id
        description: Unique identifier (generated by Fairly Made) of the supplier
        logicalType: string
      - name: name
        description: Name of the declared supplier
        logicalType: string
      - name: ref
        description: Declared supplier reference in the customer systems
        logicalType: string
  - name: produced_quantity
    description: Quantity produced of the product
    logicalType: object
    required: false
    unique: false
    properties:
    - name: amount
      description: Amount of quantity produced of the product
      logicalType: number
    - name: unit
      description: Unit of quantity produced of the product
      logicalType: string
    - name: is_produced_quantity_from_customer_settings
      description: True if the produced quantity is the default value set in the customer
        setting
      logicalType: boolean
  - name: product_certifications
    description: Standard of the product certificates, according to Fairly Made taxonomy
      (e.g. GOTS)
    logicalType: array
    required: false
    unique: false
    items:
      logicalType: string
  - name: market_segment
    description: Market segment of the product (Menswear, Womenswear...)
    logicalType: string
    required: false
    unique: false
  - name: eco_modulation
    description: Eco-modulation of the product as declared by the customer, following
      the Fairly Made taxonomy
    logicalType: string
    required: false
    unique: false
  - name: product_status
    description: The status of the analysis
    logicalType: string
    required: false
    unique: false
  - name: product_picture
    description: URL of the product picture
    logicalType: string
    required: false
    unique: false
  - name: qr_code_link_ref
    description: Ref of the QR Code showcase link of the product
    logicalType: string
    required: false
    unique: false
  - name: web_link_ref
    description: Ref of the web showcase link of the product
    logicalType: string
    required: false
    unique: false
  - name: is_dpp_activated
    description: True if the showcase has been published
    logicalType: boolean
    required: false
    unique: false
  - name: traceability_start_date
    description: Date and time when the supplier data collection started
    logicalType: timestamp
    required: false
    unique: false
  - name: theoretical_traceability_end_date
    description: Theoretical date and time when the supplier data collection ends,
      it is 49 days after the start
    logicalType: timestamp
    required: false
    unique: false
  - name: created_at
    description: Date and time when the record was created in operational database
    logicalType: timestamp
    required: true
    unique: false
  - name: updated_at
    description: Date and time when the record was updated in operational database
    logicalType: timestamp
    required: true
    unique: false
  - name: is_rearchi
    description: True if the product comes from the rearchi data
    logicalType: boolean
    required: true
    unique: false
- name: products_analysis_mart
  physicalType: table
  description: This table contains the analysis of all products analyzed by Fairly
    Made
  tags:
  - exploration
  - product_explored
  dataGranularityDescription: One row per customer product
  properties:
  - name: id
    description: Unique identifier (generated by Fairly Made) of the product
    primaryKey: true
    logicalType: string
    required: true
    unique: true
  - name: unique_identifier
    description: Unique identifier of the product
    logicalType: string
    required: false
    unique: false
  - name: collection
    description: Name of the collection the product belongs to
    logicalType: string
    required: true
    unique: false
  - name: registry_customer_id
    description: Unique registry identifier (generated by Fairly Made) of the customer
    logicalType: string
    required: true
    unique: false
  - name: registry_customer_id_hash
    description: Customer hash of the registry customer unique identifier
    logicalType: integer
    required: true
    unique: false
  - name: lca_fr
    description: PEF impacts of the Life Cycle Assessment calculated with the LCAll
      tool
    logicalType: object
    required: false
    unique: false
    properties:
    - name: acidification
      description: Value of the impact of an analysis calculated with the ADEME methodology
        v.2025 on acidification
      logicalType: number
    - name: climate_change_biogenic
      description: Value of the impact of an analysis calculated with the ADEME methodology
        v.2025 on biogenic climate change
      logicalType: number
    - name: climate_change_fossil
      description: Value of the impact of an analysis calculated with the ADEME methodology
        v.2025 on fossil climate change
      logicalType: number
    - name: climate_change
      description: Value of the impact of an analysis calculated with the ADEME methodology
        v.2025 on climate change
      logicalType: number
    - name: climate_change_land_use
      description: Value of the impact of an analysis calculated with the ADEME methodology
        v.2025 on land use climate change
      logicalType: number
    - name: ecotoxicity_fresh_water
      description: Value of the impact of an analysis calculated with the ADEME methodology
        v.2025 on fresh water ecotoxicity
      logicalType: number
    - name: particulate_matter
      description: Value of the impact of an analysis calculated with the ADEME methodology
        v.2025 on particulate matter
      logicalType: number
    - name: eutrophication_fresh_water
      description: Value of the impact of an analysis calculated with the ADEME methodology
        v.2025 on fresh water eutrophication
      logicalType: number
    - name: eutrophication_marine
      description: Value of the impact of an analysis calculated with the ADEME methodology
        v.2025 on marine eutrophication
      logicalType: number
    - name: eutrophication_terrestrial
      description: Value of the impact of an analysis calculated with the ADEME methodology
        v.2025 on terrestrial eutrophication
      logicalType: number
    - name: human_toxicity_cancer
      description: Value of the impact of an analysis calculated with the PEF methodology
        on human toxicity, cancer
      logicalType: number
    - name: human_toxicity_non_cancer
      description: Value of the impact of an analysis calculated with the PEF methodology
        on human toxicity, non cancer
      logicalType: number
    - name: ionising_radiation
      description: Value of the impact of an analysis calculated with the ADEME methodology
        v.2025 on ionising radiation
      logicalType: number
    - name: land_use
      description: Value of the impact of an analysis calculated with the ADEME methodology
        v.2025 on land use
      logicalType: number
    - name: ozone_depletion
      description: Value of the impact of an analysis calculated with the ADEME methodology
        v.2025 on ozone depletion
      logicalType: number
    - name: photochemical_ozone_formation
      description: Value of the impact of an analysis calculated with the ADEME methodology
        v.2025 on photochemical ozone formation
      logicalType: number
    - name: resource_use_fossils
      description: Value of the impact of an analysis calculated with the ADEME methodology
        v.2025 on fossils resource use
      logicalType: number
    - name: resource_use_minerals_metals
      description: Value of the impact of an analysis calculated with the ADEME methodology
        v.2025 on minerals metals resource use
      logicalType: number
    - name: water_use
      description: Value of the impact of an analysis calculated with the ADEME methodology
        v.2025 on water use
      logicalType: number
  - name: lca_pef
    description: PEF impacts of the Life Cycle Assessment computed according to the
      PEF methodology
    logicalType: object
    required: false
    unique: false
    properties:
    - name: acidification
      description: Value of the impact of an analysis calculated with the PEF methodology
        on acidification
      logicalType: number
    - name: climate_change
      description: Value of the impact of an analysis calculated with the PEF methodology
        on climate change
      logicalType: number
    - name: ecotoxicity_fresh_water
      description: Value of the impact of an analysis calculated with the PEF methodology
        on fresh water ecotoxicity
      logicalType: number
    - name: particulate_matter
      description: Value of the impact of an analysis calculated with the PEF methodology
        on particulate matter
      logicalType: number
    - name: eutrophication_fresh_water
      description: Value of the impact of an analysis calculated with the PEF methodology
        on fresh water eutrophication
      logicalType: number
    - name: eutrophication_marine
      description: Value of the impact of an analysis calculated with the PEF methodology
        on marine eutrophication
      logicalType: number
    - name: eutrophication_terrestrial
      description: Value of the impact of an analysis calculated with the PEF methodology
        on terrestrial eutrophication
      logicalType: number
    - name: human_toxicity_cancer
      description: Value of the impact of an analysis calculated with the PEF methodology
        on human toxicity, cancer
      logicalType: number
    - name: human_toxicity_non_cancer
      description: Value of the impact of an analysis calculated with the PEF methodology
        on human toxicity, non cancer
      logicalType: number
    - name: ionising_radiation
      description: Value of the impact of an analysis calculated with the PEF methodology
        on ionising radiation
      logicalType: number
    - name: land_use
      description: Value of the impact of an analysis calculated with the PEF methodology
        on land use
      logicalType: number
    - name: ozone_depletion
      description: Value of the impact of an analysis calculated with the PEF methodology
        on ozone depletion
      logicalType: number
    - name: photochemical_ozone_formation
      description: Value of the impact of an analysis calculated with the PEF methodology
        on photochemical ozone formation
      logicalType: number
    - name: resource_use_fossils
      description: Value of the impact of an analysis calculated with the PEF methodology
        on fossils resource use
      logicalType: number
    - name: resource_use_minerals_metals
      description: Value of the impact of an analysis calculated with the PEF methodology
        on minerals metals resource use
      logicalType: number
    - name: water_use
      description: Value of the impact of an analysis calculated with the PEF methodology
        on water use
      logicalType: number
  - name: pef_single_score
    description: It is the result of an impact calculation initiated by the European
      Commission (based on PEFCR Apparel & Footwear 3.1 methodology). The PEF Single
      Score is expressed in micro-points, ensuring high precision in environmental
      scoring
    logicalType: number
    required: false
    unique: false
  - name: traceability_score
    description: The traceability grade of the product
    logicalType: number
    required: false
    unique: false
  - name: fec_declaration
    description: French environmental cost impact declaration of the product lifecycle
    logicalType: object
    required: false
    unique: false
    properties:
    - name: is_french_environmental_cost_published_to_government_platform
      description: True if the french environmental cost has been published to the
        government platform
      logicalType: boolean
    - name: government_platform_publication_date
      description: Date at which the French environmental cost of the product has
        been published
      logicalType: timestamp
    - name: published_french_environmental_cost
      description: Published value of the score in micro points. It is the sum of
        the impact of each sub-step of the product
      logicalType: number
    - name: published_french_environmental_cost_per_100_grams
      description: Published value of the score in micro points. It is the sum of
        the impact of each sub-step of the product for 100g
      logicalType: number
    - name: published_french_environmental_cost_pictogram
      description: Link to the pictogram of the published french environmental cost
      logicalType: string
  - name: fec_calculation
    description: French environmental cost impact calculation of the product lifecycle
    logicalType: object
    required: false
    unique: false
    properties:
    - name: adjusted_duration_service
      description: The number of days this product category is expected to last when
        factoring the reference duration of service and the extrinsic durability coefficient
      logicalType: number
    - name: bonus_malus_service_duration
      description: The difference between the adjusted duration of service and the
        reference duration of service, in days
      logicalType: number
    - name: durability_coefficient
      description: Extrinsic (non-physical) durability coefficient influencing the
        product number of use and lifespan as defined in the French environmental
        cost methodology
      logicalType: number
    - name: company_size
      description: Setting the brand can update to compute the promotion to repair
        coefficient, it is related to the company size
      logicalType: string
    - name: last_calculated_french_environmental_cost
      description: Last calculated value of the score in micro points. It is the sum
        of the impact of each sub-step of the product
      logicalType: number
    - name: last_calculated_french_environmental_cost_per_100_grams
      description: Last calculated value of the score in micro points. It is the sum
        of the impact of each sub-step of the product for 100g
      logicalType: number
    - name: last_calculated_french_environmental_cost_pictogram
      description: Link to the pictogram of the last calculated french environmental
        cost
      logicalType: string
    - name: last_calculated_french_environmental_cost_computation_date
      description: Date at which the last French environmental cost of the product
        has been computed by Fairly Made
      logicalType: timestamp
    - name: edited_by_customer_user_first_name
      description: First name of the user that edited the brand settings
      logicalType: string
    - name: edited_by_customer_user_name
      description: Name of the user that edited the brand settings
      logicalType: string
    - name: fec_brand_settings_edited_at
      description: Date and time when the brand settings was last updated in operational
        database
      logicalType: timestamp
    - name: lca_score
      description: Environmental score obtained solely from the Life Cycle Analysis
      logicalType: number
    - name: market_segment
      description: Market segment of the product (Menswear, Womenswear...)
      logicalType: string
    - name: max_references_number
      description: Setting the brand can update to compute the repair service coefficient,
        it is related to the display of products traceability
      logicalType: number
    - name: microfibers_score
      description: Additional parameter representing the environmental impacts of
        microfibers released from the product during its life cycle
      logicalType: number
    - name: out_of_europe_export_score
      description: Additional parameter representing the environmental impact of product
        ending as wastes exported outside of Europe
      logicalType: number
    - name: is_product_in_legal_scope
      description: True if the product is in the regulation law for the french environmental
        cost display
      logicalType: boolean
    - name: product_market_price
      description: Average selling price of the product category, in euros
      logicalType: number
    - name: product_score
      description: Environmental score obtained from the aggregation of the Life Cycle
        Analysis results
      logicalType: number
    - name: repair_promotion_coefficient
      description: Indicator related to the incentives for product repair. Based on
        the ratio between product price with the average repair costs and the availability
        of repair services from the brand
      logicalType: number
    - name: product_range_coefficient
      description: Indicator related to the maximum number of references used in the
        brand score computation
      logicalType: number
    - name: reference_service_duration
      description: The number of days this product category is expected to last according
        to the french government standards
      logicalType: number
    - name: repair_service
      description: Setting the brand can update to compute the promotion to repair
        coefficient, it is related to the existence of a reparation service
      logicalType: boolean
  - name: lca_calculation
    description: Impact calculation of the product lifecycle with LCAll
    logicalType: object
    required: false
    unique: false
    properties:
    - name: deadstock
      description: Quantity of finished products and semi-finished products (e.g.
        fabrics, yarn) that could not be sold through traditional sales channels,
        in %
      logicalType: number
  - name: lca_created_at
    description: Date and time when the record was created in operational database
    logicalType: timestamp
    required: true
    unique: false
  - name: lca_updated_at
    description: Date and time when the record was updated in operational database
    logicalType: timestamp
    required: true
    unique: false
  - name: is_rearchi
    description: True if the product comes from the rearchi data
    logicalType: boolean
    required: true
    unique: false
- name: products_agec_mart
  physicalType: table
  description: This table contains the agec claims of all products analyzed by Fairly
    Made
  tags:
  - exploration
  - product_explored
  dataGranularityDescription: One row per customer product
  properties:
  - name: id
    description: Unique identifier (generated by Fairly Made) of the product
    primaryKey: true
    logicalType: string
    required: true
    unique: true
  - name: unique_identifier
    description: Unique identifier of the product
    logicalType: string
    required: false
    unique: false
  - name: collection
    description: Name of the collection the product belongs to
    logicalType: string
    required: true
    unique: false
  - name: registry_customer_id
    description: Unique registry identifier (generated by Fairly Made) of the customer
    logicalType: string
    required: true
    unique: false
  - name: registry_customer_id_hash
    description: Customer hash of the registry customer unique identifier
    logicalType: integer
    required: true
    unique: false
  - name: microplastics_percentage
    description: Percentage of synthetic fibers in the product
    logicalType: number
    required: true
    unique: false
  - name: recycled_materials_percentage
    description: Percentage of recycled materials in the product
    logicalType: number
    required: true
    unique: false
  - name: hazardous_substances
    description: Allegation on the presence of hazardous substances in the product,
      if applicable, as declared by the brand
    logicalType: string
    required: false
    unique: false
  - name: is_product_in_agec_scope
    description: True if the product is concerned by the AGEC law
    logicalType: boolean
    required: true
    unique: false
  - name: is_product_agec_compliant
    description: True if the product meets the AGEC requirements regarding traceability
    logicalType: boolean
    required: false
    unique: false
  - name: is_rearchi
    description: True if the product comes from the rearchi data
    logicalType: boolean
    required: true
    unique: false
- name: products_packaging_mart
  physicalType: table
  description: This table contains the packagings of all products analyzed by Fairly
    Made
  tags:
  - exploration
  - product_explored
  dataGranularityDescription: One row per customer product
  properties:
  - name: id
    description: Unique identifier (generated by Fairly Made) of the product
    primaryKey: true
    logicalType: string
    required: true
    unique: true
  - name: unique_identifier
    description: Unique identifier of the product
    logicalType: string
    required: false
    unique: false
  - name: collection
    description: Name of the collection the product belongs to
    logicalType: string
    required: true
    unique: false
  - name: registry_customer_id
    description: Unique registry identifier (generated by Fairly Made) of the customer
    logicalType: string
    required: true
    unique: false
  - name: registry_customer_id_hash
    description: Customer hash of the registry customer unique identifier
    logicalType: integer
    required: true
    unique: false
  - name: packaging
    description: Packagings linked to the product
    logicalType: array
    required: true
    unique: true
    items:
      logicalType: object
      properties:
      - name: id
        description: Unique identifier (generated by Fairly Made) of the packaging
        logicalType: string
      - name: ref
        description: The reference of the packaging in the brand's system, written
          as [account id]_[client ref]
        logicalType: string
      - name: type
        description: Type of the packaging in Fairly Made taxonomy
        logicalType: string
      - name: channel
        description: Distribution channel of the packaging in Fairly Made taxonomy
        logicalType: string
      - name: compostability
        description: Is the packaging compostable, as declared by the brand
        logicalType: string
      - name: eco_modulation
        description: Eco-modulation of the packaging, as declared by the brand
        logicalType: string
      - name: recycled_materials_percentage
        description: Recycled materials in the product, in %
        logicalType: number
      - name: recyclability
        description: Is the packaging recyclable, as declared by the brand
        logicalType: string
      - name: reusability
        description: Is the packaging reusable, as declared by the brand
        logicalType: string
      - name: hazardous_substances_status
        description: Does the package contains hazardous substances, as declared by
          the brand
        logicalType: string
      - name: hazardous_substances_value
        description: The name of the substance the package contains, as declared by
          the brand
        logicalType: string
  - name: is_rearchi
    description: True if the product comes from the rearchi data
    logicalType: boolean
    required: true
    unique: false
support:
- channel: '#tech-support'
  tool: slack
team:
  name: Exploration Squad
  description: Providing access to customers and end-customers to aggregated data.  Helping
    our customers to take data-driven decisions thanks to data visualisation, interaction
    and ecodesign scenarios.
  members:
  - username: Martin Boby
    role: Product Manager
    dateIn: '2026-01-01'
  - username: Alice Haupais
    role: Tech Lead
    dateIn: '2026-01-01'
  - username: Charlie Beltran
    role: Analytics Engineer
    dateIn: '2026-01-01'
  - username: Gustave Constans
    role: Software Engineer
    dateIn: '2026-01-01'