Merge pull request #60 from CyberbuildLab/minimum-spreadsheet

This merge is reviewed and implemented to make the minimum-spreadsheet branch as the new baseline for BE-OLS.
Conflicts between the main's and the minimum-spreadsheet's binary files were resolved by keeping the PR branch versions of the data artefacts (data/Ontologies_forRepo.xlsx and the derived data/Ontologies_forRepo.json), consistent with the intention of the the EC3 M&S committe that this PR becomes the new authoritative baseline for main from today on.

Author: Z-Arghavan

create_submission_excel.py

@@ -4,16 +4,18 @@
 
 # Desired column order
 COLUMNS = [
-    "Name",
-    "Acronym",
+    "Title",
+    "Prefix",
     "Version",
-    "Year published",
-    "Short Description",
-    "URI/Namespace",
-    "Reference",
+    "Created",
+    "License",
+    "Conforms To Standard",
+    "Description",
+    "URI",
+    "References",
     "Linked-to ontologies AECO",
-    "Linked-to ontologies UPPER",
-    "Linked other professional domain ontologies"
+    "Linked-by ontologies UPPER",
+    #"Linked other professional domain ontologies"
 ]
 
 def submission_to_excel(input_json, output_excel, sheet_name='Data'):

data/Ontologies_forRepo.json

@@ -3,13 +3,18 @@
 This folder keeps  the source data and is the entry point for automated Excel-to-JSON conversion.
 
 ## Files
-
-* **Ontologies\_forRepo.xlsx** - the main Excel workbook where collaborators add or update data. It must contain a sheet named **Data**.
-* **Ontologies\_forRepo.json** - the live JSON file used by front-end and other code. It is regenerated automatically whenever the Excel file changes.
+* **Ontologies\_forRepo.xlsx** - the main Excel workbook containing the data used by front-end and other code. It must contain a sheet named **Data**.
+* **Ontologies\_forRepo.json** - the live JSON file used by front-end and other code. It is regenerated automatically whenever the corresponding Excel file changes.
 * **Output folder** - contains timestamped JSON backups that are relevant to this conversion process. See `output/README.md` for details.
 
 * * **submissions folder** - the ontologies submitted by users to be added to the BE-OLS are first recorded here.
 
+* * **source folder** - the ontologies submitted by users to be added to the BE-OLS are first recorded here. This contains:
+  * **Ontologies.xlsx** - the main Excel workbook where collaborators enter core information for all ontologies in the database as well as manual information for ontology without URI.
+  * **Ontology_characterisation.jpynb** - the Jupyter Notebook used to process `Ontologies.xlsx` to generate `Ontologies\_forRepo.xlsx` in the parent folder.
+
+* * **Network Graph folder** - old content to be removed eventually.
+
 ## Automatic Conversion
 
 A GitHub Actions workflow monitors this folder for modifications to `Ontologies_forRepo.xlsx`. Whenever changes are pushed:
@@ -31,7 +36,7 @@ If you need to run the workflow on demand:
 
 * The JSON output file must be named exactly `Ontologies_forRepo.json` so that all downstream code can locate it.
 * Do not rename this file manually. Always update the Excel workbook and let the workflow regenerate the JSON under the correct name.
-* If you upload a new Excel file with a different base name, the converter will generate a JSON file with the same base name.
+* If you upload a new Excel file with a different base name, the converter will generate a JSON file with the same base name (this needs updated so that only the `Ontologies_forRepo.xlsx` is processed).
 
 
 ## Important Points (and Troubleshooting)