onyx/knowledge/features/reverse-recruitment.md

Reverse Recruitment System

Feature: Fan-voted candidate recruitment for adult entertainment game

Overview

Players can recruit performers through a fan-driven auction system where existing fans bid to become performers, creating built-in audiences.

Implementation Details

UI Components

• New Tab: "Fans" (🗳️ icon) in navigation bar
• Candidate Pool: Displays 5 candidates with voting stats
• Selected Group: Shows up to 4 selected candidates
• Refresh Button: Generate new candidate pool

Core Functions

// State Management
let fanCandidates = [];      // Current pool of candidates
let selectedCandidates = []; // Player's selected group (max 4)
let fanVotes = 0;            // Total votes cast
let fanRecruits = 0;         // Total recruits made
let fanFollowers = 0;        // Total fan following

// Key Functions
generateFanCandidate()       // Creates random candidate with niche/specialty
refreshFanCandidates()       // Generates new pool of 5 candidates
renderFanCandidates()        // Displays candidates in grid
toggleCandidateSelection()   // Select/deselect candidates (max 4)
recruitSelectedFans()        // Convert selected to roster

Candidate Properties

• Name: Random first + last name combination
• Niche: Twerking, Cosplay, Fitness, Goth, Anime, etc.
• Votes: Popularity metric (100-1000)
• Fans: Follower count (5K-50K)
• Experience: Years (1-5)
• Image: Generated via AI API

Selection Rules

1. Players can select up to 4 candidates from the pool of 5
2. Selecting a 5th candidate automatically creates a new group
3. Each group costs different amounts based on votes/fans

Integration Points

• Connected to existing game.money economy
• Adds to game.girls roster array
• Updates main UI stats via updateUI()

Usage Flow

1. Click "Fans" tab in navigation
2. View 5 candidate cards with voting stats
3. Click candidates to select (max 4)
4. Review selected group below
5. Click "Recruit All Selected" to add to roster
6. Use "Refresh Pool" for new candidates

Technical Notes

• Uses existing card/grid styling from main game
• Compatible with existing switchTab() navigation system
• Uses same image error handling as other tabs
• Cost calculated dynamically based on candidate popularity