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 is authoritative: when supplied, it replaces every workbook’s site_id, including a conflicting or malformed value. Folder names are never used to infer the site. It does not rewrite a source site_patient_id, so an existing source prefix is accepted when an override is in use.

$ 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.