Skip to content

Developer Guide

This section is for developers working on or extending the Hera platform. It covers architecture, data model internals, testing, and how to build new toolkits.

Architecture

  • Core Concepts - Deep dive into Project, ToolkitHome, and abstractToolkit with class diagrams
  • Data Layer - MongoDB document model, datatypes, and the repository JSON pipeline

Toolkit Implementation

  • Measurements - GIS, meteorology, and experiment toolkit internals, class hierarchies, coordinate utilities
  • Simulations - OpenFOAM, LSM, Gaussian, wind profile, workflow system internals
  • Risk Assessment - Agent/effects/injury system, protection policies, risk area algorithms
  • RAG Search Toolkit - Architecture, indexer, search API, REST server, file watcher, MkDocs plugin, CLI reference

API Reference

  • API Reference - Auto-generated documentation from Python source code covering all public classes and functions

Testing

  • Getting Started with Tests - Setting up the test environment and running tests
  • Test Flow - Pytest session lifecycle, fixtures, comparison helpers, and the expected-output mechanism

Roadmap

  • Roadmap - Planned improvements: contract-first typed interfaces, unified toolkit registry, env var DB config

Reference