.. include:: ../variables.rst
.. _challenges-participant-profile:

Participant Profile
===================

The Participant Profile is a one-page summary of everything the system knows about a single
participant's gamification history: balance, lifetime earned, lifetime spent, every badge they own,
every active challenge they're eligible for, and the most recent activity on their ledger.

.. figure:: /images/challenges/lightmode/participant-profile.png
   :align: center
   :width: 100 %

|br|

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

Direct URL:

.. code-block:: none

   challenge.participant.html?participanttype=<0-4>&participantid=<id>

Both parameters are required. Participant type codes are the same as elsewhere in the module:
0 = Facility, 1 = Unit, 2 = Auditor, 3 = HCP Type, 4 = Team.

You can also click a participant name in :ref:`challenges-results`, :ref:`challenges-points-ledger`,
or any leaderboard dashboard widget to jump to their profile.

Summary tiles
-------------

Four tiles at the top give the headline numbers:

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

   * - Tile
     - Formula
   * - **Balance**
     - ``SUM(points)`` across the ledger -- earned minus spent.
   * - **Lifetime Earned**
     - ``SUM(points WHERE points > 0)`` -- the grand total they have ever received.
   * - **Spent / Redeemed**
     - ``SUM(-points WHERE points < 0)`` -- magnitude of what has left the account.
   * - **Badges Earned**
     - Count of rows in ``challenge_badges_awarded`` for this participant.

.. figure:: /images/challenges/lightmode/participant-tiles.png
   :align: center
   :width: 80 %

|br|

Badges
------

A grid of every badge the participant has earned, sorted by most-recent first. Hovering a badge
tile shows the challenge that awarded it; tier badges (from auto-rules) show "career milestone"
in the tooltip.

Clicking a badge card does nothing today -- badges are purely decorative -- but a future release
will add drill-down to the grant's originating challenge.

Active challenges
-----------------

Lists up to 20 challenges that are currently active, whose scope matches this participant's
type, ordered by closest end date first. For each:

* Challenge name (links to the :ref:`challenges-results` for that challenge)
* End date
* Reward points

This lets the participant see what they're eligible to win *right now* -- useful for morale
boards or weekly manager reviews.

Recent activity
---------------

The 20 most recent ledger rows for this participant, with:

* Date, challenge name, reason (Earned / Redeemed / Expired / Adjusted)
* Signed point delta (green for positive, red for negative)
* Notes from the ledger row

This is the same data as :ref:`challenges-points-ledger` but pre-filtered to one participant.

Tips for managers
-----------------

* Bookmark the URL for individual team members to track progress weekly.
* Export via :ref:`challenges-points-ledger` and filter client-side for long-form reporting.
* The :blue:`Spent / Redeemed` tile is a quick health-check against your reward budget.