---
auto_generated: true
created: 2026-05-18
manual_updated_at: 2026-05-18
modified: 2026-05-18
name: User_Manual
status: active
tags:
- domain/accessibility
- domain/ai
- tech/docker
- tech/gemini
- tech/react
- type/sop
type: sop
---

# User Manual: Accessible Video Processing Platform

## What This Tool Does

The **Accessible Video Processing Platform** is an AI-powered solution designed to make video content inclusive and accessible to diverse audiences. It automates the complex workflow of generating closed captions, audio descriptions (with voiceovers), and multi-language translations for video content.

Instead of manually creating accessibility assets, users upload a video, and the platform uses advanced AI models (Gemini 2.5 Pro, Google Cloud TTS, Whisper) to generate high-quality, synchronized accessibility layers. The platform includes a robust quality control (QC) workflow where human reviewers verify and edit the generated content before final delivery.

## Who Uses It

This platform serves three primary user roles:

1.  **Clients/Content Creators**: Users who upload videos and manage their accessibility projects. They initiate jobs, track progress, and download final accessible assets.
2.  **Reviewers**: Linguists or accessibility experts who review generated captions and audio descriptions, make necessary edits, and approve the content for delivery.
3.  **Administrators**: System managers who oversee user accounts, organizational settings, audit logs, and glossary management.

## How to Access

### Prerequisites
- A web browser (Chrome, Firefox, Edge, or Safari).
- Valid organizational credentials (Microsoft Account/Enterprise SSO).

### Login
1. Navigate to the application URL.
2. Click **Login**. You will be redirected to the Microsoft Authentication Library (MSAL) login screen.
3. Enter your organizational credentials to sign in.
4. Upon successful authentication, you will be redirected to the **Dashboard**.

## Main Workflows

### Workflow 1: Creating a New Accessibility Job (For Clients)

1.  **Navigate to Upload**: From the Dashboard, click **New Job**.
2.  **Upload Video**: 
    - Drag and drop your video file into the upload area or click to browse.
    - The system validates the file format and size.
3.  **Configure Settings**:
    - **Source Language**: Select the original language of the video.
    - **Target Languages**: Select one or more languages for translation (supports 50+ languages).
    - **Services**: Check boxes for required services:
        - *Closed Captions (CC)*
        - *Audio Descriptions (AD)*
        - *Multi-language Translation*
4.  **Submit Job**: Click **Start Processing**. 
    - You will be taken to the **Jobs List** where the new job appears.
    - A toast notification confirms the submission.

### Workflow 2: Tracking Job Progress

1.  **Job List View**: View the status of all your jobs in real-time.
2.  **Real-Time Updates**: 
    - Use the **WebSocket** status bar to see live progress.
    - Toast notifications will pop up when status changes occur (e.g., "Caption Generation Complete").
3.  **Job Details**: Click on a specific job ID to view:
    - Detailed progress bars for each AI service (Whisper, Gemini, TTS).
    - Logs of the processing stages.
    - Estimated time remaining.

### Workflow 3: Quality Control Review (For Reviewers)

1.  **Access QC Queue**: Navigate to **QC List** from the admin menu.
2.  **Review Item**: Click on a job marked as **Ready for Review**.
3.  **Edit Captions**:
    - Open the **VTT Editor**.
    - Play the video and read the synchronized captions.
    - Click on any caption line to edit the text directly.
    - Save changes to update the VTT file.
4.  **Review Audio Descriptions**:
    - Listen to the generated TTS audio.
    - If the tone is inappropriate or inaccurate, flag the section for re-generation or manual note.
5.  **Approve/Reject**:
    - Click **Approve** to send the assets for final delivery.
    - Click **Reject** with a comment to send it back to AI processing for regeneration.
6.  **Audit Trail**: All review actions are logged automatically in the **Audit Log** for compliance.

### Workflow 4: Downloading Final Assets

1.  **Navigate to Downloads**: Go to the **Downloads** page.
2.  **Select Completed Jobs**: Filter by status "Approved".
3.  **Download Assets**:
    - Click the download icon next to each asset:
        - *VTT File*: For captions.
        - *Audio File*: For audio descriptions.
    - Assets are delivered via secure, time-limited signed URLs.

## FAQ

**Q: How long does processing take?**
A: Processing time depends on video length and the number of target languages. Typically, captions take 2-5 minutes per hour of video, while audio descriptions may take longer due to TTS synthesis.

**Q: Can I edit captions before they are processed?**
A: You can provide a **Glossary** in the settings to influence the AI's terminology. However, the primary editing window is during the Quality Control phase.

**Q: Why is my job stuck on "Processing"?**
A: Check the **Job Detail** logs. If it remains stuck for more than 10 minutes, try refreshing the page. If the issue persists, contact an Administrator to check the worker queues.

**Q: How are my files secured?**
A: Files are stored in Google Cloud Storage with signed URLs that expire after 24 hours. The platform also enforces strict Role-Based Access Control (RBAC).

**Q: Who can approve my work?**
A: Only users with the **Reviewer** or **Admin** role can approve jobs. Clients cannot self-approve their own submissions.

## Related
- [[01 Projects/video-accessibility-old/DEVELOPER_MANUAL.md]]