Overview

AMMM App is a monorepo that wraps the AMMM modelling stack into a dashboard and a durable backend.

What you can do

1. Upload inputs (data.csv, config.yml, optional holidays.csv).
2. Create a dataset (immutable bundle of input IDs).
3. Queue a model run and track status/history.
4. Inspect outputs (plots, CSV tables, logs) and download artefacts.
5. Run budget optimisation against a completed model run.

Where things live (repo map)

• apps/web/: Next.js dashboard UI (Clerk-protected).
• apps/api/: FastAPI service (legacy wrapper; keep for dev/testing).
• ../ammm/scenario_engine/: v2 API + worker + execution (runs/optimisations/scenarios).
• storage/: uploaded inputs + run artefacts (filesystem-backed).
• build-plan/: roadmap, architecture notes, contracts.

Production URLs

• Dashboard: https://hawkstone.ammm.space
• App docs: https://docs-app.ammm.space/
• Library docs: https://docs-lib.ammm.space/