.. include:: ../variables.rst
.. _challenges-results:

Challenge Results
=================

The Results page is a per-challenge leaderboard that shows, for every participant in scope, how
they scored and whether they met the goal.

.. figure:: /images/challenges/lightmode/challenge-results.png
   :align: center
   :width: 100 %

|br|

Opening the page
----------------

* From :ref:`challenges-list` click :blue:`View Results` on any row.
* Direct URL: ``challenge.results.html?id=N``.

Reading the table
-----------------

Each row represents one participant in scope. Columns:

.. list-table::
   :header-rows: 1
   :widths: 25 75

   * - Column
     - Meaning
   * - **Participant**
     - Name of the facility, unit, auditor, HCP type, or team that was scored.
   * - **Metric Value**
     - The raw score: count, compliance %, improvement delta, or streak days -- whichever metric
       the challenge uses.
   * - **Met**
     - Green check if ``metricvalue`` satisfies the threshold + comparator; otherwise dash.
   * - **Computed At**
     - Timestamp of the most recent compute. All rows share the same timestamp because compute
       overwrites the snapshot atomically.

.. figure:: /images/challenges/lightmode/challenge-results-leaderboard.png
   :align: center
   :width: 90 %

|br|

Sorting and filtering
---------------------

* Click any column header to sort. Default is winners first, then metric value descending.
* The search box filters the participant name.
* Use :blue:`Export CSV` to download the full leaderboard for further analysis.

Preview vs. final
-----------------

The results table always shows the **most recent compute snapshot**, not necessarily the "final"
snapshot. A useful sanity-check workflow:

#. :blue:`Compute Now` on :ref:`challenges-list` to refresh the snapshot.
#. Open :blue:`View Results` -- confirm the numbers look right.
#. Return to the list and :blue:`Preview Close` to see who would be awarded and how many points.
#. Only when satisfied, :blue:`Close Challenge`.

After Close
-----------

Once a challenge is closed, every ``met = 1`` row in this table has a corresponding entry in the
points ledger and (if a badge was configured) in the badge grants table. You can navigate to a
specific participant's history by clicking their name -- this opens their
:ref:`challenges-participant-profile`.