Merge pull request #200 from catenax-ng/DST_PIP10_ITR3_pcf_documents

Documents updated for PCF submodel
catenax-ng · Sep 20, 2023 · 35b9afe · 35b9afe
2 parents 7152583 + 54c242b
commit 35b9afe
Show file tree

Hide file tree

Showing 4 changed files with 85 additions and 2 deletions.
diff --git a/README.md b/README.md
@@ -189,6 +189,7 @@ To find information about supported submodules and there version in SDE please v
     * SingleLevelBoMAsPlanned
     * PartSiteInformationAsPlanned
     * SingleLevelUsageAsBuilt
+    * Product Carbon Footprint(PCF)
 2. ***Json Update***
     * SerialPart
     * SingleLevelBoMAsBuilt
@@ -197,6 +198,7 @@ To find information about supported submodules and there version in SDE please v
     * SingleLevelBoMAsPlanned
     * PartSiteInformationAsPlanned
  	* SingleLevelUsageAsBuilt
+ 	* Product Carbon Footprint(PCF)
 3. ***Application UI***
     * SerialPart
     * SingleLevelBoMAsBuilt
@@ -205,6 +207,7 @@ To find information about supported submodules and there version in SDE please v
     * SingleLevelBoMAsPlanned
     * PartSiteInformationAsPlanned
     * SingleLevelUsageAsBuilt
+    * Product Carbon Footprint(PCF)
 
 
  ---   

diff --git a/modules/README.md b/modules/README.md
@@ -22,4 +22,5 @@ SDE backend splited into multiple services loosely-coupled Maven modules.
 - modules/sde-submodules/part-site-information-as-planned
 - modules/sde-submodules/single-level-usage-as-built
 - modules/sde-submodules/single-level-bom-as-planned
+- modules/sde-submodules/pcf
 - modules/sde-usecases/traceability
diff --git a/modules/sde-submodules/pcf/pcf.md b/modules/sde-submodules/pcf/pcf.md
@@ -2,6 +2,7 @@
 ---
 ## Description
 
+This module use for PCF submodel specification and descriptors. It's contain the codes related to PCF to validate, parse and transfer data for DigitalTwins and EDC to create aspect twins and data offer.
 
 ---
 #### Version: 4.0.1
@@ -18,6 +19,71 @@ Please find below links for schema details:
 
 ### PCF CSV file headers
 
+| Headers Name       	       			| Mandatory                     	| Position 	|
+|----------------------------------		|-----------------------------	    |--------	|
+| id		                   							| No		             		    |    1     	|
+| specVersion					   						| Yes						      	|    2    	|
+| partialFullPcf										| Yes							    |	 3		|
+| precedingPfId    										| Yes 							    | 	 4	   	|
+| version  	    										| No                            	| 	 5	  	|
+| created 		      									| Yes                           	| 	 6	  	|
+| extWBCSD_pfStatus		 								| Yes                               |    7	 	|
+| validityPeriodStart	 								| Yes                           	|    8 	 	|
+| validityPeriodEnd			   							| No						      	|    9   	|
+| comment												| Yes							    |	 10		|
+| pcfLegalStatement    									| Yes 							    | 	 11	   	|
+| companyName  	    									| No                            	| 	 12	  	|
+| companyId 		      								| Yes                           	| 	 13	  	|
+| productDescription		 							| Yes                               |    14	 	|
+| productId	 											| Yes                           	|    15	 	|
+| extWBCSD_productCodeCpc	   							| No						      	|    16   	|
+| productName											| Yes							    |	 17		|
+| declaredUnit    										| Yes 							    | 	 18	   	|
+| unitaryProductAmount  	    						| No                            	| 	 19	  	|
+| productMassPerDeclaredUnit       						| Yes                           	| 	 20	  	|
+| exemptedEmissionsPercent	 							| Yes                               |    21	 	|
+| exemptedEmissionsDescription	 						| Yes                           	|    22	 	|
+| extWBCSD_packagingEmissionsIncluded  					| No						      	|    23   	|
+| boundaryProcessesDescription							| Yes							    |	 24		|
+| geographyCountrySubdivision    						| Yes 							    | 	 25	   	|
+| geographyCountry  	    							| No                            	| 	 26	  	|
+| geographyRegionOrSubregion      						| Yes                           	| 	 27	  	|
+| referencePeriodStart									| Yes                               |    28	 	|
+| referencePeriodEnd	 								| Yes                           	|    30	 	|
+| crossSectoralStandard		   							| No						      	|    31   	|
+| extWBCSD_operator										| Yes							    |	 32		|
+| ruleName    											| Yes 							    | 	 33	   	|
+| extWBCSD_otherOperatorName  	   						| No                            	| 	 34	  	|
+| extWBCSD_characterizationFactors     					| Yes                           	| 	 35	  	|
+| extWBCSD_allocationRulesDescription 					| Yes                               |    36	 	|
+| extTFS_allocationWasteIncineration					| Yes                           	|    37	 	|
+| primaryDataShare				   						| No						      	|    38   	|
+| secondaryEmissionFactorSource							| Yes							    |	 39		|
+| coveragePercent    									| Yes 							    | 	 40	   	|
+| technologicalDQRtemporalDQR  	    					| No                            	| 	 41	  	|
+| geographicalDQR 		      							| Yes                           	| 	 42	  	|
+| completenessDQR		 								| Yes                               |    43	 	|
+| reliabilityDQR	 									| Yes                           	|    44	 	|
+| pcfExcludingBiogenic									| No						      	|    45   	|
+| pcfIncludingBiogenic									| Yes							    |	 46		|
+| fossilGhgEmissions    								| Yes 							    | 	 47	   	|
+| biogenicCarbonEmissionsOtherThanCO2 					| No                            	| 	 48	  	|
+| biogenicCarbonWithdrawal 		      					| Yes                           	| 	 49	  	|
+| dlucGhgEmissions		 								| Yes                               |    50	 	|
+| extTFS_luGhgEmissions	 								| Yes                           	|    51	 	|
+| aircraftGhgEmissions			   						| No						      	|    52   	|
+| extWBCSD_packagingGhgEmissions						| Yes							    |	 53		|
+| distributionStagePcfExcludingBiogenic					| Yes 							    | 	 54	   	|
+| distributionStagePcfIncludingBiogenic					| No                            	| 	 55	  	|
+| distributionStageFossilGhgEmissions  					| Yes                           	| 	 56	  	|
+| distributionStageBiogenicCarbonEmissionsOtherThanCO2	| Yes                               |    57	 	|
+| distributionStageBiogenicCarbonWithdrawal				| Yes                           	|    58	 	|
+| extTFS_distributionStageDlucGhgEmissions		   		| No						      	|    59   	|
+| extTFS_distributionStageLuGhgEmissions				| Yes							    |	 60		|
+| carbonContentTotal    								| Yes 							    | 	 61	   	|
+| extWBCSD_fossilCarbonContent  	    				| No                            	| 	 62	  	|
+| carbonContentBiogenic 		      					| Yes                           	| 	 63	  	|
+| assetLifeCyclePhase		 							| Yes                               |    64	 	|
 
 
 #### [CSV Sample File Link]
@@ -28,8 +94,19 @@ Please find below links for schema details:
 
 ### Work Flow 
 
-
+ - CSV to POJO
+ - CSV column validation and mandatory field validation
+ - POJO TO DTO
+ - UUID generate v4
+ - DigitalTwins API's calls 
+ - EDC API's calls
+ - BPN Discovery API Call
+ - DB Store
 
 ### External Services Call
 
-
+ - DigitalTwins
+ - EDC Connectors
+ - BPN Discovery
+
+[CSV Sample File Link]: src/main/resources/pcf.csv
diff --git a/modules/sde-submodules/submodules.md b/modules/sde-submodules/submodules.md
@@ -15,6 +15,7 @@ Currently SDE supports below submodels.
 #### [singleLevelBoMAsPlanned in Version 1.0.1]
 #### [partSiteInformationAsPlanned in Version 1.0.0]
 #### [SingleLevelUsageAsBuilt in Version 1.0.1]
+#### [Product Carbon Footprint(PCF) in Version 4.0.1]
 
 ### How we can add Submodels?
 
@@ -42,3 +43,4 @@ Once your maven module ready just do the clean build and install so submodel wil
 [singleLevelBoMAsPlanned in Version 1.0.1]: single-level-bom-as-planned/single-level-bom-as-planned.md
 [partSiteInformationAsPlanned in Version 1.0.0]: part-site-information-as-planned/part-site-information-as-planned.md
 [SingleLevelUsageAsBuilt in Version 1.0.1]: single-level-usage-as-built/single-level-usage-as-built.md
+[Product Carbon Footprint(PCF) in Version 4.0.1]: pcf/pcf.md