Auction Excellence - Parking Lot Management & Quality Inspection

Overview

The Knowledge Base is a training video library that supports both global and auction-scoped content. It provides two content types: regular Videos for in-depth training and Shorts for bite-sized vertical content. Global videos are accessible to all authenticated users and managed by super admins. Auction-scoped videos are visible only to members of a specific auction and managed by the auction’s owner or admin. Progress is automatically tracked as users watch videos, with completion detected at 90% viewed for videos and on first play for Shorts.

Video Browser

Browse and watch training videos organized by category

YouTube Shorts

Manage bite-sized vertical Shorts for quick training content

Progress Tracking

Automatic tracking of watched time and completion status

Auction-Scoped Videos

Auction owners and admins can manage videos for their auction’s team

Access Levels

Capability	Auction Members	Auction Owner/Admin	Super Admins
Browse global published videos and Shorts	Yes	Yes	Yes
Browse auction-scoped published videos	Own auction	Own auction	Yes
Watch videos and Shorts	Yes	Yes	Yes
Track progress	Yes	Yes	Yes
View continue watching	Yes	Yes	Yes
Access global management interface	No	No	Yes
Create/edit/delete categories	No	No	Yes
Add/edit/delete global videos	No	No	Yes
Add/edit/delete global Shorts	No	No	Yes
Add/edit/delete auction-scoped videos	No	Own auction	Yes
Toggle video/Short publishing	No	Own auction	Yes
Reorder categories and videos	No	No	Yes
Create/edit/delete global tags	No	No	Yes
Create/edit/delete auction-scoped tags	No	Own auction	Yes
Assign tags to videos and Shorts	No	Own auction	Yes

The Knowledge Base supports two scopes of content:

Global videos — Accessible to all authenticated users regardless of auction membership. Managed by super admins via Settings > Knowledge Base.
Auction-scoped videos — Visible only to members of a specific auction. Managed by the auction’s owner or admin from the auction’s Knowledge Base tab.

Categories are shared globally across both scopes. On mobile, users access the Knowledge Base from the Home tab’s Resources section.

Accessing the Knowledge Base

Global Knowledge Base

Navigate to Knowledge Base

Click Knowledge Base in the sidebar navigation. The Knowledge Base section appears outside of any auction context and shows global videos.

Browse the Video Library

The main page displays your progress summary, continue watching section, and a filterable grid of all published global videos.

Manage Content (Super Admins)

If you are a super admin, click the Manage button in the header to access the management interface for categories, videos, and Shorts.

Auction-Scoped Knowledge Base

Navigate to an Auction

Select an auction from the sidebar to enter its context.

Open Knowledge Base Tab

Click the Knowledge Base tab within the auction navigation. This displays videos specific to the auction alongside global videos.

Manage Auction Videos (Owner/Admin)

If you are the auction owner or an admin, you can add, edit, and delete videos scoped to this auction. These videos are only visible to members of this auction.

Video Browser

The video browser is the main Knowledge Base page at /knowledge-base. It displays all published videos with filtering, search, and progress tracking.

Progress Summary

At the top of the page, a progress card shows your overall completion status:

Completed count — Number of videos you have finished watching
Total count — Total number of published videos
Percentage — Your completion percentage displayed as text and a progress bar

A video is automatically marked as completed when you have watched at least 90% of its duration. You do not need to watch the final seconds.

Continue Watching

Below the progress summary, a “Continue Watching” section displays up to 5 videos you have started but not yet completed, ordered by most recently watched. Each card shows:

Video thumbnail with progress bar overlay
Video title
Time watched vs. total duration with percentage

This section is hidden when you have no in-progress videos.

Search and Filter

The video browser provides three ways to find content:

Type in the search bar to filter videos by title. Search uses a 300ms debounce to avoid excessive filtering. A screen reader live region announces the result count as you type. Click the X button or clear the field to reset.

Category Filter

Click category filter chips to show only videos in that category. An All chip shows the full library. Each chip displays the video count for that category. Use arrow keys for keyboard navigation between filters.

Tag Filter

Click the tag icon button to open a popover with multi-select checkboxes. Select one or more tags to show only videos and Shorts that have at least one of the selected tags (OR logic). A badge on the tag icon indicates how many tags are active. Click Clear all to reset tag filters.

Video Grid

Videos display in a responsive grid (2 columns on small screens, 3 on large). Each video card shows:

Element	Description
Thumbnail	YouTube thumbnail image or placeholder icon
Completion badge	Green checkmark overlay when video is completed
Duration	Badge showing video length in MM:SS format
Progress bar	Bottom bar showing watched percentage (hidden when completed)
Category	Badge showing the video’s category name
Tags	Colored tag badges showing assigned tags
Title	Video title (up to 2 lines)
Description	Video description excerpt (up to 2 lines)

Click any video card to navigate to the video detail page.

Video Detail Page

The video detail page at /knowledge-base/[videoId] provides a full viewing experience for a single video.

Video Player

The player uses the YouTube IFrame API to embed videos directly in the page:

16:9 aspect ratio container for consistent display
Resume playback — Automatically resumes from where you left off
Progress tracking — Saves your watch position every 10 seconds during playback
Auto-completion — Marks the video as completed when you reach 90% of the duration
Page unload save — Saves progress when you navigate away or close the tab

Progress is saved automatically. You do not need to manually save or mark videos as watched. If you close the browser or navigate away, your position is preserved.

Video Metadata

Below the player, the detail page displays:

Title — Full video title
Completion status — Green “Completed” indicator when finished
Duration — Total video length
Category — Category badge linking to the category
Description — Full video description in a bordered section

Super admins see an Edit button that links to the management interface.

Management Interface

The management interface at /knowledge-base/manage is restricted to super admins. It provides three tabs for organizing content.

Only super admin users can access the management interface. Non-super-admin users are redirected to the auctions page.

Categories Tab

The Categories tab displays all categories in a sortable list with drag-and-drop reordering.

Viewing Categories

Each category row shows:

Element	Description
Drag handle	Grip icon for drag-and-drop reordering
Name	Category name with folder icon
Description	Category description (truncated)
Video count	Badge showing number of videos in the category
Actions	Edit and Delete buttons

Adding a Category

Click Add Category

Click the Add Category button at the top of the Categories tab.

Enter Category Details

Fill in the category name (required, max 100 characters) and an optional description (max 500 characters).

Save

Click Create to add the category. The category appears immediately via optimistic update.

Editing a Category

Click Edit

Click the Edit button (pencil icon) on the category row.

Modify Details

Update the name or description in the edit modal.

Save Changes

Click Save to apply changes.

Deleting a Category

Click Delete

Click the Delete button (trash icon) on the category row.

Confirm Deletion

Review the confirmation dialog. Videos in this category will become uncategorized — they are not deleted.

Confirm

Click Delete to remove the category.

Deleting a category does not delete its videos. Videos are moved to an uncategorized state and remain accessible in the library.

Reordering Categories

Drag categories using the grip handle to reorder them. The new display order is saved automatically when you drop the item. Keyboard users can reorder using Tab to focus the handle, Space to pick up, arrow keys to move, and Space to drop.

Tags Tab

The Tags tab lets you create colored tags to classify and filter videos. Tags are separate from categories and provide an additional dimension of organization.

Tag Scoping

Tags follow the same scoping rules as videos:

Global tags — Created by super admins in the global Knowledge Base management interface. Can be assigned to any video.
Auction-scoped tags — Created by auction owners/admins. Only visible to auction members and assignable to videos in the same auction.

Viewing Tags

Each tag row shows:

Element	Description
Drag handle	Grip icon for drag-and-drop reordering
Tag badge	Colored pill showing the tag name and color
Video count	Number of videos using this tag
Actions	Edit and Delete buttons

Adding a Tag

Click Create Tag

Click the Create Tag button at the top of the Tags tab.

Enter Tag Name

Fill in the tag name (required, max 50 characters). Example: “Safety”, “Training”, “Compliance”.

Select a Color

Choose a color from the predefined palette (10 colors). A live preview of the tag badge updates as you type and select.

Create

Click Create Tag to add the tag. It appears immediately in the tag list.

Editing a Tag

Click Edit

Click the Edit button (pencil icon) on the tag row.

Modify Name or Color

Update the tag name or select a different color. The tag scope cannot be changed after creation.

Save Changes

Click Save Changes to apply updates.

Deleting a Tag

Click Delete

Click the Delete button (trash icon) on the tag row.

Review Warning

The confirmation dialog shows how many videos currently use this tag. Deleting the tag removes the assignment but does not delete any videos.

Confirm

Click Delete Tag to remove the tag and all its video assignments.

Deleting a tag does not delete its videos. Videos simply lose the tag assignment and remain in the library.

Reordering Tags

Drag tags using the grip handle to reorder them. The new display order is saved automatically. Tags appear in this order in the mobile tag filter sheet and on video cards.

Assigning Tags to Videos and Shorts

Tags are assigned to videos and Shorts through their respective edit modals:

Edit a Video or Short

Click Edit on any video in the Videos tab or any Short in the Shorts tab.

Open the Tags Picker

In the edit modal, find the Tags section with a multi-select dropdown.

Toggle Tags

Click tags to assign or remove them. Changes save immediately — no need to submit the form.

Both videos and Shorts can have multiple tags. Tags appear as colored badges on video cards and Short cards in both the admin browser and the mobile app. Tag filtering in the viewer applies to both videos and Shorts.

Videos Tab

The Videos tab displays all videos grouped by category, with drag-and-drop reordering within groups. A search and filter toolbar helps you quickly find specific videos to manage.

Search and Filter

The Videos tab provides three ways to find content within the management interface:

Type in the search bar at the top of the Videos tab to filter videos by title or description. Search uses a 300ms debounce to avoid excessive filtering. A screen reader live region announces the result count as you type. Click the X button or clear the field to reset.

Category Filter

Click category filter chips below the search bar to show only videos in that category. An All chip shows the full library. Each chip displays the video count for that category. Click a selected category chip again to deselect it. An Uncategorized chip appears when uncategorized videos exist.

Tag Filter

Click the tag icon button next to the search bar to open a popover with multi-select checkboxes. Select one or more tags to show only videos that have at least one of the selected tags (OR logic). A badge on the tag icon indicates how many tags are active. Click Clear all to reset tag filters. A Manage tags link provides quick access to the Tags tab.

When any filters are active, a summary bar shows “Showing X of Y videos” with a Clear filters button to reset all active filters at once.

Viewing Videos

Videos are organized under collapsible category headers. Each video row shows:

Element	Description
Drag handle	Grip icon for reordering within the category
Thumbnail	Small preview image (120×68px) or placeholder
Duration	Overlay badge on the thumbnail
Title	Video title
Description	Video description (truncated)
Published status	Badge showing “Published” or “Draft” with toggle switch
Actions	Edit and Delete buttons

Adding a Video

Click Add Video

Click the Add Video button at the top of the Videos tab.

Enter YouTube URL

Paste the YouTube video URL. The system validates the URL and automatically extracts the video ID.

Review Auto-Fetched Metadata

The title field is automatically populated from YouTube metadata after a 500ms debounce. You can edit it if needed.

Complete Optional Fields

Add a description (max 1000 characters), select a category from the dropdown, and set the published state (defaults to published).

Save

Click Create to add the video. It appears immediately via optimistic update.

You can paste any standard YouTube URL format — full URLs (youtube.com/watch?v=...), short URLs (youtu.be/...), and embed URLs are all supported.

Editing a Video

Click Edit

Click the Edit button (pencil icon) on the video row.

Modify Details

Update the title, description, category, or published status. The YouTube URL cannot be changed after creation.

Save Changes

Click Save to apply changes.

The YouTube URL is read-only after a video is created. To use a different video, delete the existing entry and create a new one.

Deleting a Video

Click Delete

Click the Delete button (trash icon) on the video row.

Review Warning

The confirmation dialog warns that all user progress data for this video will be permanently deleted.

Confirm

Click Delete to remove the video and all associated progress records.

Deleting a video permanently removes all user progress data for that video. This action cannot be undone. Users will lose their watch history and completion status.

Publishing and Unpublishing

Toggle the switch on any video row to change its published state:

Published — Video is visible to all users in the video browser
Draft — Video is hidden from regular users but visible to super admins in the management interface

Reordering Videos

Drag videos within a category group to reorder them. The new display order is saved when you drop the item. Videos can only be reordered within their current category.

Shorts Tab

The Shorts tab manages YouTube Shorts — short-form vertical videos designed for quick, bite-sized training content. Shorts are displayed in a dedicated swipe feed on the mobile app.

Viewing Shorts

Shorts are organized under collapsible category headers, similar to videos. Each Short row shows the same elements as regular videos (thumbnail, title, description, published status, and action buttons).

Shorts are distinguished from regular videos by their content_type field. The same categories can contain both videos and Shorts, but they are managed separately in the interface.

Adding a Short

Click Add Short

Click the Add Short button at the top of the Shorts tab.

Enter YouTube Shorts URL

Paste the YouTube Shorts URL. The system validates the URL and extracts the video ID. Standard YouTube URL formats are also accepted.

Review Auto-Fetched Metadata

The title field is automatically populated from YouTube metadata after a 500ms debounce. A vertical (9:16) thumbnail preview is displayed. You can edit the title if needed.

Complete Optional Fields

Add a description (max 1000 characters), select a category from the dropdown, and set the published state (defaults to published).

Save

Click Create to add the Short. It appears immediately via optimistic update. The content_type is automatically set to short.

You can paste YouTube Shorts URLs (youtube.com/shorts/...), standard YouTube URLs (youtube.com/watch?v=...), or short URLs (youtu.be/...). The system detects the content type from the URL format.

Editing a Short

Click Edit

Click the Edit button (pencil icon) on the Short row.

Modify Details

Update the title, description, category, tags, or published status. The YouTube URL cannot be changed after creation.

Assign Tags

Use the Tags picker to assign or remove tags. Tag changes save immediately — no need to submit the form.

Save Changes

Click Save to apply changes.

Deleting a Short

Click Delete

Click the Delete button (trash icon) on the Short row.

Review Warning

The confirmation dialog warns that all user viewed data for this Short will be permanently deleted.

Confirm

Click Delete to remove the Short and all associated progress records.

Shorts vs. Videos

Aspect	Videos	Shorts
Format	Horizontal (16:9)	Vertical (9:16)
Playback	Detail page with controls	Full-screen swipe feed
Progress	Seconds watched, 90% auto-complete	Binary viewed/not-viewed
Looping	No	Yes, loops continuously
Controls	Standard YouTube controls	No visible controls
Orientation	Supports landscape fullscreen	Locked to portrait
Tags	Assignable via edit modal	Assignable via edit modal

Auction-Scoped Video Management

Auction owners and admins can manage training videos scoped to their specific auction. These videos appear in the auction’s Knowledge Base tab alongside global videos but are only visible to members of that auction.

How Auction-Scoped Videos Work

Scoped visibility — Auction videos are only visible to members of the auction they belong to
Combined view — When viewing an auction’s Knowledge Base, members see both global videos and auction-specific videos in one unified list
Shared categories — Auction videos use the same global category taxonomy managed by super admins
Independent management — Auction owners/admins manage their videos independently without affecting global content
Same progress tracking — Progress is tracked identically for both global and auction-scoped videos

Managing Auction Videos

Navigate to the Auction

Select the auction from the sidebar navigation.

Open Knowledge Base

Click the Knowledge Base tab within the auction. The page displays all videos accessible to the auction — both global and auction-scoped.

Add a Video

Click Add Video to create a new auction-scoped video. The workflow is the same as adding a global video — paste a YouTube URL, review the auto-fetched title, and optionally set a category and description. The video is automatically scoped to the current auction.

Edit or Delete

Use the edit (pencil) and delete (trash) buttons on any auction-scoped video to modify or remove it. You cannot edit or delete global videos from the auction context.

Auction owners and admins can only manage videos belonging to their auction. Global videos are read-only in the auction context. To manage global videos, a super admin must use the Settings > Knowledge Base management interface.

Global vs. Auction-Scoped Videos

Aspect	Global Videos	Auction-Scoped Videos
Visibility	All authenticated users	Auction members only
Managed by	Super admins	Auction owner/admin
Admin location	Settings > Knowledge Base > Manage	Auction > Knowledge Base
Categories	Global shared categories	Same global categories
Progress tracking	Per user	Per user (identical)
Shorts support	Yes	Yes
Tags	Global tags	Global tags + auction-scoped tags
Deletion cascade	Deleting the video removes progress	Same, plus deleted if auction is deleted

Progress Tracking Details

The Knowledge Base automatically tracks viewing progress for each user. Here is how progress tracking works under the hood.

How Progress Is Saved

Periodic Saves

Every 10 seconds during video playback, the current watch position is saved to the database. This ensures minimal data loss if the user closes the browser unexpectedly.

Pause and State Change Saves

Progress is also saved when the video is paused or playback state changes (playing, paused, ended).

Page Unload Save

When the user navigates away or closes the tab, a final progress save is triggered via the browser’s beforeunload event.

Auto-Completion

When a user’s watched_seconds reaches 90% or more of the video’s duration_seconds, the video is automatically marked as completed with a timestamp.

Progress Data

Each progress record tracks:

Field	Description
watched_seconds	Total seconds the user has watched
completed	Whether the video is marked as completed
completed_at	Timestamp when the video was completed (null if not completed)
last_watched_at	Timestamp of the most recent watch session

Progress is stored per user per video. Each user has independent progress that is not visible to other users or administrators.

Database Schema

The Knowledge Base uses five database tables. Categories are global, videos support both global and auction-scoped content, progress is tracked per user, and tags provide additional classification with many-to-many video associations.

knowledge_base_categories

Stores video categories for organizing content. Categories are global and shared across all scopes.

Column	Type	Description
`id`	UUID	Primary key
`name`	TEXT	Category name (required)
`description`	TEXT	Optional description
`display_order`	INT	Sort order for display (default: 0)
`created_at`	TIMESTAMPTZ	Creation timestamp
`updated_at`	TIMESTAMPTZ	Last update timestamp (auto-managed)

knowledge_base_videos

Stores video and Shorts entries with YouTube metadata. Supports both global and auction-scoped content via the auction_id column.

Column	Type	Description
`id`	UUID	Primary key
`auction_id`	UUID	Foreign key to auctions (nullable, CASCADE on delete). `NULL` = global video, set = auction-scoped
`category_id`	UUID	Foreign key to categories (nullable, SET NULL on delete)
`title`	TEXT	Video title (required)
`description`	TEXT	Optional description
`youtube_url`	TEXT	Full YouTube URL (required)
`youtube_video_id`	TEXT	Extracted YouTube video ID (required)
`thumbnail_url`	TEXT	Custom or YouTube thumbnail URL
`duration_seconds`	INT	Video duration in seconds
`display_order`	INT	Sort order within category (default: 0)
`is_published`	BOOLEAN	Whether visible to users (default: true)
`content_type`	TEXT	Content type: `video` (default) or `short`
`created_at`	TIMESTAMPTZ	Creation timestamp
`updated_at`	TIMESTAMPTZ	Last update timestamp (auto-managed)

The auction_id column determines video scope:

NULL — Global video, visible to all users, managed by super admins
UUID — Auction-scoped video, visible to auction members, managed by auction owner/admin
When an auction is deleted, all its scoped videos are automatically removed via CASCADE

user_video_progress

Tracks per-user viewing progress for each video. Progress works identically for both global and auction-scoped videos.

Column	Type	Description
`id`	UUID	Primary key
`user_id`	UUID	Foreign key to auth.users (CASCADE on delete)
`video_id`	UUID	Foreign key to videos (CASCADE on delete)
`watched_seconds`	INT	Seconds watched (default: 0)
`completed`	BOOLEAN	Whether completed (default: false)
`completed_at`	TIMESTAMPTZ	Completion timestamp (nullable)
`last_watched_at`	TIMESTAMPTZ	Last watch session timestamp

Constraint: UNIQUE(user_id, video_id) — One progress record per user per video.

knowledge_base_tags

Colored tags for classifying knowledge base videos. Supports both global and auction-scoped tags.

Column	Type	Description
`id`	UUID	Primary key
`auction_id`	UUID	Foreign key to auctions (nullable, CASCADE on delete). `NULL` = global tag, set = auction-scoped
`name`	TEXT	Tag display name (required, unique within scope)
`color`	TEXT	Hex color code for visual display (default: `#6B7280`)
`display_order`	INT	Sort order for display (default: 0)
`created_at`	TIMESTAMPTZ	Creation timestamp
`updated_at`	TIMESTAMPTZ	Last update timestamp (auto-managed)

Constraint: Unique tag names within scope — global tags are unique among global tags, and auction tags are unique within their auction.

knowledge_base_video_tags

Junction table linking videos to tags (many-to-many). A database trigger enforces scope consistency — auction-scoped tags can only be assigned to videos in the same auction.

Column	Type	Description
`video_id`	UUID	Foreign key to knowledge_base_videos (CASCADE on delete)
`tag_id`	UUID	Foreign key to knowledge_base_tags (CASCADE on delete)
`created_at`	TIMESTAMPTZ	Assignment timestamp

Constraint: PRIMARY KEY(video_id, tag_id) — One assignment per video-tag pair.

Row-Level Security

Categories RLS

SELECT: All authenticated users can view categories
INSERT/UPDATE/DELETE: Requires is_any_auction_admin_or_above() — user must be a super admin or an admin/owner of any auction

Videos RLS

Global videos (auction_id IS NULL):

SELECT: All authenticated users see published global videos; super admins and auction admins see unpublished global videos
INSERT/UPDATE/DELETE: Requires is_super_admin()

Auction-scoped videos (auction_id IS NOT NULL):

SELECT: Auction members see published videos; auction owner/admin see all videos (published and unpublished) for their auction
INSERT/UPDATE/DELETE: Requires is_auction_admin_or_above(auction_id) — user must be the owner or an admin of the specific auction

Tags RLS

Global tags (auction_id IS NULL):

SELECT: All authenticated users can view global tags
INSERT/UPDATE/DELETE: Requires is_super_admin()

Auction-scoped tags (auction_id IS NOT NULL):

SELECT: Auction members can view their auction’s tags
INSERT/UPDATE/DELETE: Requires is_auction_admin_or_above(auction_id)

Video Tags (junction) RLS

SELECT: Users can view tag assignments for videos they can see
INSERT/DELETE: Super admins manage global video tag assignments; auction owner/admin manage their auction’s video tag assignments

Progress RLS

SELECT/INSERT/UPDATE/DELETE: Users can only access their own progress records (user_id = auth.uid())
Progress policies are unchanged — they apply equally to global and auction-scoped videos

Key Components

The admin Knowledge Base feature is built from the following components:

Viewer Components

Component	Purpose
`KnowledgeBaseViewer`	Main video browser with search, filter, and progress
`VideoDetail`	Single video page with player and metadata
`VideoPlayer`	YouTube IFrame API player with progress tracking
`VideoCard`	Video thumbnail card for the grid
`ProgressSummary`	Overall completion progress bar
`ContinueWatching`	Horizontal list of in-progress videos
`KnowledgeBaseSearch`	Debounced search input with accessibility
`CategoryFilter`	Category chip filter with keyboard navigation

Management Components

Component	Purpose
`KnowledgeBaseManageTabs`	Tab container for Categories, Tags, Videos, and Shorts
`CategoriesManagement`	Category list with CRUD operations
`CategoriesList`	Drag-and-drop sortable category list
`AddCategoryModal`	Form dialog for creating categories
`EditCategoryModal`	Form dialog for editing categories
`DeleteCategoryDialog`	Confirmation dialog for category deletion
`VideosManagement`	Video list with CRUD, grouping, search, tag filter, and category filter
`VideosList`	Drag-and-drop sortable video list by category
`AddVideoModal`	Form dialog for adding videos with YouTube fetch
`EditVideoModal`	Form dialog for editing video metadata
`DeleteVideoDialog`	Confirmation dialog for video deletion
`ShortsManagement`	Shorts list with CRUD and category grouping
`AddShortModal`	Form dialog for adding Shorts with vertical thumbnail preview
`EditShortModal`	Form dialog for editing Short metadata and assigning tags
`TagsManagement`	Tag list with CRUD operations and drag-and-drop reordering
`TagsList`	Drag-and-drop sortable tag list
`CreateTagDialog`	Form dialog for creating tags with color picker and live preview
`EditTagDialog`	Form dialog for editing tag name and color
`DeleteTagDialog`	Confirmation dialog for tag deletion with usage count
`VideoTagPicker`	Multi-select dropdown for assigning tags to videos and Shorts, with search for large tag sets

Troubleshooting

Video not playing

Ensure the YouTube URL is valid and the video is publicly accessible. Private or unlisted YouTube videos will not load in the embedded player. Check that your browser allows embedded content from YouTube.

Progress not saving

Progress saves every 10 seconds during playback. If the video is paused immediately after starting, a save may not have occurred. Resume playback for at least 10 seconds to trigger a save. Check your network connection if saves fail.

Video not appearing in browser

Only published videos appear in the video browser. Check the management interface to verify the video’s published status. Draft videos are only visible to super admins in the management view.

Cannot access management interface

The management interface at /knowledge-base/manage requires super admin access. If you are redirected, contact a super admin to verify your permissions.

Category deletion impact

Deleting a category moves its videos to uncategorized — videos are not deleted. If videos appear to be missing after a category deletion, check the uncategorized section in the management interface.

Auto-fetched title is wrong

The title auto-fetched from YouTube may not match your preferred title. Edit the title field manually before saving. The auto-fetch uses a 500ms debounce, so wait briefly after pasting the URL.

Drag-and-drop not working

Drag-and-drop reordering uses the grip handle on the left side of each row. Click and hold the grip icon (six dots) to initiate dragging. Keyboard users can use Tab to focus, Space to pick up, arrow keys to move, and Space to drop.

Video completion not triggering

Videos are marked complete at 90% watched. If the video’s duration_seconds is not set (null), auto-completion cannot be calculated. Re-add the video or update the duration in the database if needed.

Auction video not visible to members

Auction-scoped videos are only visible to members of the auction they belong to. Verify the user is an active member of the auction. Also check that the video is published — draft auction videos are only visible to the auction owner/admin.

Cannot manage auction videos

Only the auction owner or an auction admin can add, edit, or delete auction-scoped videos. Regular auction members can only view published content. Contact the auction owner to be promoted to admin, or ask a super admin for assistance.

Best Practices

Content Organization

Create clear category names that reflect training topics
Keep category descriptions concise and informative
Order categories by importance or learning sequence using drag-and-drop
Limit categories to a manageable number (5–15 recommended)

Video Management

Use descriptive titles that clearly indicate the video content
Add descriptions to provide context about what users will learn
Set videos as draft while preparing content, then publish when ready
Order videos within categories to create a logical learning path

Publishing Workflow

Add videos as drafts first to review metadata before publishing
Verify the YouTube video is publicly accessible before publishing
Use the published/draft toggle to temporarily hide videos without deleting them
Review the video browser as a regular user to verify the experience

Progress Monitoring

Each user’s progress is private and independent
The 90% completion threshold accounts for users who skip intros or outros
Progress persists across sessions — users can resume where they left off
Deleting a video permanently removes all user progress for that video

Auction-Scoped Content

Use global videos for training that applies to all auctions (company-wide policies, general procedures)
Use auction-scoped videos for content specific to a particular auction (site-specific procedures, local training)
Auction-scoped videos are automatically deleted when an auction is removed
Members see auction videos alongside global ones — avoid duplicate content across scopes

Getting Started

User & Location Management

Operations

Analytics Module

Account

Data Management

Configuration

​Overview

Video Browser

YouTube Shorts

Progress Tracking

Auction-Scoped Videos

​Access Levels

​Accessing the Knowledge Base

​Global Knowledge Base

​Auction-Scoped Knowledge Base

​Video Browser

​Progress Summary

​Continue Watching

​Search and Filter

​Video Grid

​Video Detail Page

​Video Player

​Video Metadata

​Management Interface

​Categories Tab

​Viewing Categories

​Adding a Category

​Editing a Category

​Deleting a Category

​Reordering Categories

​Tags Tab

​Tag Scoping

​Viewing Tags

​Adding a Tag

​Editing a Tag

​Deleting a Tag

​Reordering Tags

​Assigning Tags to Videos and Shorts

​Videos Tab

​Search and Filter

​Viewing Videos

​Adding a Video

​Editing a Video

​Deleting a Video

​Publishing and Unpublishing

​Reordering Videos

​Shorts Tab

​Viewing Shorts

​Adding a Short

​Editing a Short

​Deleting a Short

​Shorts vs. Videos

​Auction-Scoped Video Management

​How Auction-Scoped Videos Work

​Managing Auction Videos

​Global vs. Auction-Scoped Videos

​Progress Tracking Details

​How Progress Is Saved

​Progress Data

​Database Schema

​knowledge_base_categories

​knowledge_base_videos

​user_video_progress

​knowledge_base_tags

​knowledge_base_video_tags

​Row-Level Security

​Key Components

​Viewer Components

​Management Components

​Troubleshooting

​Best Practices

Overview

Access Levels

Accessing the Knowledge Base

Global Knowledge Base

Auction-Scoped Knowledge Base

Video Browser

Progress Summary

Continue Watching

Search and Filter

Video Grid

Video Detail Page

Video Player

Video Metadata

Management Interface

Categories Tab

Viewing Categories

Adding a Category

Editing a Category

Deleting a Category

Reordering Categories

Tags Tab

Tag Scoping

Viewing Tags

Adding a Tag

Editing a Tag

Deleting a Tag

Reordering Tags

Assigning Tags to Videos and Shorts

Videos Tab

Search and Filter

Viewing Videos

Adding a Video

Editing a Video

Deleting a Video

Publishing and Unpublishing

Reordering Videos

Shorts Tab

Viewing Shorts

Adding a Short

Editing a Short

Deleting a Short

Shorts vs. Videos

Auction-Scoped Video Management

How Auction-Scoped Videos Work

Managing Auction Videos

Global vs. Auction-Scoped Videos

Progress Tracking Details

How Progress Is Saved

Progress Data

Database Schema

knowledge_base_categories

knowledge_base_videos

user_video_progress

knowledge_base_tags

knowledge_base_video_tags

Row-Level Security

Key Components

Viewer Components

Management Components

Troubleshooting

Best Practices