Graduations

The graduation system in Omoplata tracks belt ranks and stripes for your members. It supports multiple disciplines, audience-specific belt systems (kids, teens, adults), and class attendance requirements for promotions.

Belt systems

Each discipline in your club can have its own belt system. Belts are ordered by sequence and can be scoped by audience:

• Kids -- A belt progression designed for younger students, often with more intermediate belts and different colors than the adult system.
• Teens -- An optional separate progression for teenage students.
• Adults -- The standard belt progression for adult practitioners.

Each belt has the following properties:

• Name -- The display name (for example, "White Belt", "Blue Belt").
• Code -- A short identifier used internally.
• Color -- The hex color code used for visual representation.
• Sequence -- The numerical order within the belt system. Lower numbers come first.
• Audience -- Which age group the belt applies to (kids, teens, or adults).

Viewing a member's current belt

The member's current belt is visible in several places:

Members list

When the graduation feature is enabled, a Graduation column appears in the members table. It shows the current belt for each discipline the member trains in, including:

• The discipline name (shown only when the club has multiple disciplines)
• A visual belt representation with the belt color
• The current stripe count
• The next belt color (shown as a preview)

Belts are sorted by discipline, then by audience (kids, teens, adults), and finally by sequence.

Member overview

The Overview tab on a member's profile shows a detailed graduation section with:

• Current belt -- A visual belt with the belt name, color, and stripe count.
• Stripe progress -- If the belt system defines a maximum number of stripes, the progress is shown (for example, "2 / 4 stripes").
• Attendance until graduation -- A progress bar showing how many classes the member has attended since their last promotion relative to the requirement for the next belt (for example, "45 / 60 classes"). The remaining classes needed are displayed below.

Awarding a graduation

To promote a member to the next belt or award a stripe, click the Award graduation button on the member's Overview tab. A button appears for each discipline the member is eligible for.

Award graduation modal

The award graduation modal lets you:

1. Select the belt to award. The system shows the belts available for the member's audience (kids, teens, or adults) within the selected discipline.
2. Set the stripe count for the new belt.
3. Choose the awarded date -- when the promotion officially took effect.

When a new belt is awarded, the previous belt progress record is marked as superseded. Only the current (non-superseded) belt records are displayed throughout the app.

Awarding stripes

Stripes represent intermediate progress within a belt. In Brazilian Jiu-Jitsu, for example, a blue belt can earn up to four stripes before being promoted to purple belt. You can award stripes by updating the member's current graduation record.

Graduation history

Each promotion creates a belt progress record in the system. The history includes:

• The belt that was awarded
• The stripe count at the time
• The date the graduation was awarded
• Which record it superseded (linking to the previous belt)

Only the most recent (non-superseded) record for each discipline is shown as the member's "current" belt. The full history is maintained for audit and reporting purposes.

Discipline-specific belt systems

Omoplata supports clubs that teach multiple martial arts, each with its own belt hierarchy. Common examples:

Brazilian Jiu-Jitsu

A typical BJJ belt system includes:

• Kids: White, Grey-White, Grey, Grey-Black, Yellow-White, Yellow, Yellow-Black, Orange-White, Orange, Orange-Black, Green-White, Green, Green-Black
• Adults: White, Blue, Purple, Brown, Black

Each belt can have up to 4 stripes (degrees) before promotion to the next belt.

Judo / Karate

Traditional belt systems with colors like White, Yellow, Orange, Green, Blue, Brown, Black, each potentially with degrees.

Muay Thai

Some Muay Thai schools use an armband or prajiad system instead of belts. Omoplata's flexible belt system can represent these as well.

Class requirements for promotion

The graduation system can track class attendance requirements for belt promotions. When a belt defines a minimum number of classes required, the Overview tab shows:

• A progress bar indicating how many classes the member has attended since their last promotion.
• The total classes required for the next belt.
• The number of remaining classes needed.

This helps both trainers and members understand how close a student is to being eligible for promotion. The attendance count is based on actual check-ins recorded through the system.

Graduations and the members list

The graduation column in the members list provides a quick visual overview of every member's rank. This makes it easy to:

• Identify members who are ready for promotion based on their stripe progress.
• See the belt distribution across your club at a glance.
• Filter by discipline to review rank progression within a specific martial art.

Each belt display in the list includes the belt color, current stripes, and the next belt color, giving you immediate visual context about where each member stands in their journey.