HealthBridge

Vanilla JS frontend + PHP backend scaffold.

Configuration quick start

• Copy .env.example to .env and adjust values.
• For Docker, use docker/docker-compose.yml.
• Optional environment presets live in env/.
• Run backend quickly: composer serve or npm run serve:php.

Orchestration

• Core module lives in orchestration/ with cmd/, internal/, pkg/, and api/.
• Root config files used by orchestrator:
  • env/.env
  • env/orchestrator.yaml
  • env/services.yaml
  • env/secrets.yaml
• Root Docker files used by orchestrator:
  • docker/docker-compose.yml
  • docker/Dockerfile.orchestrator
  • docker/config/daemon.json

Run locally (without Docker)

1. npm run orch:build
2. npm run orch:run
3. In a second terminal: npm run orch:worker

Run frontend + backend with orchestrator

• npm run orch:start
• This starts both:
  • Backend: http://127.0.0.1:8000
  • Frontend: http://127.0.0.1:3000
• Stop both with Ctrl+C.
• orch:start now also bootstraps setup first:
  • creates missing .env/docker/.env from example files
  • attempts docker compose up -d db redis nats when Docker is available
  • installs Composer/NPM deps when not yet installed (best effort)

Staging-style run (Docker Compose)

1. npm run orch:stage:up
2. Check health: curl http://localhost:9090/health
3. Check metrics: curl http://localhost:9090/metrics
4. Stop: npm run orch:stage:down