Developers
Architecture, data pipelines, integration contracts, tools, and contribution guides for openJII.
openJII is an open-source platform for collecting, processing, and sharing plant-science measurements. This section is for people who operate the platform, integrate devices, or contribute code.
Choose a starting point
- Architecture & Pipeline explains the monorepo, runtime services, MQTT ingestion, and Databricks lakehouse.
- Design Decisions preserves the project's ADRs, proposal, and authoring templates as historical records.
- MultispeQ MQTT Tool covers the development CLI that publishes MultispeQ readings to AWS IoT Core.
- Extending the Platform covers CMS-managed alerts, the mobile force-update gate, and transactional emails.
- Contributing provides a verified local-development and pull-request workflow.
Contract references
Use the generated references when implementing integrations:
- REST API reference is generated from the oRPC contract in
packages/api. - MQTT API reference is generated from the repository's canonical
asyncapi.yaml.
The generated references are the contract source of truth. Explanatory pages in this section focus on system behavior and operational context.
Repository
The platform is developed in the Jan IngenHousz Institute open-jii repository. Security issues must follow the repository's security policy rather than a public issue.