Kurash TMS Help
Organized help page for the independent Kurash Tournament Management System.
Current Help: v35.10X
Production:
https://tms.kurash-tms.com
Controller / Display / Main Scoreboard are separate tracks
1. Main Pages and Direct Links
Portal / IndexMain entry page.
Main WebSettings, players, draw, reports, embedded tabs.
Standalone ScoreboardOriginal online scoreboard page. Separate from Controller/Display.
Scoreboard ControllerOperator control panel for a selected Gillam.
Display ScoreboardPublic screen driven by Controller + server live state.
Weigh-inStandalone weigh-in operations.
Player ScreenPublic player/current/next display.
Referee ScreenReferee public assignment display.
Referee ManagementHead-referee assignments, final pool, evaluations.
Delegation Sign-offTablet-friendly player review and signature.
Ceremony DrawDraw presentation and ceremony view.
2. Recommended Tournament Flow
- Create or load tournament from Main Web.
- Confirm settings: tournament type, Gillams, age/sex/weight groups, duration, draw mode, referee mode.
- Import or add players in Players.
- Review players, countries/affiliations, flags, DOB warnings, and weight category.
- Add/edit referees and confirm availability.
- Run delegation sign-off where needed.
- Generate draw and check warnings before operation.
- Use Referee Management for assignments, rotation, evaluations, and final pool.
- Operate bouts using either Standalone Scoreboard or Controller + Display depending on the hall setup.
- Use reports for fight order, medals, referee workload, bout metadata, and results.
3. Scoreboard Tracks - Important Separation
| Track | Files | Purpose | Rule |
|---|---|---|---|
| Main Web Scoreboard Tab | main_web_v35.html | Embedded scoreboard inside Main Web. | Do not change when fixing standalone page unless explicitly requested. |
| Standalone Scoreboard | scoreboard_v35.html | Classic online scoreboard page with View 1 / View 2 and local operation. | Can copy suitable UI ideas from the tab, but page logic must stay independent. |
| Controller + Display | scoreboard_controller_v35.htmldisplay_scoreboard_v35.htmlserver.js | Controller sends commands; Display shows public official screen. | Separate live-state direction: Controller command → server live state → Display/Controller render. |
| Offline Scoreboard PWA | scoreboard_offline_start.html | Installable local scoreboard app with Web Offline Scoreboard and Install App options. | Uses local React 18 files, offline cache, and does not save official TMS results. |
4. Scoreboard Controller + Display
Controller behavior
- Lock one Gillam for the operator.
- Select bout from Fight Order, then press READY / LOAD.
- Use START / STOP as one button.
- Use + / - for score and penalties.
- Right-click treatment reduces the medical count.
- Right-click withdrawal cancels withdrawal.
Display behavior
- Displays the last loaded bout until READY loads a new bout.
- Uses fixed-grid layout so timer, letters, scores, flags, and names fit without overlap.
- Shows score/penalty feedback flashes.
- Shows treatment icons; two treatments show two ambulance icons.
- Jazo stops time and blocks restart until cleared or a score/penalty is entered.
Current working display layout baseline: v35.10S fixed grid. Current feedback/right-click baseline: v35.10N. Timer sync baseline: v35.10L/M.
5. Weigh-in Operations
- Standalone page:
weighin_screen_v35.html. - Loads current tournament from the production server.
- Groups players by Men/Women room, age group, and registered weight group.
- Records accepted/rejected status and actual weigh-in data.
- v35.10W fixed
groupLabel is not definedinside the Weigh-in page only.
6. Referee Management
- Basic referee records are maintained in the Main Web Referees area.
- Assignments, final pool, exam/test flags, quota, and evaluation are handled in Referee Management.
- Rotation modes support regular bouts and finals/special bouts separately.
- Rebalance should protect current and next bout and avoid changing completed/played bouts.
- Referee reports include fight order officials, workload, and evaluation outputs.
7. Reports and Printing
- Fight Order report should identify title and page number on repeated pages.
- Kurash fight order should show main referee and judges, with the main referee visually distinct.
- Daily Report is planned for medals by country for the selected day.
- Bout Metadata report tracks scoreboard metadata and event logs.
- Reports are separate from live Controller/Display operation.
8. Server and Deployment
Common checks
node --check server.jschecks JavaScript syntax before restart.pm2 restart allrestarts running PM2 apps.pm2 logs --lines 50displays the last 50 log lines for diagnosis./api/pingchecks backend availability.
Deployment cautions
- Do not overwrite a working
package.jsonunless the patch explicitly requires it. - Production data folder should not be replaced by patch ZIP files.
- After uploading HTML/JS, hard refresh browser cache with
Ctrl + F5. - Keep Controller/Display/server files from the same patch family when testing live state.
9. Troubleshooting
| Problem | Likely cause | Action |
|---|---|---|
| 403 page error | File permission or web server access. | Check file exists and permissions such as chmod 644 *.html. |
| 502 / server down | Backend not running. | Check PM2 status and logs. |
Cannot POST /api/scoreboard/live/.../set-score | Controller file newer than server.js. | Upload matching server.js from the same patch and restart PM2. |
| Display holds last loaded bout | Temporary sync delay or missed snapshot. | Use READY / LOAD again, check server, then refresh Display if needed. |
| Weigh-in groupLabel error | Old Weigh-in file missing helper. | Apply v35.10W Weigh-in fix. |
| Page looks unchanged after upload | Browser cache. | Hard refresh with Ctrl + F5 or open in private window. |
10. Recent Patch Notes
| Version | Area | Summary |
|---|---|---|
| v35.10S | Display Scoreboard | Fixed-grid display layout; no overlap/hidden scores or letters. |
| v35.10T | Standalone Scoreboard | Rebuilt standalone scoreboard page from working base and suitable Main Web tab UI. |
| v35.10U | Standalone Scoreboard | Added View 2-style announcements/animations for scores, penalties, winner, Jazo, and removal. |
| v35.10V | Players Tab | Reduced player flags and used contained fit inside the existing space. |
| v35.10W | Weigh-in | Fixed groupLabel is not defined in Weigh-in page only. |
| v35.10X | Help | Reorganized Help page into clear operational sections and removed broken sections outside the HTML body. |