Nodo Apps Handbook

What It Is

Nodo Apps is the standalone ecosystem worker repo currently used for the ClockMe API and the inspirational quotes API.

Architecture

This repo is not the main Topolo Nodo product family. It is a separate worker monorepo with multiple small API surfaces that share deployment and CI infrastructure.

Runtime Surfaces

• clockme-api
• nodo-media/inspirational_api

API Reference

This repo currently exposes two separate worker contracts rather than a single shared API surface. Treat ClockMe and inspirational quotes as independent APIs with their own routes, bindings, and deployment targets.

Auth and Permissions

Auth is surface-specific. Do not assume the two APIs share the same operator or tenant model just because they ship from the same repo root.

Data Ownership

Each worker owns its own narrow API contract and backing storage. Treat the repo as a deployment container rather than a single domain model.

Deployments

The hardened CI contract declares two explicit worker CI targets: clockme-api and nodo-media/inspirational_api. Production and staging deploys should only promote artifacts built from those declared targets.

Failure Modes

• repo-level workflow assumptions are applied to undeclared worker surfaces
• placeholder scripts are treated as sufficient release gates
• ClockMe and inspirational quote bindings drift independently while sharing the same repo orchestration

Debugging

• identify the exact worker first
• verify the matching ci_target and deploy target in the root manifest
• confirm the worker-specific bindings and health path rather than assuming repo-wide parity

Change Log / Verification

• Added canonical Nodo Apps coverage and documented the explicit worker CI targets on 2026-04-01