# MW-2998: Add Interview Rounds and Recruiter to Optional Fields

## Ticket Information
- **Jira Ticket**: MW-2998
- **Type**: Improvement
- **Priority**: High
- **Status**: In Progress
- **Summary**: Add Interview Rounds and Recruiter as optional fields that can be enabled or disabled as needed.

## Acceptance Criteria
✅ Interview Rounds can be added as an optional field
✅ A recruiter can be added as an optional field

## Implementation Details

### 1. Database Migration
**File**: `Modules/Recruit/Database/Migrations/2026_02_24_183225_add_interview_rounds_recruiter_optional_fields_to_recruit_jobs_table.php`

Added two new boolean columns to the `recruit_jobs` table:
- `is_interview_rounds_require` (default: false)
- `is_recruiter_require` (default: true) - Set to true to maintain backward compatibility

**Migration Status**: ✅ Ran successfully

### 2. Controller Updates
**File**: `Modules/Recruit/Http/Controllers/JobController.php`

Updated both `store()` and `update()` methods to handle the new optional fields:
```php
$job->is_interview_rounds_require = $request->is_interview_rounds_require ?: '0';
$job->is_recruiter_require = $request->is_recruiter_require ?: '0';
```

### 3. View Updates

#### Create Job Form
**File**: `Modules/Recruit/Resources/views/jobs/ajax/create.blade.php`

Added two new checkboxes in the "Extra Fields" section:
1. **Interview Rounds** checkbox
2. **Recruiter** checkbox (defaults to checked for backward compatibility)

#### Edit Job Form
**File**: `Modules/Recruit/Resources/views/jobs/ajax/edit.blade.php`

Added the same two checkboxes for consistency with the create form.

### 4. Language/Translation Updates
**File**: `Modules/Recruit/Resources/lang/eng/modules.php`

Added translation key:
```php
'interviewRounds' => 'Interview Rounds',
```

## Files Modified

1. ✅ `Modules/Recruit/Database/Migrations/2026_02_24_183225_add_interview_rounds_recruiter_optional_fields_to_recruit_jobs_table.php` (NEW)
2. ✅ `Modules/Recruit/Http/Controllers/JobController.php`
3. ✅ `Modules/Recruit/Resources/views/jobs/ajax/create.blade.php`
4. ✅ `Modules/Recruit/Resources/views/jobs/ajax/edit.blade.php`
5. ✅ `Modules/Recruit/Resources/lang/eng/modules.php`

## How It Works

1. **Creating/Editing a Job**: Admin can now check/uncheck the "Interview Rounds" and "Recruiter" checkboxes in the "Extra Fields" section of the job form.

2. **Default Behavior**: 
   - Interview Rounds: Unchecked by default (optional field is disabled)
   - Recruiter: Checked by default (maintaining backward compatibility as it was previously a required field)

3. **Database Storage**: The selections are saved as boolean values (0 or 1) in the `recruit_jobs` table.

4. **Future Enhancement**: The job application form can now use these settings to conditionally show/hide these fields based on the job's configuration.

## Testing Recommendations

1. **Create New Job**: Verify that both checkboxes appear in the "Extra Fields" section
2. **Edit Existing Job**: Confirm checkboxes are displayed and existing jobs default to having "Recruiter" checked
3. **Save Job**: Ensure the values are properly saved to the database
4. **Job Application Form**: (Future work) Verify fields are shown/hidden based on job settings

## Notes

- The `is_recruiter_require` field defaults to `true` (1) in the migration to maintain backward compatibility with existing jobs
- The recruiter field in the main form still has `fieldRequired="true"` - this can be made dynamic based on the optional field setting in future enhancements
- Language translations have been added for English; additional language files may need updates if the application supports multiple languages

## Next Steps (Optional Enhancements)

1. Update the job application form to conditionally show/hide the "Interview Rounds" field based on `is_interview_rounds_require`
2. Make the recruiter field dynamically required/optional based on `is_recruiter_require` setting
3. Update validation rules to respect these optional field settings
4. Add translations for other supported languages

---

**Implementation Date**: February 24, 2026
**Implemented By**: Rovo Dev (AI Assistant)