📦 Informational Model

This repository defines the structure, terminology, and usage examples for our informational model. It is modular and versioned to support clarity, reuse, and collaborative development.

---

📁 Directory Structure

informational-model/
├── spec/  
│   ├── core.md                      # High-level purpose, scope, and ontology documentation  
│   ├── repos.md                     # Descriptions of all GreenEarthX code repositories  
│   ├── profiles/                    # Sector-specific or modular extensions (e.g., hydrogen.md, CCUS.md)  
│   └── mappings/                    # Field-level data transformation mappings  
│       └── data_mapping_spec.md     # Specification for mapping raw data to the model  
│  
├── vocab/  
│   ├── terms.csv                    # Glossary of terms, entities, and relationships  
│   └── code_lists/                 # Controlled vocabularies (e.g., fuel types, units)  
│  
├── architecture/  
│   └── geomap-applications-aws-architecture.md   # Detailed cloud deployment and security architecture  
│  
├── examples/                        # JSON-LD / YAML examples showing how to use the model  
├── diagrams/                        # Visual diagrams (.drawio, .png) illustrating structure and flow  
├── governance.md                    # Contribution guidelines, versioning strategy, and change process  
└── Datasets/                        # Sample datasets for testing or onboarding use cases  

---

📘 Key Components

📘 Key Components

• spec/core.md: Describes the overarching goals, scope, and ontology.
• spec/profiles/: Contains sub-models or extensions (by domain, version, or feature).
• vocab/terms.csv: A complete glossary of entities and definitions.
• vocab/code_lists/: Controlled vocabularies and enumerated types.
• architecture/: Detailed technical documentation of infrastructure and deployment.
• examples/: Sample JSON-LD or YAML files showing real-world usage.
• diagrams/: Visual diagrams (.drawio, .png) illustrating the data model.
• governance.md: Guidelines for versioning, reviewing, and maintaining the model.
• Datasets/: Structured datasets compliant with the model.

---

📦 Repository Overview
For a description of all GreenEarthX repositories and their roles in the system, see spec/repos.md.

🚀 Getting Started

---

To get familiar with the model:

1. Start with spec/core.md.
2. Browse the profiles for domain-specific modules.
3. Refer to vocab/terms.csv for definitions.
4. Explore examples/ for example implementations.

---

🔄 Governance & Contributions

For details on how to contribute or propose changes, see governance.md.

---

🧪 License & Usage

Include licensing and reuse information here if applicable.