Odyssey Health is a distributed health monitoring system. This repository contains the Odyssey Health Server services, Odyssey Health Manager web-based frontend, shared contracts, infrastructure, and integration tooling.

• Documentation Home
• Manager Overview
• Odyssey Server Overview
• Architecture Overview
• Developer Getting Started
• Commands Reference
• Publisher Simulator

apps/
  manager/        # Manager browser app, backend API, nginx config, shared TS models
  server/         # Odyssey Server API, workers, shared Python models, server tools
packages/
  contracts/      # Canonical cross-app JSON Schema contracts and generated artifacts
infra/
  compose/        # Root Docker Compose orchestration
  docker/         # Shared Docker build assets
tests/
  integration/    # Full-system smoke and browser tests
scripts/          # Repo-level automation
docs/             # User, operator, developer, and tool documentation
examples/         # Reusable sample data for demos, docs, and manual testing

Run commands from the repository root, preferably inside the devcontainer.

pnpm install
pnpm server:install
pnpm check
pnpm compose:up
pnpm test:integration
pnpm test:integration:browser

Use pnpm check as the normal pre-commit gate. Use pnpm check:full when the Compose stack is available and live-stack smoke/browser verification is needed. You do not need to run pnpm build separately in this flow: pnpm check already runs the workspace build, and pnpm compose:up rebuilds the Docker images before starting the stack.

When the development stack is running, the primary endpoints are:

See Services and Ports for the full runtime map.

• User Docs: concepts and workflows for using Manager and understanding Odyssey Server.
• Operator Docs: configuration, services, Docker Compose, credentials, health checks, and troubleshooting.
• Developer Docs: repository structure, commands, devcontainer setup, testing, contracts, generated files, and contribution rules.
• Architecture Docs: runtime topology, system data flow, Manager architecture, Server architecture, and Mermaid diagrams.
• Tool Docs: publisher simulator and integration test tooling.