Oliver/video-accessibility
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
video-accessibility/docs
History
Exact
Vadym Samoilenko 2f4925353a feat(pause-insert): adaptive buffer, forward-snap, timeline drag + share link fix 
Backend (Phase A):
- A1: Adaptive silence buffer — natural_gap_ms persisted per cue; renderer computes
  per-cue silence_before/silence_after instead of fixed 500ms; per-cue silence files
- A2: Forward-preferred snap — snap_pause_point prefers boundaries up to 4s ahead
  over boundaries within 1.5s behind, reducing mid-scene cuts
- A3: Min-gap validation — pause points with < 200ms gap trigger forward search
  to the next acceptable gap
- natural_gap_ms added to PausePointData model and api.ts type
- New config fields: whisper_snap_forward_window, whisper_snap_backward_window,
  ad_silence_buffer_default, ad_silence_buffer_min_after, ad_min_acceptable_gap
- Tests: test_whisper_snap.py (13 tests), test_video_renderer_buffers.py

Frontend (Phase B):
- B1: Drag pause-point markers — pointer state machine with 3px move threshold,
  clamp to min/max bounds, click-without-move still opens PausePointEditor
- B2: Drag freeze blocks — orange blocks translate with linked pause point
- B3: Time tooltip visible during drag, hidden on release
- Tests: TimelinePreview.drag.test.tsx (10 tests)

Fixes:
- Share link pointed to ai-sandbox.oliver.solutions — added app_url to Settings
  with correct optical-dev.oliver.solutions default; share_url now configurable
  via APP_URL env var
- Removed all ai-sandbox.oliver.solutions references from docker-compose,
  apache config, docs, and scripts

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-01 16:09:09 +01:00
..
project feat(pause-insert): adaptive buffer, forward-snap, timeline drag + share link fix 2026-05-01 16:09:09 +01:00
reference docs: add canonical documentation + audit cleanup 2026-04-29 14:22:51 +01:00
tasks docs: add canonical documentation + audit cleanup 2026-04-29 14:22:51 +01:00
documentation_standards.md docs: add canonical documentation + audit cleanup 2026-04-29 14:22:51 +01:00
principles.md docs: add canonical documentation + audit cleanup 2026-04-29 14:22:51 +01:00
prompt_closed_captions.md wrote docker files and deployment instructions 2025-10-08 16:00:12 -05:00
README.md docs: add canonical documentation + audit cleanup 2026-04-29 14:22:51 +01:00
Video Accessibility app Technical Documentation 2025-08-24.pdf initial commit 2025-08-24 16:28:33 -05:00
video accessibility demo user guide instructions.pdf fixed session refresh and added full deploy script - and added documentation including videos 2025-10-08 22:29:08 -05:00
video accessibility technical documentation 2025-09-09.pdf added MSAL microsoft authentication 2025-10-10 09:19:39 -05:00
video-accessibility-demo-instructions.mp4 fixed session refresh and added full deploy script - and added documentation including videos 2025-10-08 22:29:08 -05:00
video-accessibility-download-final-assets.mp4 fixed session refresh and added full deploy script - and added documentation including videos 2025-10-08 22:29:08 -05:00
video_accessibility_app_demo_2025-08-24.mp4 removed mongodb change stream monitoring, added global websockets monitoring for notifications, broke symmetry between toasts and persistent notifications (and refined which notifications get sent and how) 2025-08-25 15:48:18 -05:00
video_accessibility_spec.md wrote docker files and deployment instructions 2025-10-08 16:00:12 -05:00
video_accessibility_technical_docs_2025-08-24.md initial commit 2025-08-24 16:28:33 -05:00
video_accessibility_technical_documentation_v2.md added MSAL microsoft authentication 2025-10-10 09:19:39 -05:00

README.md

Documentation Hub — Accessible Video Processing Platform

This is the central index for all project documentation. Each section links to a specific domain doc.

Project Documentation

Document Contents
requirements.md Functional requirements, QC workflow, RBAC matrix
architecture.md System design, job state machine, data flow, security model
tech_stack.md All dependency versions, configuration anchors
api_spec.md REST endpoints, WebSocket, auth flows
database_schema.md MongoDB collections, indexes, data shapes
infrastructure.md Server inventory, ports, GCS layout, external services
runbook.md Local setup, deploy, restart, backup, rollback

Reference Documentation

Directory Contains
reference/README.md Index of ADRs, guides, manuals, research
reference/adrs/ Architecture Decision Records
reference/guides/ Developer how-to guides
reference/manuals/ Operator manuals
reference/research/ Technology research notes

Standards and Principles

Document Contents
documentation_standards.md 60 universal documentation requirements
principles.md 11 development principles (Standards First, YAGNI, KISS, DRY…)

Task and Test Management

Document Contents
tasks/README.md Task management rules and conventions
tests/README.md Test strategy, commands, coverage targets

Canonical Entry Point

All documentation is reachable from ../AGENTS.md. Agents and humans should start there.

Maintenance

Update triggers: New doc added, section moved, external URL changes. Verification: All links in this file resolve. AGENTS.md Quick Navigation matches this hub.