From 0728fc6be3759c105773b43bfb8a75eff59bcc50 Mon Sep 17 00:00:00 2001
From: buenosairesam <mariano@gotadeinfo.com>
Date: Wed, 6 May 2026 10:45:19 -0300
Subject: [PATCH] clean stale readme

---
 README.md | 161 ++----------------------------------------------------
 1 file changed, 5 insertions(+), 156 deletions(-)

diff --git a/README.md b/README.md
index c0f71a3..8f27031 100644
--- a/README.md
+++ b/README.md
@@ -1,161 +1,10 @@
-# MPR - Media Processor
+# MPR
 
-A web-based media transcoding tool with Django admin, FastAPI backend, and React timeline UI.
+Brand and logo detection pipeline for video — extracts frames, segments the field, runs YOLO + OCR, and escalates unresolved detections to local or cloud VLMs.
 
-## Architecture
-
-```
-Browser (mpr.local.ar)
-         │
-      nginx:80
-         │
-    ┌────┴────┐
-    │         │
- /admin     /api, /ui
-    │         │
- Django    FastAPI ◄── Timeline UI
-    │         │
-    │    ┌────┘
-    │    │
-    └───►│ (job operations)
-         │
-    gRPC Server
-         │
-    Celery Worker
-```
-
-- **Django** (`/admin`): Admin interface for data management
-- **FastAPI** (`/api`): REST API and gRPC client
-- **Timeline UI** (`/ui`): React app for video editing
-- **gRPC Server**: Worker communication with progress streaming
-- **Celery**: Job execution via FFmpeg
-
-## Prerequisites
-
-- Docker & Docker Compose
-
-## Quick Start
+## Docs
 
 ```bash
-# Add to /etc/hosts
-echo "127.0.0.1 mpr.local.ar" | sudo tee -a /etc/hosts
-
-# Start all services
-cd ctrl
-cp .env.template .env
-docker compose up -d
+python -m http.server 8000 --directory docs
+# open http://localhost:8000
 ```
-
-## Access Points
-
-| URL | Description |
-|-----|-------------|
-| http://mpr.local.ar/admin | Django Admin |
-| http://mpr.local.ar/api/docs | FastAPI Swagger |
-| http://mpr.local.ar/ui | Timeline UI |
-
-## Commands
-
-```bash
-cd ctrl
-
-# Start/stop
-docker compose up -d
-docker compose down
-
-# Rebuild after code changes
-docker compose up -d --build
-
-# View logs
-docker compose logs -f
-docker compose logs -f celery
-
-# Create admin user
-docker compose exec django python admin/manage.py createsuperuser
-```
-
-## Code Generation
-
-Models are defined as dataclasses in `core/schema/models/` and generated via `modelgen`:
-- **Django ORM** models (`--include dataclasses,enums`)
-- **Pydantic** schemas (`--include dataclasses,enums`)
-- **TypeScript** types (`--include dataclasses,enums,api`)
-- **Protobuf** definitions (`--include grpc`)
-
-Each target only gets the model groups it needs via the `--include` flag.
-
-```bash
-# Regenerate all targets
-bash ctrl/generate.sh
-```
-
-## Media Storage
-
-MPR separates media into **input** (`MEDIA_IN`) and **output** (`MEDIA_OUT`) paths, each independently configurable. File paths are stored relative for cloud portability.
-
-### Local Development
-- Source files: `/app/media/in/video.mp4`
-- Output files: `/app/media/out/video_h264.mp4`
-- Served via: `http://mpr.local.ar/media/in/video.mp4` (nginx alias)
-
-### AWS/Cloud Deployment
-Input and output can be different buckets/locations:
-```bash
-MEDIA_IN=s3://source-bucket/media/
-MEDIA_OUT=s3://output-bucket/transcoded/
-```
-
-**Scan Endpoint**: `POST /api/assets/scan` recursively scans `MEDIA_IN` and registers new files with relative paths.
-
-See [docs/media-storage.md](docs/media-storage.md) for full details.
-
-## Project Structure
-
-```
-mpr/
-├── admin/               # Django project
-│   ├── manage.py        # Django management script
-│   └── mpr/             # Django settings & app
-│       └── media_assets/# Django app
-├── core/                # Core application logic
-│   ├── api/             # FastAPI + GraphQL API
-│   │   └── schema/      # GraphQL types (generated)
-│   ├── ffmpeg/          # FFmpeg wrappers
-│   ├── rpc/             # gRPC server & client
-│   │   └── protos/      # Protobuf definitions (generated)
-│   ├── schema/          # Source of truth
-│   │   └── models/      # Dataclass definitions
-│   ├── storage/         # S3/GCP/local storage backends
-│   └── task/            # Celery job execution
-│       ├── executor.py  # Executor abstraction
-│       └── tasks.py     # Celery tasks
-├── ctrl/                # Docker & deployment
-│   ├── docker-compose.yml
-│   └── nginx.conf
-├── media/
-│   ├── in/              # Source media files
-│   └── out/             # Transcoded output
-├── modelgen/            # Code generation tool
-└── ui/                  # Frontend
-    └── timeline/        # React app
-```
-
-## Environment Variables
-
-See `ctrl/.env.template` for all configuration options.
-
-| Variable | Default | Description |
-|----------|---------|-------------|
-| `DATABASE_URL` | sqlite | PostgreSQL connection string |
-| `REDIS_URL` | redis://localhost:6379 | Redis for Celery |
-| `GRPC_HOST` | grpc | gRPC server hostname |
-| `GRPC_PORT` | 50051 | gRPC server port |
-| `MPR_EXECUTOR` | local | Executor type (local/lambda) |
-| `MEDIA_IN` | /app/media/in | Source media files directory |
-| `MEDIA_OUT` | /app/media/out | Transcoded output directory |
-| `MEDIA_BASE_URL` | /media/ | Base URL for serving media (use S3 URL for cloud) |
-| `VITE_ALLOWED_HOSTS` | - | Comma-separated allowed hosts for Vite dev server |
-
-## License
-
-MIT