Data Contracts

5 contracts across 1 domains

Data Contract

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

Fundamentals

Basic information about the data contract

Name
Supplier Explored
Version
1.0.0
Status
active
Tenant
FairlyMade
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.
Usage
Exposes product explored to several interfaces (App Suppliers Table, Extracts, SCI).
Limitations
Provides near-real time data

Entity Relationship Diagram

Visual representation of data model relationships

                    erDiagram
	"**suppliers_mart**" {
	id🔑🔒 string
	registry_customer_id string
	registry_customer_id_hash integer
	supplier_id string
	supplier_name string
	supplier_unique_identifier array
	address object
	supplier_certifications string
	number_of_employees integer
	percentage_of_women integer
	percentage_of_men integer
	production_capacity object
	heat_sources array
	average_heat_consumption object
	average_electricity_consumption object
	electricity_mix array
	number_of_associated_products integer
	declared_by_the_brand boolean
	process array
	has_rearchi_products boolean
}
	"**suppliers_x_products_mart**" {
	id🔑🔒 string
	registry_customer_id string
	registry_customer_id_hash integer
	brand_product_id⌘ string
	supplier_id string
	supplier_unique_identifier string
	supplier_involvement array
	declared_by_the_brand_at array
	is_rearchi boolean
}
	"**scope_certifications_mart**" {
	id🔑🔒⌘ string
	registry_customer_id string
	registry_customer_id_hash integer
	supplier_id string
	scope_certificate array
}

"**products_mart**" ||--o{ "**suppliers_x_products_mart**" : "brand_product_id → id"
"**suppliers_mart**" ||--o{ "**scope_certifications_mart**" : "id → id"

Schema

The data schema and structure

suppliers_mart table
This table contains one row per (customer, supplier) pair, summarizing the supplier's factory information, certifications and the products supplied to the customer
Granularity: One row per customer and supplier
Property Business Name Type Required Description
id
Primary Key 		-
string
 Yes Unique identifier (generated by Fairly Made) of the customer/supplier pair. It corresponds to the concatenation of the registry customer id and the supplier 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
supplier_id
 -
string
 Yes Unique identifier (generated by Fairly Made) of the supplier
supplier_name
 -
string
 No The name of the supplier company
supplier_unique_identifier
 -
array
 No Supplier reference in the brand systems
  ↳ items
 -
string
 No -
address
 -
object
 No The postal address of the supplier company. Empty if unknown
  ↳ street
 -
string
 No Street part of the supplier address. Empty if unknown
  ↳ postal_code
 -
string
 No Postal code part of the supplier address. Empty if unknown
  ↳ city
 -
string
 No City of the supplier. Empty if unknown
  ↳ region
 -
string
 No Region of the supplier address. Empty if unknown
  ↳ country
 -
string
 No Country of the supplier. Empty if unknown
  ↳ latitude
 -
number
 No Latitude of the supplier address
  ↳ longitude
 -
number
 No Longitude of the supplier address
supplier_certifications
 -
string
 No The list of the supplier's certifications with their associated status
number_of_employees
 -
integer
 No The number of employees of the supplier, declared by the supplier itself. Empty if unknown
percentage_of_women
 -
integer
 No The percentage of women employees of the supplier, declared by the supplier itself. Empty if unknown
percentage_of_men
 -
integer
 No The percentage of men employees of the supplier, declared by the supplier itself. Empty if unknown
production_capacity
 -
object
 No Production capacity of the factory, as declared by the supplier
  ↳ value
 -
number
 No Value of the production capacity of the factory
  ↳ unit
 -
string
 No Unit of the production capacity of the factory
  ↳ time_frame
 -
string
 No Time frame of the production capacity of the factory
heat_sources
 -
array
 No The list of heat sources of the factory, as declared by the supplier
  ↳ items
 -
string
 No -
average_heat_consumption
 -
object
 No The average heat consumption of the factory, as declared by the supplier
  ↳ value
 -
number
 No Value of the average heat consumption of the factory
  ↳ unit
 -
string
 No Unit of the average heat consumption of the factory (MJ)
  ↳ time_frame
 -
string
 No Time frame of the average heat consumption of the factory
average_electricity_consumption
 -
object
 No The average electricity consumption of the factory, as declared by the supplier
  ↳ value
 -
number
 No Value of the average electricity consumption of the factory
  ↳ unit
 -
string
 No Unit of the average electricity consumption of the factory (kWh)
  ↳ time_frame
 -
string
 No Time frame of the average electricity consumption of the factory
electricity_mix
 -
array
 No The list of electricity sources of the factory with their associated percentage, as declared by the supplier
  ↳ items
 -
object
 No -
    ↳ source
 -
string
 No Source in the electricity mix
    ↳ percentage
 -
number
 No Proportion of the source in the electricity mix
number_of_associated_products
 -
integer
 No The number of product references the supplier is associated with (either as an agent or as responsible for a step in the production chain)
declared_by_the_brand
 -
boolean
 No True if the supplier has been declared by the brand on at least one product (at any scope, PRODUCT, COMPONENT or MATERIAL)
process
 -
array
 No List of distinct involvement types of the supplier across all its associated products (traceability steps, warehouse)
  ↳ items
 -
string
 No -
has_rearchi_products
 -
boolean
 No True if at least one product associated to this supplier for this customer comes from the rearchi data
suppliers_x_products_mart table
This table contains all the suppliers linked to a product and the source of the relationship
Granularity: One row per supplier and product
Property Business Name Type Required Description
id
Primary Key 		-
string
 Yes Unique identifier (generated by Fairly Made) of the supplier/product relationship. It corresponds to the concatenation of the brand product id and the supplier 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
brand_product_id
 -
string
 Yes Unique identifier (generated by Fairly Made) of the product
supplier_id
 -
string
 Yes Unique identifier (generated by Fairly Made) of the supplier
supplier_unique_identifier
 -
string
 No External reference of the supplier in the customer system
supplier_involvement
 -
array
 No List of involvement types for this supplier on the product (traceability steps, warehouse)
  ↳ items
 -
string
 No -
declared_by_the_brand_at
 -
array
 No List of scopes at which the brand declared this supplier (PRODUCT, COMPONENT, MATERIAL)
  ↳ items
 -
string
 No -
is_rearchi
 -
boolean
 Yes True if the product comes from the rearchi data
scope_certifications_mart table
This table contains one row per (customer, supplier) pair, aggregating all the scope certifications (at supplier level) declared for that supplier
Granularity: One row per customer and supplier
Property Business Name Type Required Description
id
Primary Key 		-
string
 Yes Unique identifier (generated by Fairly Made) of the customer/supplier pair. It corresponds to the concatenation of the registry customer id and the supplier 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
supplier_id
 -
string
 Yes Unique identifier (generated by Fairly Made) of the supplier
scope_certificate
 -
array
 No The list of the supplier's scope certifications with their associated status
  ↳ items
 -
object
 No -
    ↳ certification_id
 -
string
 No Unique identifier (generated by Fairly Made) of the certification
    ↳ standard
 -
string
 No Standard of the certificate, according to Fairly Made taxonomy (e.g. GOTS)
    ↳ validity_start_date
 -
timestamp
 No Start date of the certificate validity
    ↳ validity_end_date
 -
timestamp
 No End date of the certificate validity
    ↳ status
 -
string
 No Status of the certificate
    ↳ created_at
 -
timestamp
 No Date and time when the record was created in operational database

Support

Support channels and resources

  • #tech-support

    slack

Team

Team members and their roles

Blooming 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 2023-12-11 - -
Noémie Flajolet Product Manager 2020-08-24 - -
Alice Haupais Tech Lead 2024-04-08 - -
Charlie Beltran Analytics Engineer 2023-09-18 - -
Gustave Constans Software Engineer 2022-11-07 - -
Thibaud Giboury Software Engineer 2023-02-06 - -
Pierre Barbaroux Software Engineer 2024-09-30 - -

Servers

Infrastructure servers of the data contract

  • Server
    dev
    Type
    bigquery
    Project
    fairlymade-data-platform-dev
    Dataset
    dev_exploration_supplier_explored
    Location
    europe-west1
  • Server
    stg
    Type
    bigquery
    Project
    fairlymade-data-platform-dev
    Dataset
    stg_exploration_supplier_explored
    Location
    europe-west1
  • Server
    prd
    Type
    bigquery
    Project
    fairlymade-data-platform-prd
    Dataset
    exploration_supplier_explored
    Location
    europe-west1
  • Server
    sandbox
    Type
    bigquery
    Project
    fairlymade-data-platform-dev
    Dataset
    sbx_exploration_supplier_explored
    Location
    europe-west1
Created at 12 Jun 2026 14:44:12 UTC with Data Contract CLI v0.11.1

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_exploration_supplier_explored
  location: europe-west1
  project: fairlymade-data-platform-dev
- server: stg
  type: bigquery
  dataset: stg_exploration_supplier_explored
  location: europe-west1
  project: fairlymade-data-platform-dev
- server: prd
  type: bigquery
  dataset: exploration_supplier_explored
  location: europe-west1
  project: fairlymade-data-platform-prd
- server: sandbox
  type: bigquery
  dataset: sbx_exploration_supplier_explored
  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: suppliers_mart
  physicalType: table
  description: This table contains one row per (customer, supplier) pair, summarizing
    the supplier's factory information, certifications and the products supplied to
    the customer
  tags:
  - exploration
  - supplier_explored
  dataGranularityDescription: One row per customer and supplier
  properties:
  - name: id
    description: Unique identifier (generated by Fairly Made) of the customer/supplier
      pair. It corresponds to the concatenation of the registry customer id and the
      supplier 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: supplier_id
    description: Unique identifier (generated by Fairly Made) of the supplier
    logicalType: string
    required: true
    unique: false
  - name: supplier_name
    description: The name of the supplier company
    logicalType: string
    required: false
    unique: false
  - name: supplier_unique_identifier
    description: Supplier reference in the brand systems
    logicalType: array
    required: false
    unique: false
    items:
      logicalType: string
  - name: address
    description: The postal address of the supplier company. Empty if unknown
    logicalType: object
    required: false
    unique: false
    properties:
    - name: street
      description: Street part of the supplier address. Empty if unknown
      logicalType: string
    - name: postal_code
      description: Postal code part of the supplier address. Empty if unknown
      logicalType: string
    - name: city
      description: City of the supplier. Empty if unknown
      logicalType: string
    - name: region
      description: Region of the supplier address. Empty if unknown
      logicalType: string
    - name: country
      description: Country of the supplier. Empty if unknown
      logicalType: string
    - name: latitude
      description: Latitude of the supplier address
      logicalType: number
    - name: longitude
      description: Longitude of the supplier address
      logicalType: number
  - name: supplier_certifications
    description: The list of the supplier's certifications with their associated status
    logicalType: string
    required: false
    unique: false
  - name: number_of_employees
    description: The number of employees of the supplier, declared by the supplier
      itself. Empty if unknown
    logicalType: integer
    required: false
    unique: false
  - name: percentage_of_women
    description: The percentage of women employees of the supplier, declared by the
      supplier itself. Empty if unknown
    logicalType: integer
    required: false
    unique: false
  - name: percentage_of_men
    description: The percentage of men employees of the supplier, declared by the
      supplier itself. Empty if unknown
    logicalType: integer
    required: false
    unique: false
  - name: production_capacity
    description: Production capacity of the factory, as declared by the supplier
    logicalType: object
    required: false
    unique: false
    properties:
    - name: value
      description: Value of the production capacity of the factory
      logicalType: number
    - name: unit
      description: Unit of the production capacity of the factory
      logicalType: string
    - name: time_frame
      description: Time frame of the production capacity of the factory
      logicalType: string
  - name: heat_sources
    description: The list of heat sources of the factory, as declared by the supplier
    logicalType: array
    required: false
    unique: false
    items:
      logicalType: string
  - name: average_heat_consumption
    description: The average heat consumption of the factory, as declared by the supplier
    logicalType: object
    required: false
    unique: false
    properties:
    - name: value
      description: Value of the average heat consumption of the factory
      logicalType: number
    - name: unit
      description: Unit of the average heat consumption of the factory (MJ)
      logicalType: string
    - name: time_frame
      description: Time frame of the average heat consumption of the factory
      logicalType: string
  - name: average_electricity_consumption
    description: The average electricity consumption of the factory, as declared by
      the supplier
    logicalType: object
    required: false
    unique: false
    properties:
    - name: value
      description: Value of the average electricity consumption of the factory
      logicalType: number
    - name: unit
      description: Unit of the average electricity consumption of the factory (kWh)
      logicalType: string
    - name: time_frame
      description: Time frame of the average electricity consumption of the factory
      logicalType: string
  - name: electricity_mix
    description: The list of electricity sources of the factory with their associated
      percentage, as declared by the supplier
    logicalType: array
    required: false
    unique: false
    items:
      logicalType: object
      properties:
      - name: source
        description: Source in the electricity mix
        logicalType: string
      - name: percentage
        description: Proportion of the source in the electricity mix
        logicalType: number
  - name: number_of_associated_products
    description: The number of product references the supplier is associated with
      (either as an agent or as responsible for a step in the production chain)
    logicalType: integer
    required: false
    unique: false
  - name: declared_by_the_brand
    description: True if the supplier has been declared by the brand on at least one
      product (at any scope, PRODUCT, COMPONENT or MATERIAL)
    logicalType: boolean
    required: false
    unique: false
  - name: process
    description: List of distinct involvement types of the supplier across all its
      associated products (traceability steps, warehouse)
    logicalType: array
    required: false
    unique: false
    items:
      logicalType: string
  - name: has_rearchi_products
    description: True if at least one product associated to this supplier for this
      customer comes from the rearchi data
    logicalType: boolean
    required: false
    unique: false
- name: suppliers_x_products_mart
  physicalType: table
  description: This table contains all the suppliers linked to a product and the source
    of the relationship
  tags:
  - exploration
  - supplier_explored
  dataGranularityDescription: One row per supplier and product
  properties:
  - name: id
    description: Unique identifier (generated by Fairly Made) of the supplier/product
      relationship. It corresponds to the concatenation of the brand product id and
      the supplier 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: brand_product_id
    description: Unique identifier (generated by Fairly Made) of the product
    logicalType: string
    required: true
    unique: false
    relationships:
    - type: foreignKey
      to: products_mart.id
      customProperties:
      - property: cardinality
        value: many-to-one
      - property: description
        value: References products_mart in the product_explored contract
  - name: supplier_id
    description: Unique identifier (generated by Fairly Made) of the supplier
    logicalType: string
    required: true
    unique: false
  - name: supplier_unique_identifier
    description: External reference of the supplier in the customer system
    logicalType: string
    required: false
    unique: false
  - name: supplier_involvement
    description: List of involvement types for this supplier on the product (traceability
      steps, warehouse)
    logicalType: array
    required: false
    unique: false
    items:
      logicalType: string
  - name: declared_by_the_brand_at
    description: List of scopes at which the brand declared this supplier (PRODUCT,
      COMPONENT, MATERIAL)
    logicalType: array
    required: false
    unique: false
    items:
      logicalType: string
  - name: is_rearchi
    description: True if the product comes from the rearchi data
    logicalType: boolean
    required: true
    unique: false
- name: scope_certifications_mart
  physicalType: table
  description: This table contains one row per (customer, supplier) pair, aggregating
    all the scope certifications (at supplier level) declared for that supplier
  tags:
  - exploration
  - supplier_explored
  dataGranularityDescription: One row per customer and supplier
  properties:
  - name: id
    description: Unique identifier (generated by Fairly Made) of the customer/supplier
      pair. It corresponds to the concatenation of the registry customer id and the
      supplier id
    primaryKey: true
    logicalType: string
    required: true
    unique: true
    relationships:
    - type: foreignKey
      to: suppliers_mart.id
      customProperties:
      - property: cardinality
        value: one-to-one
  - 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: supplier_id
    description: Unique identifier (generated by Fairly Made) of the supplier
    logicalType: string
    required: true
    unique: false
  - name: scope_certificate
    description: The list of the supplier's scope certifications with their associated
      status
    logicalType: array
    required: false
    unique: false
    items:
      logicalType: object
      properties:
      - name: certification_id
        description: Unique identifier (generated by Fairly Made) of the certification
        logicalType: string
      - name: standard
        description: Standard of the certificate, according to Fairly Made taxonomy
          (e.g. GOTS)
        logicalType: string
      - name: validity_start_date
        description: Start date of the certificate validity
        logicalType: timestamp
      - name: validity_end_date
        description: End date of the certificate validity
        logicalType: timestamp
      - name: status
        description: Status of the certificate
        logicalType: string
      - name: created_at
        description: Date and time when the record was created in operational database
        logicalType: timestamp
support:
- channel: '#tech-support'
  tool: slack
team:
  name: Blooming 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: '2023-12-11'
  - username: Noémie Flajolet
    role: Product Manager
    dateIn: '2020-08-24'
  - username: Alice Haupais
    role: Tech Lead
    dateIn: '2024-04-08'
  - username: Charlie Beltran
    role: Analytics Engineer
    dateIn: '2023-09-18'
  - username: Gustave Constans
    role: Software Engineer
    dateIn: '2022-11-07'
  - username: Thibaud Giboury
    role: Software Engineer
    dateIn: '2023-02-06'
  - username: Pierre Barbaroux
    role: Software Engineer
    dateIn: '2024-09-30'

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: sbx_exploration_component_explored
  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
    relationships:
    - type: foreignKey
      to: products_mart.id
      customProperties:
      - property: cardinality
        value: many-to-one
      - property: description
        value: References products_mart in the product_explored contract
  - 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: Blooming 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: '2023-12-11'
  - username: Noémie Flajolet
    role: Product Manager
    dateIn: '2020-08-24'
  - username: Alice Haupais
    role: Tech Lead
    dateIn: '2024-04-08'
  - username: Charlie Beltran
    role: Analytics Engineer
    dateIn: '2023-09-18'
  - username: Gustave Constans
    role: Software Engineer
    dateIn: '2022-11-07'
  - username: Thibaud Giboury
    role: Software Engineer
    dateIn: '2023-02-06'
  - username: Pierre Barbaroux
    role: Software Engineer
    dateIn: '2024-09-30'

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: sbx_exploration_product_explored
  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: declared_product_suppliers
    description: Suppliers of the product declared by the customer at the product
      level (declared_by_the_brand_at = "PRODUCT")
    logicalType: array
    required: false
    unique: false
    items:
      logicalType: object
      properties:
      - name: supplier_id
        description: Unique identifier (generated by Fairly Made) of the supplier
          declared at the product level
        logicalType: string
      - name: name
        description: Name of the supplier declared at the product level
        logicalType: string
      - name: ref
        description: Reference, in the customer systems, of the supplier declared
          at the product level
        logicalType: string
  - name: declared_components_suppliers
    description: Suppliers of the product declared by the customer at the component
      level (declared_by_the_brand_at = "COMPONENT")
    logicalType: array
    required: false
    unique: false
    items:
      logicalType: object
      properties:
      - name: supplier_id
        description: Unique identifier (generated by Fairly Made) of the supplier
          declared at the component level
        logicalType: string
      - name: name
        description: Name of the supplier declared at the component level
        logicalType: string
      - name: ref
        description: Reference, in the customer systems, of the supplier declared
          at the component level
        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
    relationships:
    - type: foreignKey
      to: products_mart.id
      customProperties:
      - property: cardinality
        value: one-to-one
  - 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: material_quantities
    description: Array of the materials composing the product, with their quantities
    logicalType: array
    required: false
    unique: false
    items:
      logicalType: object
      properties:
      - name: material_id
        description: Unique identifier (generated by Fairly Made) of the material
        logicalType: string
      - name: raw_material
        description: Raw material the material is made of
        logicalType: string
      - name: weight
        description: Total weight in grams of the material in the product, computed
          by the LCA Engine and taking quantities and losses into account
        logicalType: number
  - 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: 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
    relationships:
    - type: foreignKey
      to: products_mart.id
      customProperties:
      - property: cardinality
        value: one-to-one
  - 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
    relationships:
    - type: foreignKey
      to: products_mart.id
      customProperties:
      - property: cardinality
        value: one-to-one
  - 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: Blooming 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: '2023-12-11'
  - username: Noémie Flajolet
    role: Product Manager
    dateIn: '2020-08-24'
  - username: Alice Haupais
    role: Tech Lead
    dateIn: '2024-04-08'
  - username: Charlie Beltran
    role: Analytics Engineer
    dateIn: '2023-09-18'
  - username: Gustave Constans
    role: Software Engineer
    dateIn: '2022-11-07'
  - username: Thibaud Giboury
    role: Software Engineer
    dateIn: '2023-02-06'
  - username: Pierre Barbaroux
    role: Software Engineer
    dateIn: '2024-09-30'

Data Contract YAML

version: 1.0.0
kind: DataContract
apiVersion: v3.1.0
id: exploration-component-explored-id
name: Data Product Name
tenant: FairlyMade
tags: []
status: active
servers:
- server: dev
  type: bigquery
  dataset: dev_exploration_component_explored
  location: europe-west1
  project: fairlymade-data-platform-dev
- server: stg
  type: bigquery
  dataset: stg_exploration_component_explored
  location: europe-west1
  project: fairlymade-data-platform-dev
- server: prd
  type: bigquery
  dataset: exploration_component_explored
  location: europe-west1
  project: fairlymade-data-platform-prd
- server: sandbox
  type: bigquery
  dataset: sbx_exploration_component_explored
  location: europe-west1
  project: fairlymade-data-platform-dev
description:
  usage: Exposes component explored to several interfaces (SCI)
  purpose: Component 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: components_mart
  physicalType: table
  description: This table contains the components of a product and their materials,
    with the component weight and the percentage of each material in the component.
    It unions the legacy components with the rearchi components derived from the traceability
  tags:
  - exploration
  - component_explored
  dataGranularityDescription: One row per product/component/material relationship
  properties:
  - name: id
    description: Unique identifier (generated by Fairly Made) of the product/component/material
      relationship. It corresponds to the concatenation of the product id, the component
      id and the material id (falling back to the product id and the component id
      when the material is unknown)
    primaryKey: true
    logicalType: string
    required: true
    unique: true
  - name: registry_customer_id
    description: Unique identifier (generated by Fairly Made) of the account
    logicalType: string
    required: true
    unique: false
  - name: registry_customer_id_hash
    description: Account hash of the account unique identifier
    logicalType: integer
    required: true
    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: component_id
    description: Unique identifier (generated by Fairly Made) of the component
    logicalType: string
    required: false
    unique: false
  - name: component_weight
    description: Weight of the component. Pre-computed (studies_components) for the
      legacy; propagated from the traceability for the rearchi
    logicalType: number
    required: false
    unique: false
  - name: material_id
    description: Unique identifier (generated by Fairly Made) of the material
    logicalType: string
    required: false
    unique: false
  - name: material_percentage
    description: Percentage of the material in the component
    logicalType: number
    required: false
    unique: false
  - name: is_rearchi
    description: True if the product comes from the rearchi data
    logicalType: boolean
    required: false
    unique: false
support:
- channel: '#tech-support'
  tool: slack
team:
  name: Blooming 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: '2023-12-11'
  - username: Noémie Flajolet
    role: Product Manager
    dateIn: '2020-08-24'
  - username: Alice Haupais
    role: Tech Lead
    dateIn: '2024-04-08'
  - username: Charlie Beltran
    role: Analytics Engineer
    dateIn: '2023-09-18'
  - username: Gustave Constans
    role: Software Engineer
    dateIn: '2022-11-07'
  - username: Thibaud Giboury
    role: Software Engineer
    dateIn: '2023-02-06'
  - username: Pierre Barbaroux
    role: Software Engineer
    dateIn: '2024-09-30'

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: sbx_exploration_component_explored
  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) traceability 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
    relationships:
    - type: foreignKey
      to: products_mart.id
      customProperties:
      - property: cardinality
        value: many-to-one
      - property: description
        value: References products_mart in the product_explored contract
  - 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: level
    description: Nesting depth of the item in the traceability tree. Legacy is fixed-depth
      (material at 2)
    logicalType: integer
    required: true
    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_index
    description: Position of the first component after the PRODUCT to COMPONENT scope
      change in the chain
    logicalType: string
    required: false
    unique: false
  - name: first_component_id
    description: Identifier of the first component after the PRODUCT to COMPONENT
      scope change, propagated to its nested items. The component's own id, or a synthetic
      FRAMEWORK-prefixed id for rearchi framework items
    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: component_weight
    description: Weight of the first component after the PRODUCT to COMPONENT scope
      change, applied to all its downstream components. Pre-computed (studies_components)
      for the legacy; product weight × first component percentage for the rearchi
    logicalType: number
    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_index
    description: Position of the first material after the COMPONENT to MATERIAL scope
      change in the chain
    logicalType: string
    required: false
    unique: false
  - name: first_material_id
    description: Unique identifier of the first material after the COMPONENT to MATERIAL
      scope change, propagated to its nested materials. For the legacy, the material's
      own id
    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: Blooming 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: '2023-12-11'
  - username: Noémie Flajolet
    role: Product Manager
    dateIn: '2020-08-24'
  - username: Alice Haupais
    role: Tech Lead
    dateIn: '2024-04-08'
  - username: Charlie Beltran
    role: Analytics Engineer
    dateIn: '2023-09-18'
  - username: Gustave Constans
    role: Software Engineer
    dateIn: '2022-11-07'
  - username: Thibaud Giboury
    role: Software Engineer
    dateIn: '2023-02-06'
  - username: Pierre Barbaroux
    role: Software Engineer
    dateIn: '2024-09-30'