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

```javascript
// 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