> For the complete documentation index, see [llms.txt](https://docs.norrnext.com/norrcompetition/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.norrnext.com/norrcompetition/battle-mode/backend-management.md).

# Backend Management & Logs

Manage battle contest entries, review duel logs, inspect guest identifiers, and purge aged logs in the administrator area.

NorrCompetition provides comprehensive tools in the Joomla administrator panel to monitor battle activities, sort contenders by duel performance, audit votes, and perform database maintenance.

***

### Managing Entries (`NorrCompetition > Entries`)

The administrator Entries view adapts dynamically depending on whether you are browsing a specific Battle contest or viewing all entries:

#### 1. Filtered Contest View

When you filter the list by a contest that uses **Battle Mode** (using the contest filter dropdown), the standard voting columns are replaced with three dedicated battle metrics:

* **Points (`battle_points`):** The total battle points accumulated by the entry (e.g., `14.5`).
* **Displays (`battle_display_count`):** The total number of times the entry was presented in duel pairs (e.g., `18`).
* **Rating (`battle_rating`):** The calculated ratio ($\text{Points} / \text{Displays}$), displayed as a primary badge (e.g., `0.81`).

Each of these three columns supports full ascending and descending sorting, allowing moderators to quickly analyze top performers or identify entries with low impression counts.

<figure><picture><source srcset="https://4110454137-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FemWP543OtNCmlHpJBjKV%2Fuploads%2Fgit-blob-243b71fa862d6d06e12f24df89521f3ed93004bd%2Fbattle-mode-entries-ranking-columns-dark.png?alt=media" media="(prefers-color-scheme: dark)"><img src="https://4110454137-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FemWP543OtNCmlHpJBjKV%2Fuploads%2Fgit-blob-9fc493499f470689913a5899b84cad4ff483d11b%2Fbattle-mode-entries-ranking-columns-light.png?alt=media" alt="NorrCompetition Entries List with Battle Mode Metrics"></picture><figcaption><p>Entries list filtered by Battle Contest, showing Points, Displays, and Rating columns</p></figcaption></figure>

#### 2. General Entries View

When browsing entries across multiple contests simultaneously, entries belonging to Battle Mode contests display a gold trophy badge showing their current rating score. Hovering over the badge reveals a tooltip with exact statistics:

> *Battle Statistics — Points: 14.5, Displays: 18*

***

### Auditing Votes (`NorrCompetition > Votes`)

Every battle comparison is logged individually by the system. Administrators can monitor and audit these records in **NorrCompetition > Votes**:

* **Voting Mode Badge:** Each duel entry is marked with a distinct `battle` badge in the ID column.
* **Matchup Column:** Displays the competing contenders in the format **Entry A vs Entry B**:
  * The winning entry is highlighted in bold with a gold trophy icon.
  * If the comparison ended in a tie, a secondary `Tie` badge is displayed.
* **Voter Identification:**
  * **Registered Members:** Shows the voter's username with a direct link to edit their Joomla user account.
  * **Guests:** Displays a `Guest` badge. Hovering over the badge displays a tooltip containing their unique guest verification key.
* **Verification Status:** Marked with a green checkmark badge (`Recorded`).
* **Tracking Metadata:** The information tooltip displays the voter's IP address, device fingerprint, and session details (if tracking options are enabled).

<figure><picture><source srcset="https://4110454137-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FemWP543OtNCmlHpJBjKV%2Fuploads%2Fgit-blob-c83c6d75a68af3b5f760949ceb45424d841c3244%2Fbattle-mode-votes-monitor-matchups-dark.png?alt=media" media="(prefers-color-scheme: dark)"><img src="https://4110454137-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FemWP543OtNCmlHpJBjKV%2Fuploads%2Fgit-blob-8e396986f27f13319e36542c556a29a77e2e66df%2Fbattle-mode-votes-monitor-matchups-light.png?alt=media" alt="NorrCompetition Votes Monitor with Duel Matchups"></picture><figcaption><p>Votes monitor displaying head-to-head duel matchups, trophies, and tie badges</p></figcaption></figure>

***

### Deleting Votes & Automatic Stats Rollback

If a site administrator discovers fraudulent voting activity or needs to remove specific duel records:

1. Select one or more battle rows in **NorrCompetition > Votes**.
2. Click the **Delete** button in the toolbar.
3. The component executes an **automatic rollback**:
   * The selected vote records are deleted from the log.
   * For each deleted record, the awarded points ($1.0$, $0.5$, or $0.0$) and display counts ($1$) are automatically deducted from both contenders.
   * Contender standings and ratings update immediately, ensuring leaderboard integrity without requiring manual recalibration.

***

### Maintenance: Clean Outdated Guest Logs

Over long periods, high-traffic battle contests can generate large volumes of guest duel logs. To maintain optimal database performance while preserving historical ratings:

1. Navigate to **NorrCompetition > Votes**.
2. Click the **Clean Outdated Guest Logs** button in the toolbar (indicated with a purge icon).
3. Confirm the action when prompted.

#### What this action does:

* Deletes guest log records older than **30 days** belonging to **closed contests**.
* Does **not** modify or reset contest standings or participant scores — all accumulated points, display counts, and finalized leaderboard ratings remain permanently intact.
* Displays an informative notice reporting the exact number of purged log rows (e.g., *1,420 outdated guest battle logs were deleted*).
