Training

Train staff and volunteers using structured topics, video content, and quiz questions -- all managed from the admin panel.

Overview

The Training module lets you build a library of learning material for your food bank's staff and volunteers. Content is organised into topics and subtopics. Each subtopic can hold a video and a set of multiple-choice quiz questions. Staff members work through the material at their own pace, and the system tracks their quiz results automatically.

Each food bank manages its own training library.

Key Concepts

• Topic -- A top-level grouping (e.g. "Health & Safety", "Warehouse Procedures"). Each topic has a name, optional description, and a position that controls display order.
• Subtopic -- A lesson within a topic. Subtopics carry the actual learning content: an optional video and quiz questions. They also have a name, description, and position.
• Video -- A video file uploaded to S3 storage and attached to a subtopic. Supported formats are MP4, WebM, OGG, and QuickTime (MOV). Maximum file size is 3 GB. Videos are streamed to staff via time-limited presigned URLs (valid for 120 seconds at a time).
• Quiz question -- A multiple-choice question attached to a subtopic. Each question has question text, a position, and one or more answer options. One or more options can be marked as correct.
• Question option -- An individual answer choice. Each option has text, a position, and a correct/incorrect flag.
• Training attempt -- A record of a staff member answering a quiz question. The system stores who answered, which option they selected, whether it was correct, and when the attempt occurred (with timezone).

How It Works

Viewing training (all admin users)

Any logged-in admin user can access the training area from Settings > Training in the sidebar. The training index page lists all topics for your food bank. Each topic shows its subtopics, and a progress indicator displays how many quiz questions the user has answered correctly.

Clicking a topic opens its subtopic list. Clicking a subtopic opens the lesson page, which shows:

1. The subtopic description.
2. The video player (if a video is attached).
3. The quiz questions with multiple-choice options.
4. A results table showing the user's previous attempts.

When a user submits the quiz, the system records one attempt per question. The results table updates immediately (the form supports AJAX submission). Progress is tracked per admin user, so each staff member sees their own scores.

Managing topics

Topic and subtopic management is accessed at Configuration > Training Topics.

The training topics grid displays:

| Column | Description | |----------|-----------------------------------| | Position | Sort order for display | | Name | The topic title | | Food Bank | Which food bank owns it |

From the grid you can create, edit, or delete topics, and click "Manage Subtopics" to drill into a topic's subtopics.

Managing subtopics

The subtopics page for a topic lists all subtopics ordered by position. From here you can:

• Create a new subtopic with a name, description, position, and optional video upload.
• Edit an existing subtopic to change its details or replace/remove its video.
• Delete a subtopic (this also deletes its video from S3 and all associated quiz questions).
• Delete video only without removing the subtopic itself.

When uploading a video, the system validates the file type and size, generates a unique 8-digit slug, and uploads the file to S3. If the subtopic already has a video, the old one is deleted from S3 before the new one is stored.

Managing quiz questions

From a subtopic's management page, click through to manage its quiz questions. The question list shows all questions ordered by position. For each question you can:

• Create a new question with question text, position, and multiple answer options.
• Edit a question to change its text or options.
• Delete a question.

When creating or editing a question, you define the answer options inline. Each option has text and a checkbox to mark it as correct. You can have multiple correct answers. When saving, existing options are replaced with the submitted set.

Common Tasks

Add a new training topic

1. Go to Configuration > Training Topics.
2. Click Create.
3. Enter a name, optional description, and position number.
4. The food bank is set automatically.
5. Click Save.

Add a subtopic with video

1. From the training topics grid, click Manage Subtopics on the target topic.
2. Click Create.
3. Enter a name, description, and position.
4. Choose a video file (MP4, WebM, OGG, or MOV, up to 3 GB).
5. Click Save. The video uploads to S3.

Add quiz questions to a subtopic

1. From the subtopics list, click through to the target subtopic's questions.
2. Click Create.
3. Enter the question text and set the position.
4. Add answer options. Check the "Correct" box for the right answer(s).
5. Click Save.

Remove a video from a subtopic

1. Edit the subtopic.
2. Click the Delete Video button.
3. Confirm the deletion. The video is removed from S3.

View staff progress

1. Go to Settings > Training.
2. The progress map shows how many questions each topic's subtopics have, and how many the current user answered correctly.
3. Click into a subtopic to see the detailed results table with each attempt's date, selected option, and correctness.

FAQ

Who can view training content? All admin users with the ROLE_ADMINISTRATION_ACCESS role can view topics, watch videos, and take quizzes.

Who can manage training content? Administrators with the appropriate permissions can create, edit, or delete topics, subtopics, and quiz questions.

Is training content shared across food banks? No. Each topic belongs to a specific food bank. Staff only see topics for their own food bank.

What video formats are supported? MP4, WebM, OGG, and QuickTime (MOV). The maximum file size is 3 GB.

Can a question have more than one correct answer? Yes. Multiple options can be marked as correct.

Are quiz attempts permanent? Yes. Every submission creates new attempt records. The system shows the latest attempt per question on the subtopic page, and tracks cumulative progress on the topic overview.

What happens if I delete a subtopic? The subtopic, its video (from S3), all quiz questions, all question options, and all related attempt records are permanently deleted (via cascade).