MPR - Media Processor

Media transcoding platform with dual execution modes: local (Celery + MinIO) and cloud (AWS Step Functions + Lambda + S3).

System Overview

Architecture

Open full size

Components

Reverse Proxy (nginx)
Application Layer (Django Admin, FastAPI + GraphQL, Timeline UI)
Worker Layer (Celery local mode)
AWS (Step Functions, Lambda - cloud mode)
Data Layer (PostgreSQL, Redis)
S3 Storage (MinIO local / AWS S3 cloud)

Data Model

Entity Relationships

Open full size

Entities

MediaAsset - Video/audio files (S3 keys as paths)
TranscodePreset - Encoding configurations
TranscodeJob - Processing queue (celery_task_id or execution_arn)

Job Flow

Job Lifecycle

Open full size

Job States

PENDING - Waiting in queue
PROCESSING - Worker executing
COMPLETED - Success
FAILED - Error occurred
CANCELLED - User cancelled

Execution Modes

Local: Celery + MinIO (S3 API) + FFmpeg
Lambda: Step Functions + Lambda + AWS S3

API Interfaces

# REST API
http://mpr.local.ar/api/docs     - Swagger UI
POST /api/assets/scan             - Scan S3 bucket for media
POST /api/jobs/                   - Create transcode job
POST /api/jobs/{id}/callback      - Lambda completion callback

# GraphQL (GraphiQL)
http://mpr.local.ar/graphql       - GraphiQL IDE
query { assets { id filename } }
mutation { createJob(input: {...}) { id status } }
mutation { scanMediaFolder { found registered } }

Access Points

# Local development
127.0.0.1 mpr.local.ar
http://mpr.local.ar/admin         - Django Admin
http://mpr.local.ar/api/docs      - FastAPI Swagger
http://mpr.local.ar/graphql       - GraphiQL
http://mpr.local.ar/              - Timeline UI
http://localhost:9001              - MinIO Console

# AWS deployment
https://mpr.mcrn.ar/              - Production

Quick Reference

# Render SVGs from DOT files
for f in *.dot; do dot -Tsvg "$f" -o "${f%.dot}.svg"; done

# Switch executor mode
MPR_EXECUTOR=local    # Celery + MinIO
MPR_EXECUTOR=lambda   # Step Functions + Lambda + S3