Repository navigation
Releases
Releases · ardianryan/OpenVolley
OpenVolley v0.3.1
Added
- Visual Trimmer Sequence & Filmstrip Scrubber (
VideoTrimmerControl.tsx,media-timeline.ts):- Replaced numerical duration-based trimming with a WhatsApp / video-editor style interactive scrubber bar.
- Interactive drag handles with millisecond precision, real-time seek preview, clamped trim window (2s–15s), and duration / aspect-ratio badges.
- Gesture Direct Crop & Pinch-to-Zoom (
MediaCropBox.tsx,media-framing.ts):- Implemented intuitive gesture-based media framing: 1-finger / mouse drag, 2-finger pinch-to-zoom, non-passive mouse wheel / trackpad zoom, and double-click reset for photo covers and collage slots.
- Rule-of-thirds 3x3 alignment grid and compact zoom pill bar (
-, zoom %,+, reset, done) replacing unintuitive range sliders.
- Expanded Audio Library for Pre-Match Upcoming Scenes (
audio-library.ts):- Added 5 new high-energy BGM tracks (
Warmup Rhythm & Spikes,Rivalry Countdown,Morning Court Kickoff,Arena Pulse & Hype,Locker Room Focus) hosted on S3 CDN storage, enriching the upcoming template pool to 9 tracks.
- Added 5 new high-energy BGM tracks (
- Mobile Bottom Navigation & OBS Broadcast Enhancements:
- Compact thumb-accessible mobile bottom navigation bar with active route indicators and grouped shortcuts.
- OBS Broadcast transitions, stinger bumpers, brand strip, and dedicated dock/Lua plugin integration.
Fixed
- Match Reset & Bracket Advancement Retraction (
bracket.ts,scoring.ts,LiveOperator.tsx):- Fixed an issue where resetting a completed match left the winning team in downstream bracket matches (e.g., SMPN 6 remaining in Quarter Final after R16 match reset).
- Implemented
retractAdvancement(matchId)which cleanly clears qualified team slots in downstream matches (nextMatchIdandloserNextMatchId) and cascades recursively. - Integrated retraction into
resetMatchScore,undoLastAction,finishMatchManually, andaddExtraSet. - Added explicit "Reset Permainan" controls in Live Operator with informative confirmation dialog and real-time SSE broadcasts.
- Media Studio Video Export Frame Flicker (
MediaStudio.tsx):- Resolved canvas flickering during 60fps MP4/WebM video export by maintaining persistent offscreen video buffer rendering.
Container Image (GitHub Packages / GHCR)
docker pull ghcr.io/ardianryan/openvolley:0.3.1OpenVolley v0.3.0
Added
- Token-Gated OBS Browser Source Overlay & Back-Office Controller (
/obs?token=<secret>):- Dedicated transparent browser source overlay (
ObsOverlayDisplay.tsx) with 100% transparent alpha canvas and 5 broadcast layout presets: Scorebug Corner, Lower-Third Bar, Match Intro VS, Timeout / Set Break, and Winner Card. - Token-gated stream endpoints (
/api/public/obs-stream,/api/public/obs-state) with constant-time token validation and 1-click token regeneration from the Back-Office. - Remote OBS Controller panel at
/back-office/obswith real-time match selection, layout switching, theme selection (Dark, Broadcast Glass, High-Contrast), and visibility toggles.
- Dedicated transparent browser source overlay (
- FIVB Form O-2 Official Scoresheet Generator (
OfficialDocuments.tsx,pdfDocuments.ts):- Automated generation of official FIVB Form O-2 vector PDF scoresheets containing team rosters, starting lineups, set duration timestamps (
startedAt,endedAt), per-set timeouts, substitutions, and referee sign-off blocks. - Dedicated
O-2action button on the Official Documents match list.
- Automated generation of official FIVB Form O-2 vector PDF scoresheets containing team rosters, starting lineups, set duration timestamps (
- Full Bilingual UI Localization (
i18n.ts):- Typed Indonesian (
id) and English (en) localization dictionary with persistent local storage preferences (openvolley_locale). - Seamless language toggle button (
ID / EN) directly in the header of the Public Portal.
- Typed Indonesian (
- Outgoing Webhooks & Hot S3 Database Backup (
/back-office/integrasi):- HMAC-SHA256 signed outgoing webhook dispatcher (
webhook.ts) with anti-SSRF IP filtering (blocking loopback, private ranges, metadata IPs) and automated delivery onmatch_started,set_finished, andmatch_finishedevents. - Hot SQLite database backup (
VACUUM INTO) to S3-compatible object storage with 1-click manual trigger and direct backup downloads.
- HMAC-SHA256 signed outgoing webhook dispatcher (
- Master Court Schedule Editing & Clearing (
ScheduleCourtsManager.tsx):- Interactive modal dialog to edit match date/time (
scheduledAt), court assignment (courtName), and stage labels with 1-click quick time slot buttons (07.30 - 08.45,08.45 - 10.00, etc.). - Per-match schedule clearing / unassigning with confirmation dialog.
- Whole-court bulk schedule clearing (
POST /api/admin/matches/bulk-schedule-clear) to reset all time slots on a specific court. - Collapsible drawer for unscheduled matches with 1-click scheduling action.
- Interactive modal dialog to edit match date/time (
- Skippable 3rd Place Match & Joint 3rd Place ("Juara 3 Bersama"):
- Unified
resolveTournamentPodiumengine insrc/shared/podium.ts. WhenhasThirdPlace: false, both semifinal losers are officially recognized as Joint 3rd Place winners (Juara 3 Bersama), and 4th place is cleanly omitted. - Interactive Bracket View displays a dedicated "JUARA 3 BERSAMA" card and updated podium recap.
- Media Studio Champions & Podium template automatically displays both semifinal losers on the 3rd place podium.
- Tournament Bulletin PDF automatically draws a "JUARA 3 BERSAMA" box with both school names.
- Category rules editor allows toggling 3rd place playoff on/off dynamically before or after bracket generation.
- Unified
- Cloud S3 Logo Storage & Auto-Migration (
src/server/db/index.ts):- Synced all 16 school emblems and master contingent logos to S3 bucket CDN (
https://is3-storage.smage.my.id/svc-media/logos/). - Runtime database boot migration automatically rewrites legacy local disk paths (
/uploads/logos/...) to public S3 URLs when S3 is enabled.
- Synced all 16 school emblems and master contingent logos to S3 bucket CDN (
- Cloudflare Turnstile Bot Gate (
src/client/components/TurnstileGate.tsx):- Integrated Cloudflare Turnstile bot verification on public portal entry and back-office authentication forms with theme matching.
Container Image (GitHub Packages / GHCR)
docker pull ghcr.io/ardianryan/openvolley:0.3.0OpenVolley v0.2.2
Release v0.2.2 of OpenVolley.
Container Image (GitHub Packages / GHCR)
docker pull ghcr.io/ardianryan/openvolley:0.2.2OpenVolley v0.2.1
Added
- Master Contingents Registry (
/back-office/kontingen) & Non-Destructive Auto-Migration:- Centralized
master_teamstable (name,shortCode,school,level,logoUrl,color,defaultCoachName,defaultManagerName,defaultJerseyColors) shared acrossSMP/MTs,SMA/SMK/MA,Kab/Kota, andKlub/Umumdivisions. - Direct Tab-separated (
No \t Nama Sekolah \t Kab/Kota) & Pipe-separated bulk import from Google Sheets/Excel (POST /api/admin/master-teams/bulk) with header/duplicate skipping and automatic level inference. - Automatic identity & logo synchronization across linked category entries (
teams.master_team_id) while preserving per-category coach, manager, and jersey overrides. - Safe shared-logo reference counting (
safeDeleteTeamLogoIfUnreferenced) so deleting one division preserves shared Master Contingent emblems.
- Centralized
- Hybrid FIVB Technical Meeting (TM) Drawing & Live Bagan / TM Mode:
- Searchable draw-slot combobox (
SearchableTeamPicker) directly on4 / 8 / 16 / 32TM bracket slots (PUT /api/admin/tournaments/:id/draw-slot) with duplicate guards, secondary squad support (+ Tim B), and inline+ Simpan Baru ke Master. - FIVB Smart Auto-Draw engine (
src/shared/fivb-draw.ts) supporting seeded opposite-wing locking (isSeeded), Serpentine Snake Pool seeding, and Round-1/Pool anti-same-region separation (separateSameRegion). - Live
draw_slot_updatedSSE broadcasts driving gold reveal spotlight banners & slot highlights on/tvand/baganwithout page refresh.
- Searchable draw-slot combobox (
- Master Courts & Visual Cross-Court Schedule Board (
/back-office/jadwal):- Centralized
master_courtsregistry with cascading court renames (PATCH /api/admin/master-courts/:id) synced to schedules andLiveOperator. - Side-by-side cross-court schedule board (
ScheduleCourtsManager) featuring 1-click "Tarik Jadwal" transfers between courts, chronological day sorting, and "Salin Pola Jam" time-slot copying (POST /api/admin/matches/bulk-schedule-assign).
- Centralized
- Multi-Screen Remote TV Controller & Dynamic Standby Banners (
/back-office/layar-tv):- Dedicated
tv_screensprofile table (/tv?screen=<slug>) centrally controlled by admins/officials over real-timetv_screen_updatedSSE (1 Lapangan,Split 2,Auto 12d,Bagan / TM, andStandby Banner). - Clean display-only
/tvheader (no manual TV-side mode switchers or internal profile pill clutter). - Fullscreen Dynamic Standby Banner renderer supporting quick presets (Technical Meeting, Warm-Up Arena, Istirahat / Jeda, Next Match, Kustom Bebas), live WIB digital clock, optional custom backdrop upload, sponsor footer, and continuous CSS running-text marquee (
animate-tv-marquee).
- Dedicated
- Public Portal TV Visibility Gate (
publicTvEnabled):- Hides the
Layar Skor TVCTA button on the public homepage (VolleyballArena3D) by default (publicTvEnabled: false) while preserving TV PIN protection; admins can toggle public visibility in Branding & Logo.
- Hides the
- Chronological Per-Day PDF Schedule Grouping & Accordion Back-Office Sidebar:
- Day-by-day chronological schedule sections (
src/shared/schedule.ts→HARI 1..N) with column headers and compact bracket schedule strips in Bulletin PDFs. - Smooth CSS-Grid collapsible accordion sidebar groups in
BackOffice(default collapsed, expanding automatically for the active menu category).
- Day-by-day chronological schedule sections (
- Comprehensive Granular RBAC & Custom Roles (
/back-office/users):- Dedicated
rolesdatabase table with immutable/protected system roles (admin,panitia,media) and full CRUD for custom roles (GET/POST/PUT/DELETE /api/auth/roles) with checkbox-driven permission selection across all 12 Back-Office menus (src/shared/rbac.ts). - Per-user granular menu permission overrides (
users.permissions_json,nullinherits role defaults) editable directly when creating or updating staff accounts (UserRolesManager.tsx). - Dynamic default landing route (
getDefaultLandingSection) so staff withoutoverviewautomatically land on their first allowed Back-Office module.
- Dedicated
Changed
- 3-Step Live Operator UX Wizard (
src/client/pages/LiveOperator.tsx):- Rebuilt the live scoring console into a focused 3-step workflow: 1. Pilih Lapangan -> 2. Pilih Jadwal Aktif -> 3. Konsol Skor Live.
- Removed redundant
PIN TV/Setinputs andLayar TV ↗links now handled centrally by/back-office/layar-tv, and addedEscape-key handling on confirmation modals.
- Media Studio Visual Polish (
src/client/pages/MediaStudio.tsx):- Upgraded lighting to ReactBits-inspired volumetric top-center
LightRays, dual symmetric diagonal shutter transitions with full clearance,warmUpGpuTextures()+img.decode()pre-warming prior to recording,drawContainedCanvasImage()aspect-ratio preservation, and proportionally larger (~2×) school crests on score cards & VS doors.
- Upgraded lighting to ReactBits-inspired volumetric top-center
- PDF & OG Partner Badge Aspect Preservation (
src/client/lib/pdfDocuments.ts,src/server/services/ogImage.ts):- Added
loadRasterAsset()alpha bounding-box auto-trimming +addContainedImage()and adaptive dark-slate contrast badges so wide horizontal gold wordmarks (e.g.AVERSA) retain natural aspect ratios without clipping.
- Added
- Anti-Slop UI & Accessibility Refinements:
- Replaced native
window.confirmpopups acrossMasterTeamsManager.tsx,ScheduleCourtsManager.tsx, andTvScreensManager.tsxwith a themed accessibleConfirmDialogcomponent (Escapeclose,>=44pxmobile buttons). - Enlarged mobile action icon tap targets (
min-h-11 min-w-11 sm:min-h-8 sm:min-w-8), replaced genericSparklesplaceholders withLayoutTemplate, and cleaned em-dash punctuation from TV UI copy.
- Replaced native
Fixed
- RBAC & Security Hardening (
src/server/middleware/auth.ts,src/server/routes/admin.ts,src/server/routes/media.ts,src/server/app.ts,src/server/services/upload.ts):- Enforced real-time database session & role permission verification (
resolveLiveAuthUser,requirePermission) on every protected request so deleted or demoted accounts are rejected immediately (401/403) rather than trusting stale JWT claims. - Applied granular
requirePermission(...)guards across/api/admin/*and/api/media/*endpoints and redactedtvPinfrom/api/admin/overviewunless the caller holdsbrandingortv_screenspermissions. - Sanitized
resolveRequestOrigin()against forgedX-Forwarded-Host/Hostheader injection (with optionalPUBLIC_ORIGINoverride) and tighteneddeleteUploadedImage()local path validation via strict allowlist regex.
- Enforced real-time database session & role permission verification (
- Zero-Delay VIP TV SSE & Instant Final-Set Match Ending (
src/server/routes/public.ts,src/server/services/sse.ts,src/server/services/scoring.ts):- Applied
no-cache, no-store, no-transform, must-revalidateandX-Accel-Buffering: noheaders directly onto HonostreamSSE()Responseobjects to defeat reverse-proxy buffering. - Replaced sequential SSE loops with concurrent non-blocking
Promise.allSettledfan-out +2500mswrite timeout & stalled-socket eviction so slow mobile viewers never block VIP TVs or scoring updates. - Updated
finishMatchManuallyto close and count active non-zero sets so/tvtransitions immediately (0ms) to the final set & winner summary without refresh.
- Applied
Container Image (GitHub Packages / GHCR)
docker pull ghcr.io/ardianryan/openvolley:0.2.1OpenVolley v0.2.0
Added
- Dynamic Favicon, Server-Injected SEO & Auto-Generated Social Image (
1200×630PNG):- Default favicon upgraded to
/brand/svc-crest-color.svgand dynamically synced tositeSettings.logoUrlon both server HTML responses and live client updates. - Server-side HTML meta injector (
injectDynamicHtmlMeta) populating<title>,<meta name="description">, OpenGraph (og:*), and Twitter Card (twitter:*) tags fromsiteSettings. - Auto-generated
1200×630PNG social share card atGET /api/public/og-image.pngpowered by@resvg/resvg-wasmand bundled fonts (public/fonts/), with an optional custom Social Banner upload override in Branding & Logo.
- Default favicon upgraded to
- Official Vector PDF Suite (Tournament Bulletin + Match Summary) & "Dokumen Resmi" Hub:
- Lazy-loaded client vector PDF engine (
src/client/lib/pdfDocuments.tsviajspdfcode-split chunk) adding0 KBto initial portal load:- Official Tournament Bulletin PDF (
downloadTournamentBulletinPdf): Vector championship cover (or custom uploaded cover), 2-column Contingent/Pool cards with dynamic optionalCoach,Manager, andJersey Colors(auto-hidden when empty), FIVB Pool Standings + Schedule/Results table, and crisp full-page vector Main Knockout Bracket trees per category (including3rd Place Matchbox and center watermark). - Official Match Summary PDF (
downloadMatchSummaryPdf): 1-page A4 referee sheet with official letterhead, match metadata, set-by-set points, timeouts & substitutions per set, rally point ratio, and 4-column signature blocks.
- Official Tournament Bulletin PDF (
- Dedicated Dokumen Resmi Back-Office module (
/back-office/dokumen) + contextual PDF export buttons in Kategori & Bagan, Live Operator, and Public Spectator Portal / Match Center Modal (governed by an AdminON/OFFpublic download toggle).
- Lazy-loaded client vector PDF engine (
- Championship & Stage-Aware Broadcast Templates in Media Studio:
- Added
CHAMPIONS & PODIUMtemplate supporting 4 ceremony variants (1st Place Champion,2nd Place Runner-Up,3rd Place Winner, andOfficial Podium 1-2-3) paired with ceremony soundtracks and vector crown/medal graphics. - Added automatic & manual Stage Visual Themes (
Pool Stage,Round of 16,Quarter-Final,Semi-Final,3rd Place Match,Grand Final) acrossLive,Final Score,Upcoming, andHighlighttemplates.
- Added
- Per-Set Timeouts (
2/2) & Substitutions (6/6) Counters:- Added courtside
+/-controls in Live Operator (integrated intoundoLastActionand auto-resetting on each new set), live indicator badges on Arena TV (/tv), and persistent storage inmatch_sets.
- Added courtside
- Multi-Court Arena TV (
/tv) Modes:- Added auto-hiding top-bar switcher supporting Single Court Focus, Dual Split-Screen (
Split 2), and Auto-Rotate (12s).
- Added auto-hiding top-bar switcher supporting Single Court Focus, Dual Split-Screen (
- Optional Pool / Round-Robin Group Stage → Knockout Progression:
- Added
pool_knockoutcategory format, round-robin fixture generator (Pool A..H), FIVB standings calculator (Wins→Match Points 3-2-1-0→Set Ratio→Point Ratio),PoolStandingsView, and 1-click Advance Pool Winners/Runners-Up to Main Bracket.
- Added
Changed
- International Volleyball Broadcast Terminology (
src/shared/stages.ts):- Standardized round, bracket, and scoreboard terminology across Portal, Bracket, Arena TV, Media Studio, and PDFs (
Pool Stage,Left Bracket/Right Bracket,Round of 16,Quarter-Final,Semi-Final,3rd Place Match,Grand Final,Champion,Runner-Up,Final Score,Set Score) eliminating ambiguity between group-stage Pools and knockout bracket wings.
- Standardized round, bracket, and scoreboard terminology across Portal, Bracket, Arena TV, Media Studio, and PDFs (
Fixed
- Origin-Clean Canvas Video/PNG Export with S3 Object Storage (
GET /api/public/asset-proxy):- Added an SSRF-guarded same-origin CORS proxy (
/api/public/asset-proxy?url=...), updated/uploads/*CSP headers, and added a1×1getImageDataorigin-clean verification gate inMediaStudiosoHTMLCanvasElement.captureStream(),toBlob(), andtoDataURL()never throwSecurityError: Canvas is not origin-cleanwhen team/sponsor/brand logos are hosted on S3 buckets without CORS headers.
- Added an SSRF-guarded same-origin CORS proxy (
Container Image (GitHub Packages / GHCR)
docker pull ghcr.io/ardianryan/openvolley:0.2.0OpenVolley v0.1.1
Added
- Dashboard Password Management & Self-Service Security:
- Added
POST /api/auth/change-password(rate-limited, verifies current Argon2id password) andChangePasswordModalaccessible to all authenticated roles (admin,panitia,media) from the Back-Office top bar and sidebar. - Added
PUT /api/auth/users/:idand inline Ubah Password / Edit controls in Manajemen Akun (/back-office/akun) allowing administrators to reset any staff password, update display names/roles, and prevent accidental self-demotion. - Exposed Arena TV security PIN (
tvPin) configuration directly inside Branding & Logo in addition to the Operator Console.
- Added
- Category Deletion with Responsive Cascade Warning (
ConfirmDeleteCategoryModal):- Added Hapus Kategori in Kategori & Bagan (
/back-office/turnamen) guarded by a responsive confirmation dialog (centered modal on desktop, slide-up bottom sheet on mobile) detailing the exact count of teams, matches/schedules/scores, and gallery media that will be permanently removed, plus automatic S3/local asset cleanup on cascade delete.
- Added Hapus Kategori in Kategori & Bagan (
Container Image (GitHub Packages / GHCR)
docker pull ghcr.io/ardianryan/openvolley:0.1.1OpenVolley v0.1.0
Added
- Real-Time Tournament & Rally Scoring Engine:
- Multi-category tournament management (
Best of 3/Best of 5, configurable regular & deciding set targets, optional2-point Deuce, and per-match rule overrides). - Explicit set-point / match-point confirmation gate (
awaitingConfirm), serving team indicator, set history tracking, and multi-action state undo.
- Multi-category tournament management (
- Symmetric Knockout Bracket & Technical Meeting Draw:
- Dedicated
16-teamand8-teamsymmetric left/right bracket tree initialization alongside general2–32seeded bracket generation with automatic bye advancement. - Automatic winner progression to Finals and semifinal loser routing to Third-Place fixtures.
- Dedicated
- Adaptive Real-Time Synchronization (
SSE+ETag):- Instant Server-Sent Events push (
/api/public/stream) with configurableMAX_SSE_CLIENTScap and automatic spectator fallback to lightweightETag(304 Not Modified) polling. - Cloudflare
CF-Connecting-IP/X-Forwarded-Forreal-IP awareness and Nginx reverse-proxy template (deploy/nginx-openvolley.conf).
- Instant Server-Sent Events push (
- PIN-Gated Arena TV Display (
/tv):- Fullscreen
16:9projector/LED scoreboard protected by constant-time PIN verification (safeComparePin) and dedicated VIP priority SSE stream (/api/public/tv-stream).
- Fullscreen
- 3-Role Back-Office (
/back-office):- Role-separated workspace for
admin,panitia(court officials), andmedia(broadcast crew) with responsive desktop sidebar and mobile bottom navigation.
- Role-separated workspace for
- Client-Side Broadcast Media Studio:
- Multi-ratio (
9:16,4:5,16:9,1:1) high-resolution PNG poster and animatedMP4/WebMbroadcast video export powered by HTML5 Canvas, offscreen Three.js 3D volleyball rendering, and procedural WebAudio SFX. - Multi-photo (
1–3photos) collage & diagonal-wipe video slideshow support plus in-browser single video trimmer (2s–15s) with original court audio mixing and smart S3 BGM auto-ducking. - Browser-first iPhone
.HEIC/.HEIFphoto normalization (createImageBitmap+ lazyheic2anyfallback) and.MOVQuickTime video verification (@ffmpeg/ffmpegWebAssembly fallback). - Sponsor tiering (Top-3 Principal vs Supporting/Media Partner), optional white backing plate toggle, and automatic upcoming match schedule + court badges.
- Multi-ratio (
- Multi-Slide & Video Moments Gallery:
- Swipeable multi-photo slide carousel, inline HTML5 video player, uncropped fullscreen lightbox modal, and S3-compatible object storage upload/cleanup with local
./data/uploadsfallback.
- Swipeable multi-photo slide carousel, inline HTML5 video player, uncropped fullscreen lightbox modal, and S3-compatible object storage upload/cleanup with local
- PWA, Accessibility & UI Polish:
- Installable Progressive Web App (
manifest.webmanifest, network-safesw.js, Android/Desktop install prompt + iOS Safari guide). - Seamless 1-icon 3-state theme toggle (
System→Opposite of OS→Explicit Same as OS→System) with zero-flash external/theme-init.js. - Interactive 3D Matchday Sport Center hero (
VolleyballArena3D) and verified WCAG 2.1 AA contrast ratios across Light and Dark themes. - Branded terminal startup banner displaying
localhostand auto-detected LAN IPv4 addresses for instant mobile testing.
- Installable Progressive Web App (
- Security Hardening & Error Page Suite:
- Strict
Content-Security-Policywithout'unsafe-inline'inscript-src, server/client plain-text & URL sanitizers (sanitizePlainText,sanitizeHexColor,sanitizeAssetUrl), magic-byte image/video verification,HttpOnlyJWT cookies, and sliding-window brute-force rate limiting. - Complete branded error UI & HTTP status handling covering
400,401,403,404,408,429,500,502,503(MAINTENANCE_MODE),Offline, and ReactErrorBoundary.
- Strict
- DevOps, CI/CD & Documentation:
- Multi-stage Alpine
Dockerfile,docker-compose.yml, GitHub Actions (CI,CodeQL, multi-archGHCRDocker package publishing, and automated GitHub Releases),CITATION.cff, BibTeX metadata, GitHub Custom Properties schema, and English documentation suite underdocs/.
- Multi-stage Alpine
Container Image (GitHub Packages / GHCR)
docker pull ghcr.io/ardianryan/openvolley:0.1.0