Desert Storm Command Centre

---

Editing data from: start.csv

Name	Power	Availability	Regular Status	Force to Kill Squad	Actions

User Manual

Welcome to the Desert Storm Command Centre! This tool is designed to help you manage player rosters and generate balanced teams and statistics for your Desert Storm Events. This is a real-time collaborative application - all changes you make are instantly visible to other team members.

Login & Authentication

• Shared Password: This application uses a single shared password that all team members use to access the app. This password is common to everyone and should be treated with care.
• ⚠️ IMPORTANT SECURITY: Never share the password publicly or with unauthorized individuals. If you suspect someone unauthorized may have seen the password, change it immediately using the Security tab.
• Session Duration: Your login session lasts for 24 hours. After that, you'll need to log in again.
• Master Password: There is also a master password for recovery purposes. This can only be used to reset the user password if forgotten - it cannot be changed from the Security tab.

Real-Time Collaboration

• Connection Status: Look for the colored dot under the navigation bar - green means you're connected and receiving real-time updates, red means disconnected.
• Online Users: The number shown next to the connection status indicates how many team members are currently using the app.
• Instant Syncing: When anyone makes a change (roster edits, team generation, rule changes, history logging), all connected users see the update instantly with a notification.
• Shared Data: The roster, rules, generated teams, and game history are all shared across the entire team - everyone works with the same data.

Roster Management Tab

• Add Player: Opens a dialog to add a new player with their name, power level, availability, and regular status.
• Quick Update: A fast way to find a player by name and edit their details without scrolling through the table.
• Add Regulars: Automatically sets the availability of all players marked as 'Regular Main' or 'Regular Sub' to 'Main' and 'Sub' respectively. This is a quick start for event prep.
• Reset All Availability: Sets every player's role to 'Not Available'. Useful for starting fresh for a new event.
• Clear All Data: Wipes the entire roster and all generated teams from the application. Use with caution!
• Import/Export Roster: Load a player list from a .csv file or save the current roster to a .csv file. The CSV must have headers: `Name,Power,Role,RegularStatus`.
• Save Roster: Saves the current roster to the database. All team members will see your changes instantly.

Team Generation Tab

• Number of Teams Selector: Choose between Auto (automatically determines 1 or 2 teams based on player count), 1 Team (force single team), or 2 Teams (force two teams). Auto mode uses 1 team for ≤26 players and 2 teams for >26 players.
• Generate Teams: The main button. It takes all players marked as 'Main', applies the grouping rules, and divides them into balanced teams. Generated teams are saved and shared with all users instantly.
• Rebalance Hospitals: After teams are generated, this shuffles only the 'Hospital' group players to try and get a better balance without affecting the 'Kill Squads'.
• Swap Groups: Allows you to manually swap any two groups (e.g., Team A's Kill Squad with Team B's Hospital 2).
• Log Game to History: After a game, click this to save the current team composition to the history file for statistical tracking.
• Undo/Redo: Step backward or forward through your recent changes, including player edits and team generations.
• Copy/Save Buttons: Easily copy roster text for Announcements/Discord or save the full team details to a .txt file.

Grouping Rules Tab

• Always Together: Create rules for players who must be on the same team. When adding this rule, you can toggle between:
  • Strict Placement: Players will be placed in the same building (Kill Squad or Hospital).
  • Flexible Placement: Players will be on the same team but can be in different buildings.
• Never Together: Create rules for players who must be on opposite teams. These players will never be assigned to the same team.

Statistics & History Tab

• This page shows historical data from games you have logged. History is shared across all team members.
• You can see overall stats, track player attendance over time, and view a chart of the power balance from the most recently generated teams.
• Real-Time Updates: When anyone logs a game or clears history, all connected users will see the update instantly.
• Clear History: Permanently deletes all logged game data for everyone. This action requires confirmation and cannot be undone.
• Attendance Trend Slider: Adjust this slider to change the number of recent games displayed on the Attendance Trend chart, from 5 to 52 (a full year).

Security Tab

• Change User Password: Updates the shared password that all team members use to log in. ⚠️ After changing the password, notify all team members immediately so they can log in with the new password.
• Master Password Recovery: If the user password is forgotten, you can use the master password to reset it. The master password itself cannot be changed from the Security tab.
• Logout: Ends your current session. You'll need to log in again to access the app.
• ⚠️ Security Best Practices:
  • Never share passwords in public channels (Discord, forums, etc.)
  • If you suspect unauthorized access, change the password immediately
  • Use the Security tab privately - don't share your screen when changing passwords

Installing as an App (Optional)

• What "Install" Means: You may see a banner at the bottom of the screen asking to "Install Desert Storm Command Centre as an app." Don't worry - nothing is actually installed on your computer in the traditional sense. It simply creates a shortcut that opens the app in its own window.
• Benefits of Installing:
  • Adds an app icon to your desktop/home screen for quick access
  • Opens in its own window (without browser tabs/address bar) for a cleaner experience
  • Easier to launch - just click the icon like any other app
• ⚠️ Important: Installing does NOT enable offline mode. This is a fully collaborative app that requires an internet connection to work. All real-time features, database syncing, and team collaboration require you to be online whether you install it or not.
• You Can Skip It: Installing is completely optional. The app works exactly the same in your regular browser. If you prefer not to install, just click "Not Now" on the banner.

Collaborative Features & Data Management

• Database Storage: All data (roster, rules, teams, history) is stored in a secure database and shared across all team members.
• Export Backup: Use "Export Roster" to download your data as a CSV backup for safekeeping.
• Persistent Sessions: Your generated teams persist across browser refreshes and are visible to all team members.
• Notifications: Toast notifications appear when other users make changes (e.g., "Roster updated by another user").
• Internet Required: This app requires an active internet connection for all collaborative features to work properly.

Security Settings

Manage passwords and authentication settings.

Change User Password

Change the shared password used by all team members to access the app.

Change Password

Master Password Recovery

Use the master password to reset the user password if it's forgotten. The master password cannot be changed from here.

Reset User Password

Session Management

Your session will automatically expire after 24 hours of inactivity.

Logout