Project (ARKP)

ArkID Project Schema

Captures funded project agreements, including EC cascading grant reporting fields, participant roster, and budget breakdowns.

Version

2.0.0

Last Updated

2025-10-31

Alignment

EC Project template v2.5

Source Schema

docs/schemas/arkid_project_schema.json

Highlights

  • Separates metadata, projectCore, participants, KPI tracking, and financial breakdowns for clarity.
  • Mandatory link to reference catalogue enums ensures EC-compliant action types, partnership data, and country codes.
  • Supports granular activity outputs, RIS tagging, and department-level addresses for third parties.

When to Use

  • Persisting signed sub-grant agreements from EC KICs inside ArkID.
  • Driving dashboards that aggregate participant contributions and KPI commitments.
  • Synchronising with Keycloak/Redis-backed services that need project-level authorisation scopes.

Project Core

The legally binding metadata copied from the sub-grant agreement.

projectCore.acronym & title

stringRequired

Official project shorthand and descriptive title.

projectCore.callId & actionType

string (enum)Required

Traceability back to the originating EC call, aligned with the reference catalogue.

projectCore.startDate / endDate / signatureDate

string (date)Required

Dates recorded in EC sub-grant agreements; ensure signatureDate is >= 2021-01-01.

projectCore.projectEuContribution / projectNationalContribution / totalCostProject

numberRequired

Budget totals in EUR, mirroring the financial annex.

Participants & Departments

Structured representation of beneficiaries, linked third parties, and departmental locations.

participants[]

arrayRequired

Each participant captures PIC, legal name, contact details, role, and financial support values.

participants[].departments[]

arrayOptional

Department-level addresses with NUTS codes for RIS analytics.

participants[].eit

objectOptional

KIC-specific metadata (AreaKTI, HEI membership, RIS country flag, cost categories).

Monitoring & KPIs

Keeps EC KPI commitments and activity outputs auditable.

  • eitKpis[] expects KPI codes defined in the reference catalogue, alongside target values and core areas.
  • outputs[] enables nested deliverable tracking with <Deliverable> and description toggles.
  • risActivity flag signals whether the project counts towards RIS quotas.

Signed project snapshot

Extract of a project payload ready for reporting integrations.

{
  "metadata": {
    "arkidProject": "ARKP-2025-0001-0002-0001",
    "referenceCatalogueVersion": "0.2.0"
  },
  "projectCore": {
    "acronym": "RESIL-CHAIN",
    "status": "SIGNED",
    "startDate": "2025-02-01",
    "totalCostProject": 800000
  },
  "firstParticipant": {
    "organization": "Health Tech Europe GmbH",
    "city": "Berlin",
    "country": "DE",
    "role": "COORDINATOR"
  }
}