MyClub/POLL_CREATION_FEATURE.md

# Poll Creation Feature in Activity Management

## Summary
Enhanced the activity creation/editing interface to allow direct poll (anketa) creation without navigating away to a separate page.

## Changes Made

### 1. Enhanced PollLinker Component
**File:** `frontend/src/components/admin/PollLinker.tsx`

#### New Features:
- **Tabbed Interface**: Added two tabs for better organization
  - **Tab 1: "Propojit existující"** - Link existing polls (original functionality)
  - **Tab 2: "Vytvořit novou"** - Create new polls inline
  
- **Inline Poll Creation Form** includes:
  - Poll title (required)
  - Description (optional)
  - Poll type selector (single/multiple choice)
  - Dynamic options list (min. 2 options)
    - Add/remove options with validation
    - Each option has its own input field
  - Guest voting toggle
  - Active status toggle
  - Create button with loading state

#### Technical Implementation:
- Added state management for new poll form (`newPollData`)
- Implemented `createPollMutation` for poll creation
- Added helper functions:
  - `resetNewPollForm()` - Resets form to initial state
  - `handleCreatePoll()` - Validates and submits new poll
  - `addOption()` - Adds new poll option
  - `removeOption()` - Removes poll option with validation
  - `updateOption()` - Updates option text
- Automatically links created poll to the current activity/article

### 2. Updated AdminActivitiesPage
**File:** `frontend/src/pages/admin/AdminActivitiesPage.tsx`

#### Changes:
- Always shows the "Anketa" section (previously hidden for new activities)
- When creating a **new activity**:
  - Displays helpful message: "💡 Nejprve uložte aktivitu, poté budete moci vytvořit nebo připojit anketu přímo zde."
- When editing an **existing activity**:
  - Shows full PollLinker component with both tabs
  - Users can immediately create or link polls

## User Experience Flow

### Creating Activity with Poll:
1. User creates a new activity
2. Fills in activity details
3. Sees poll section with informative message
4. **Saves the activity first**
5. Reopens the activity for editing
6. In the "Anketa" section:
   - Switch to "Vytvořit novou" tab
   - Fill in poll details (title, description, type)
   - Add poll options (at least 2 required)
   - Configure settings (guest voting, active status)
   - Click "Vytvořit anketu"
7. Poll is automatically created and linked to the activity

### Editing Activity - Adding Poll:
1. Open existing activity
2. Scroll to "Anketa" section at the bottom
3. Choose between:
   - **Propojit existující**: Select and link an existing poll
   - **Vytvořit novou**: Create a new poll inline
4. Poll appears on the activity detail page for users to vote

## Technical Details

### API Integration:
- Uses `/admin/polls` POST endpoint for poll creation
- Automatically sets `related_event_id` when creating poll
- Invalidates relevant query cache after operations

### Validation:
- Poll title is required
- Minimum 2 options required
- Empty options are filtered out before submission
- Warning toasts for validation errors

### State Management:
- React Query for data fetching and mutations
- Local state for form inputs
- Automatic cache invalidation for data consistency

## Benefits

1. **Improved UX**: No need to navigate to separate poll management page
2. **Faster Workflow**: Create polls directly when creating activities
3. **Better Context**: Poll creation happens in the context of the activity
4. **Reduced Clicks**: Fewer page transitions required
5. **Clearer Process**: Tabbed interface makes options obvious

## Future Enhancements (Optional)

- Allow poll creation before saving activity (requires state management)
- Poll templates for common questions (e.g., "Dorazíš na trénink?")
- Duplicate existing poll functionality
- Poll preview before creation
- Rich text editor for poll descriptions
- Image support for poll options
- Poll scheduling (start/end dates) in the inline form

## Testing Checklist

- ✅ Create new activity and see poll section message
- ✅ Save activity and reopen to create poll
- ✅ Create poll with 2 options
- ✅ Add more options dynamically
- ✅ Try to submit poll without title (should show error)
- ✅ Try to submit poll with <2 options (should show error)
- ✅ Toggle guest voting and active status
- ✅ Verify poll appears linked after creation
- ✅ Link existing poll still works
- ✅ Unlink poll still works
- ✅ Poll displays on activity detail page

## Notes

- Frontend changes require rebuild if running in Docker: `docker compose restart frontend`
- For local development, changes should hot-reload automatically
- Poll creation requires the activity to be saved first (has an ID)
- All poll text is in Czech to match the application language