Configuration

Place an optional acmad.yaml file at the package root to keep settings that would otherwise be repeated on every command:

site: QCH
api_url: https://acmad.example/api/v1/
realm_url: https://id.acmad.example/realms/prod
client_id: prod-cli

All keys are optional. Values are resolved in this order: command-line option, acmad.yaml, then built-in default. Unknown keys and non-string values are reported as configuration errors.

Configuration key	Command-line option	Built-in default
site	--site	No default; use the workbook value.
api_url	--api-url	http://localhost:8000/api/v1/
realm_url	--realm-url	http://localhost:8080/realms/localdev
client_id	--client-id	localdevoidc

Site acronym

The site acronym fills site_id only when a workbook omits it or leaves it blank. If a workbook contains a site identifier, the supplied acronym must match; disagreement is a validation error. Folder names are never used to infer the site.

$ acmad-upload patient validate /path/to/package --site QCH
$ acmad-upload upload /path/to/package --site QCH

The site option applies to patient, diagnosis, gait-assessment, and surgery inputs. Other records inherit their destination relationship through an existing gait assessment or motion-capture session.