feat(refboard): server-generated video posters via ffmpeg

Upload pipeline now extracts poster frame (JPEG) and metadata
(width, height, duration) from videos at upload time using ffmpeg.

Server:
- Add ffmpeg to Docker image (Alpine)
- video-utils.js: probeVideo() and extractPoster() using ffprobe/ffmpeg
- Upload response includes poster_asset_key and duration

Frontend:
- VideoObject gains poster and duration fields in scene format
- VideoSprite accepts posterAssetKey + TextureManager, loads poster
  as a regular image texture on construction (no <video> needed)
- Server poster loaded/released via TextureManager ref counting
- addVideoFromUpload passes poster and duration through to scene data
- image-drop.ts forwards poster_asset_key from upload response

Result: videos with server posters render as images by default.
Zero <video> elements needed for thumbnails. Only explicit play
creates a media element.

This commit is contained in:

Hiren Kangad

2026-03-10 12:10:18 +05:30

parent 9ecb287976

commit 198497381f

7 changed files with 256 additions and 45 deletions

									
										Dockerfile
									
		+2
		-1
	
												View File
												
				@@ -27,8 +27,9 @@ COPY --from=frontend-build /build/frontend/dist ./frontend/dist

				# Data directory for SQLite

				RUN mkdir -p /app/data

				# ffmpeg for video poster/metadata extraction at upload time

				# Health check utility

				RUN apk add --no-cache wget

				RUN apk add --no-cache wget ffmpeg

				EXPOSE 8000