History

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.