Kurash Tournament Manager Help

Official help and release notes for the independent Kurash TMS platform. This page summarizes the core workflow, operational pages, server tools, and v35.7 release changes.

Release v35.7 Production https://tms.kurash-tms.com Backend merge-safe where available Status operational help page

1. Main Pages and URLs

Main System Pages

Main Web: tournament setup, players, referees, draw, reports, and integrated scoreboard.
Online Scoreboard: Gillam operation and result saving.
Player Screen: public/current/next bout display.
Referee Screen: referee assignment display.
Referee Management: head-referee assignment, evaluation, final pool, quota, and special matches.
Delegation Sign-off: tablet-friendly delegation review and approval before draw.
Weigh-in Screen: standalone page for official weigh-in operations.

Official URLs

TMS: https://tms.kurash-tms.com
API health: https://tms.kurash-tms.com/api/ping
File management: https://files.kurash-tms.com
Saudi Kurash API: https://api.saudikurash.sa/

2. Recommended Tournament Flow

Create, load, activate, archive, or offload a tournament from Home / Tournament Workspace.
Confirm Settings: tournament type, Gillams, duration rules, weight/group mode, bye allocation, and referee assignment mode.
Add/import players in Players. Enable Weigh-in Function if the official accepted list must be built after weigh-in.
Add/edit referees in Referees and manage assignments in Referee Management.
Complete Delegation Sign-off when required.
Generate the draw, review warnings, and mark special matches when needed.
Use One Gillam / Finals Stage Operations when selected late-stage or special bouts must move to one Gillam.
Operate bouts from the Scoreboard and monitor Reports / Visualization.

3. Server, Sync, and Data Management

Server and Sync Rules

Sync Now intentionally pushes local Main Web data to the server.
Automatic refresh should not overwrite unsynced local edits.
Result and referee-operation saves use merge-safe routes where possible.
Use /api/sync/status to confirm mergeSafe: true.

Data Management Panel

Safe admin actions for selected records, tournaments, and imported data.
Archive-before-delete safeguards.
No destructive bulk delete without backup.
Tournament Manager list/offload can show local/server location and archive status.

Operations Tools

Cockpit: server monitoring, logs, services, and terminal.
File Browser: upload and replace TMS files under /var/www.
PM2: sudo pm2 list, sudo pm2 restart kurash-tms --update-env, sudo pm2 save.
Use sudo for PM2 because production services currently run under root PM2.

4. Draw, Gillams, BYE, and One Gillam

Draw and BYE Rules

First-round BYE is not a real operational bout.
BYE does not need referees, does not appear on Scoreboard, and does not count in workload.
Waiting-for-result bouts are future real bouts and must not be mislabeled as BYE.
Generate Draw warns if affiliations have not signed, but does not hard-block unless changed later.

One Gillam / Finals Stage Operations

Can move selected Semi-final, Bronze, Final, and marked Special Matches to one target Gillam.
Preserves bout numbers, bracket links, results, and referee assignments.
Protected played/saved bouts are not modified.
Preview shows selected, will move, and protected bouts before applying.

Special Match Marking

Special Match column is available in Draw & Gillams.
Special matches are internal operational marks.
When selected in One Gillam, pending special bouts can move to the target Gillam.

5. Scoreboard Operations

Core Scoreboard Notes

Online Scoreboard should save bout results through /api/bout/:no/save.
Main Web scoreboard preserves the selected bout during live refresh.
Fullscreen mode includes the bout dropdown.
Start/Stop is a single large bottom action button.

Withdrawal and Full Reset

Withdrawal controls are close to the scoring panels.
D/DD status appears for withdrawal / double withdrawal in dropdown where applicable.
Full Reset clears the saved bout result and returns the bout to pending with confirmation.
Double withdrawal creates blocked-path handling instead of breaking bracket progression.

6. Referee Management

Referee Management Scope

Basic referee data is maintained in the Main Web Referees tab.
Assignments, final pool, and evaluations are handled in Referee Management.
External Referee Management connects to the same backend and uses the production URL by default.

Advanced Referee Tools

Internal Special Match Marking: mark sensitive/high-level bouts.
Participation Quota: 100%, 75%, 50%, 25%, or 0% per referee.
Grace behavior: quota reduction affects future assignments after protected current/next bouts.
High-rated warning: reducing a referee with average score of 90+ shows confirmation warning.
Manual filters: hide 0%, hide reduced, final-pool-only, and minimum average score.

7. Weigh-in Operations

The Weigh-in function creates the accepted competition list while preserving the original registration list.

Feature	Behavior
Enable Weigh-in Function	Available in Players. When enabled, accepted-to-compete data is produced from weigh-in decisions.
Group display	Weigh-in can be grouped by Weight / Group or by Country / Affiliation.
Actual Weight	Operator enters the real measured weight for each athlete.
Match Weight	Green when the actual weight matches the registered category; red when action is required.
Assign to eligible weight group	Moves the athlete to the correct eligible weight group based on actual weight.
Weigh-out	Keeps the athlete in the draw but treats the athlete as withdrawn from the match flow.

8. Reports and Visualization

Reports

Player results, country results, matches report, referee assignment, penalties, players by weight, and player count summaries.
Tables use v35.7 zebra style while preserving important status colors.

Visualization Tab

Visual summaries for players, countries, bouts, medals, referees, Gillam load, stages, and operational indicators.
Top countries by players are sorted highest to lowest.
Medal summary uses separate Gold / Silver / Bronze bars for each country.

9. Troubleshooting

Problem	Check / Action
403	Verify files exist and run permissions fix, for example `chmod 644 /var/www/kurash-tms/*.html`.
502	Confirm PM2 service is online and backend port 4010 is reachable.
Scoreboard not updating	Check `/api/ping`, then reload Scoreboard and Main Web.
After upload	Use hard refresh `Ctrl + F5` or clear browser cache if needed.

10. v35.7 Release Notes

Release Highlights

v35.7 Patch 5BB Zebra tables Protected status colors

All pages updated to v35.7 wording.
package.json updated to 35.7.0.
Universal zebra style added to tables without overriding important status colors.

Preserved Logic

Scoreboard result saving and timer protections.
Weigh-in tab and standalone page.
One Gillam and Special Match logic.
Full Reset and withdrawal / double withdrawal handling.
Referee Management protections and evaluations.