Metrics System

The Metrics System lets you perform detailed tracking of different body measurements and performance data for your clients over time, with evolution charts and time-based comparisons.

Demo Video

Basic Concepts

Metric Set

A logical grouping of related metrics that are assigned together. Examples:

• "Body Composition": Weight, Body Fat, Muscle Mass
• "Body Measurements": Waist, Hip, Arm

Each set belongs to your company and can be automatically assigned to new clients.

Individual Metric

A specific measurement within a set (e.g., "Weight" in kg, "Body Fat" in %). Each metric has a history of values recorded by date.

---

Creating and Managing Sets

Create a Set

1. Go to Library → Metric Sets → Create New Set
2. Enter the set name
3. Enable "Automatically assign to new clients" if desired
4. Add metrics (name + unit of measurement)
5. Save

Assign to Clients

• Manual: Client profile → Metrics section → Assign Set
• Automatic: Triggered if the set has auto-assignment enabled

Behavior when assigning:

• If the client never had the set: it is created with empty histories
• If the client previously had the set and it was unassigned: it is restored with all its history preserved

Behavior when unassigning:

• The client's history is fully preserved
• The client can still view their complete history
• They cannot record new values until the set is reassigned
• If you reassign the same set, all their previous history is recovered

Editing Sets

• You can change the set name at any time
• Adding new metrics: they are automatically added to all clients with that set
• Editing metric name/unit: changes are reflected immediately
• Deleting metrics: they are archived (see archiving section)

---

Logging Values

By the Client

Clients can log values in two ways:

1. From Progress: Select set → metric → Add Entry → enter date and value
2. From Routine: If you include metrics in the day's routine, a form appears with all the metrics in the set

Note: If the client completes all metrics in the set on the same day, the item is automatically marked as completed.

By the Trainer

You can also log values on behalf of your clients:

1. Client profile → Metrics section → Select metric → Add Value
2. Enter date and value → Save

---

Visualization

• Set View: Lists all metrics with initial and current value
• Individual Metric View: Time evolution chart + value list + statistics (initial, current, maximum, minimum)
• Filters: Last 7 days, 3 months, year, or full history

---

Archiving Metrics

Archiving lets you "hide" metrics without losing the historical data.

Behavior

Archived metrics:

• ❌ Clients lose complete access to the metric
• ❌ They cannot view or log values
• ✅ You can restore the metric at any time

Archived sets:

• ❌ Clients lose complete access to the set
• ❌ They cannot view or log values
• ❌ Not automatically assigned to new clients

Process

When deleting a metric or set, the system shows a warning with the impact (how many clients are affected, routines using it, etc.). Upon confirmation, it is archived but the history is preserved.

---

Frequently Asked Questions

---

Technical Documentation

If you are a developer and need to understand the technical implementation of the metrics system (architecture, endpoints, data models), refer to the technical documentation at back/docs/metrics-implementation.md in the repository.

---

TrainerStudio - Precise tracking, visible progress