What this module is for

The Bonuses module is the operator workspace for maintaining the CRM bonus catalog and checking how those bonus definitions later appear on issued player bonuses.

Use it when you need to:

• create a new reusable bonus offer
• edit dates, visibility, payout behavior, or promotional text
• archive or restore old bonus definitions
• inspect one bonus record in detail before changing it
• trace a player-issued bonus from the bonus catalog into the player-bonus ledger

Surfaces in this module

• List: the main catalog with filters, archive mode, row actions, and search.
• Form: the create and edit flow used for bonus setup and linked CMS content.
• View: the read-only detail screen for one bonus definition.
• Player Bonuses: a related operator surface for issued user bonuses and their lifecycle.

Where operators usually get confused

• Active and Archived are different states. A bonus can be inactive without being archived.
• The create/edit flow does more than save one row. It also prepares linked banner and page content for promotions.
• Visible in Promotions, isTournament, isChallenge, and autoPayout change how the bonus is later exposed or applied.
• The player-bonus ledger is not the same thing as the reusable bonus catalog. One bonus definition can produce many user-bonus records over time.

Data Notes

• Bonus catalog changes affect reusable bonus definitions, not every issued player-bonus record that already exists.
• Activate/deactivate controls availability; archive/restore controls whether the definition stays in the working catalog.
• Some create/edit fields are only local form changes until the operator saves the bonus.
• Promotion content helpers can create, update, publish, or translate linked promotional content after the main bonus save.
• Player-issued bonus records are checked in the Player Bonuses ledger, where filters use player, status, bonus type, and date context.