Configuration
=============

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

.. code-block:: yaml

   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.

.. list-table::
   :header-rows: 1

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

.. code-block:: console

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