This repository is part of the overarching Catena-X project. It contains the Backend for the DFT. DFT is short for Data Format Transformer.
It is a standalone service which can be self-hosted. It enables companies to provide their data in the Catena-X network via an EDC. Data is uploaded via two CSV-files. The DFT registers the data in the Digital Twin Registry and makes it accessible via an EDC. The DFT project has two dependencies: Digital Twins and EDC.
For installation guide: see InstallationGuide.md
DFT is a SpringBoot Java software project managed by Maven.
When running, the project requires a postgresql database to be available to connect to. Per default configuration the application expects postgres to run on localhost on port 5432.
You can find the standard credentials as well as further database configurations int the application.properties file in the resource folder.
- JDK18
- Postgres 13.2
- Docker
- Clone the GitHub Repository - https://github.com/catenax-ng/product-dft-backend
- Get your instance of postgres running.(Create dftdb new database)
- Setup your project environment to JDK 18
- Start the application from your IDE.
-
File Uploads
- SerialTypezation
- AssemblyRelationship
- Batch
-
Json Update
- SerialTypezation
- AssemblyRelationship
- Batch
-
Application UI
- SerialTypezation
- AssemblyRelationship
- Batch
| API | Description | Request body | Response body |
|---|---|---|---|
| POST:- localhost:8080/api/aspect | This API Is Used For Uploading Data From JSon/Tabular form | Refer Api Doc | 4ca03d5f-9e37-4c12-a8b8-6583b81892c8 |
| POST:- localhost:8080/api/upload | This API Is Used For Uploading Data From CSV file(Serial/Aspect Relationship) form | Refer Api Doc | 4ca03d5f-9e37-4c12-a8b8-6583b81892c8 |
| POST:- localhost:8080/api/batch | This API Is Used For Uploading Data From CSV file(Batch) form | Refer Api Doc | 4ca03d5f-9e37-4c12-a8b8-6583b81892c8 |
| GET:- localhost:8080/api/aspect/{{aspect_r_Id}}/relationship | This API Is Used For fetch Data on Relationship Id | Refer Api Doc | Refer Api Doc |
| GET:- localhost:8080/api/batch/urn:uuid:8eea5f45-0823-48ce-a4fc-c3bf1ffff4c2 | This API Is Used For fetch Data on Batch Id | Refer Api Doc | Refer Api Doc |
| GET:- localhost:8080/api/public/aspect/urn:uuid:8eea5f45-0823-48ce-a4fc-c3bf1ffff4c2 | This API Is Used For fetch Data on Aspect Id | Refer Api Doc | Refer Api Doc |
| GET:- localhost:8080/api/processing-report/87d0aece-ae46-4006-904d-9ec41cddee8b | This API Is Used For fetch Process Report by Process ID | Refer Api Doc | Refer Api Doc |
| GET:- localhost:8080/api/ping | This API Is Used For Health Check | -- | 2022-09-30T16:21:02.630868 |
| GET:- localhost:8080/api/processing-report?page=&pageSize=50 | This API Is Used For fetch Process Report | Refer Api Doc | Refer Api Doc |
| Code | DESCRIPTION |
|---|---|
| 200 OK | Indicates that the request has succeeded. |
| 201 Created | Indicates that the request has succeeded and a new resource has been created as a result. |
| 202 Accepted | Indicates that the request has been received but not completed yet |
| 204 No Content | The server has fulfilled the request but does not need to return a response body. The server may return the updated meta information. |
| Code | DESCRIPTION |
|---|---|
| 400 Bad Request | The request could not be understood by the server due to incorrect syntax. |
| 401 Unauthorized | Indicates that the request requires user authentication information. |
| 403 Forbidden | Unauthorized request. |
| 404 Not Found | The server can not find the requested resource. |
| 405 Method Not Allowed | The request HTTP method is known by the server but has been disabled and cannot be used for that resource |
| 500 Internal Server Error | The server encountered an unexpected condition that prevented it from fulfilling the request. |
| 502 Bad Gateway | The server got an invalid response while working as a gateway to get the response needed to handle the request. |
| 503 Service Unavailable | The server is not ready to handle the request. |
| 504 Gateway Timeout | The server is acting as a gateway and cannot get a response in time for a request. |
| Tables | Description | Unique Id |
|---|---|---|
| ASPECT | Table used to Store Date about Serialized Part | Primary Key:UUID |
| Aspect_Relationship | Data about the relationship of parts to its child-components. | Primary Key:parent_catenax_id, child_catenax_id |
| Batch | Table used to Store Date about Serialized Part. | Primary Key:UUID |
| Contract_Negotiation_Info | Tables Contains Cntract Negotiotion Info and offerid | Primary Key: connector_id, offer_id |
| Failure Log | Table Contains Data About Failure Entries | Primary Key:UUID |
| Flyway_Schema_History | Table Contains data Migration History | Primary Key:installed_rank |
| Process_Report | Table Contains status of Processing upliad | Primary Key:process_id |
The scripts are in the folder: resources/flyway.
File naming: Vx__script_name.sql, where x is the version number.
When there is a need to change the last script, it is necessary to create a new script with the changes.
Link to flyway documentation: Documentation
Authentication for the backend is handled via an API Key. This can be set in the configuration file.
The latest version on main is automatically picked up by ArgoCD and deployed to the DEV environment. See https://catenax-ng.github.io/.
https://dft-api.int.demo.catena-x.net/
To see how to deploy an application on 'Hotel Budapest': How to deploy
GitHub repository with correct version of the Eclipse DataSpace Connector Project: repository
Apache 2.0 (https://www.apache.org/licenses/LICENSE-2.0)