# tpayerli1/groupd-video-production-asset-revision-tracker architecture

> Architecture diagram of the GitHub repository tpayerli1/groupd-video-production-asset-revision-tracker, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tpayerli1/groupd-video-production-asset-revision-tracker
- Repository: https://github.com/tpayerli1/groupd-video-production-asset-revision-tracker

## Overview

VISA is a media-asset tracker with a Django web dashboard and an Electron desktop path-ingest client. The main workflow is to collect local file paths into a batch, register them in Django, enrich media with technical metadata and tags, then organize and search assets by project and client in the dashboard. Models provide persistence for these domain stages. The README documents metadata probing and optional batch tags; source excerpts show the dashboard/API and probe implementations, but not Electron’s request handlers, so that integration edge is documented rather than source-verified.

Main entry points: [`base/views.py`](https://github.com/tpayerli1/groupd-video-production-asset-revision-tracker/blob/main/base/views.py) (Web dashboard), [`base/models.py`](https://github.com/tpayerli1/groupd-video-production-asset-revision-tracker/blob/main/base/models.py) (Media assets), [`electron_app/main.js`](https://github.com/tpayerli1/groupd-video-production-asset-revision-tracker/blob/main/electron_app/main.js) (Electron uploader), [`base/urls.py`](https://github.com/tpayerli1/groupd-video-production-asset-revision-tracker/blob/main/base/urls.py) (Django routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingest["Desktop Ingest"]
  node_electron["Electron uploader<br/>[main.js]"]
  node_electron_probe["Desktop file probe<br/>[main.js]"]
end

subgraph group_web["Dashboard and API"]
  node_api["Batch and media API<br/>[views.py]"]
  node_routes["Django routes<br/>[urls.py]"]
  node_dashboard["Web dashboard<br/>[views.py]"]
  node_templates["Dashboard pages"]
end

subgraph group_domain["Asset Domain"]
  node_sqlite[("SQLite records<br/>[models.py]")]
  node_projects["Projects and clients<br/>[models.py]"]
  node_batches["Ingest batches<br/>[models.py]"]
  node_media["Media assets<br/>[models.py]"]
  node_tags["Tags and links<br/>[models.py]"]
  node_seed["Demo data generator<br/>[demo_seed.py]"]
end

subgraph group_metadata["Media Metadata"]
  node_metadata["Technical metadata<br/>[models.py]"]
  node_probe["Metadata probing<br/>[media_probe.py]"]
end

node_operator(("Uploader user"))
node_ffprobe["FFprobe utility"]

node_operator -->|"selects files"| node_electron
node_electron -.->|"sends paths"| node_api
node_api -->|"creates batches"| node_batches
node_api -->|"registers paths"| node_media
node_api -->|"saves metadata"| node_metadata
node_routes -->|"routes API"| node_api
node_routes -->|"routes pages"| node_dashboard
node_operator -->|"manages assets"| node_dashboard
node_dashboard -.->|"renders pages"| node_templates
node_dashboard -->|"manages projects"| node_projects
node_dashboard -->|"manages tags"| node_tags
node_dashboard -->|"searches assets"| node_media
node_dashboard -->|"manages batches"| node_batches
node_probe -->|"runs probe"| node_ffprobe
node_dashboard -->|"probes metadata"| node_probe
node_electron_probe -->|"reads media"| node_ffprobe
node_electron -->|"requests probe"| node_electron_probe
node_seed -->|"generates records"| node_projects
node_seed -->|"generates records"| node_media
node_media -->|"has metadata"| node_metadata
node_media -->|"has tag links"| node_tags
node_projects -->|"organizes assets"| node_media
node_batches -->|"collects assets"| node_media
node_sqlite -.->|"stores"| node_media

click node_electron "https://github.com/tpayerli1/groupd-video-production-asset-revision-tracker/blob/main/electron_app/main.js"
click node_api "https://github.com/tpayerli1/groupd-video-production-asset-revision-tracker/blob/main/base/views.py"
click node_routes "https://github.com/tpayerli1/groupd-video-production-asset-revision-tracker/blob/main/base/urls.py"
click node_dashboard "https://github.com/tpayerli1/groupd-video-production-asset-revision-tracker/blob/main/base/views.py"
click node_templates "https://github.com/tpayerli1/groupd-video-production-asset-revision-tracker/tree/main/base/templates/base"
click node_sqlite "https://github.com/tpayerli1/groupd-video-production-asset-revision-tracker/blob/main/base/models.py"
click node_projects "https://github.com/tpayerli1/groupd-video-production-asset-revision-tracker/blob/main/base/models.py"
click node_batches "https://github.com/tpayerli1/groupd-video-production-asset-revision-tracker/blob/main/base/models.py"
click node_media "https://github.com/tpayerli1/groupd-video-production-asset-revision-tracker/blob/main/base/models.py"
click node_tags "https://github.com/tpayerli1/groupd-video-production-asset-revision-tracker/blob/main/base/models.py"
click node_metadata "https://github.com/tpayerli1/groupd-video-production-asset-revision-tracker/blob/main/base/models.py"
click node_probe "https://github.com/tpayerli1/groupd-video-production-asset-revision-tracker/blob/main/base/media_probe.py"
click node_electron_probe "https://github.com/tpayerli1/groupd-video-production-asset-revision-tracker/blob/main/electron_app/main.js"
click node_seed "https://github.com/tpayerli1/groupd-video-production-asset-revision-tracker/blob/main/base/demo_seed.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_electron,node_electron_probe,node_operator toneBlue
class node_api,node_routes,node_dashboard,node_templates toneAmber
class node_sqlite,node_projects,node_batches,node_media,node_tags,node_seed toneMint
class node_metadata,node_probe toneRose
class node_ffprobe toneIndigo
```

## Components

### Desktop Ingest

- [Electron uploader](https://github.com/tpayerli1/groupd-video-production-asset-revision-tracker/blob/main/electron_app/main.js): `electron_app/main.js`
- [Desktop file probe](https://github.com/tpayerli1/groupd-video-production-asset-revision-tracker/blob/main/electron_app/main.js): `electron_app/main.js`

### Dashboard and API

- [Batch and media API](https://github.com/tpayerli1/groupd-video-production-asset-revision-tracker/blob/main/base/views.py): `base/views.py`
- [Django routes](https://github.com/tpayerli1/groupd-video-production-asset-revision-tracker/blob/main/base/urls.py): `base/urls.py`
- [Web dashboard](https://github.com/tpayerli1/groupd-video-production-asset-revision-tracker/blob/main/base/views.py): `base/views.py`
- [Dashboard pages](https://github.com/tpayerli1/groupd-video-production-asset-revision-tracker/tree/main/base/templates/base): `base/templates/base`

### Asset Domain

- [SQLite records](https://github.com/tpayerli1/groupd-video-production-asset-revision-tracker/blob/main/base/models.py): `base/models.py`
- [Projects and clients](https://github.com/tpayerli1/groupd-video-production-asset-revision-tracker/blob/main/base/models.py): `base/models.py`
- [Ingest batches](https://github.com/tpayerli1/groupd-video-production-asset-revision-tracker/blob/main/base/models.py): `base/models.py`
- [Media assets](https://github.com/tpayerli1/groupd-video-production-asset-revision-tracker/blob/main/base/models.py): `base/models.py`
- [Tags and links](https://github.com/tpayerli1/groupd-video-production-asset-revision-tracker/blob/main/base/models.py): `base/models.py`
- [Demo data generator](https://github.com/tpayerli1/groupd-video-production-asset-revision-tracker/blob/main/base/demo_seed.py): `base/demo_seed.py`

### Media Metadata

- [Technical metadata](https://github.com/tpayerli1/groupd-video-production-asset-revision-tracker/blob/main/base/models.py): `base/models.py`
- [Metadata probing](https://github.com/tpayerli1/groupd-video-production-asset-revision-tracker/blob/main/base/media_probe.py): `base/media_probe.py`

### Other components

- **Uploader user**
- **FFprobe utility**

## Connections

- Uploader user → Electron uploader: selects files (evidence: `readme.md`)
- Electron uploader → Batch and media API: sends paths (evidence: `readme.md`)
- Batch and media API → Ingest batches: creates batches (evidence: `base/views.py`)
- Batch and media API → Media assets: registers paths (evidence: `base/views.py`)
- Batch and media API → Technical metadata: saves metadata (evidence: `base/views.py`)
- Django routes → Batch and media API: routes API (evidence: `base/urls.py`)
- Django routes → Web dashboard: routes pages (evidence: `base/urls.py`)
- Uploader user → Web dashboard: manages assets (evidence: `readme.md`)
- Web dashboard → Dashboard pages: renders pages
- Web dashboard → Projects and clients: manages projects (evidence: `base/views.py`)
- Web dashboard → Tags and links: manages tags (evidence: `base/views.py`)
- Web dashboard → Media assets: searches assets (evidence: `base/views.py`)
- Web dashboard → Ingest batches: manages batches (evidence: `base/views.py`)
- Metadata probing → FFprobe utility: runs probe (evidence: `base/media_probe.py`)
- Web dashboard → Metadata probing: probes metadata (evidence: `base/views.py`)
- Desktop file probe → FFprobe utility: reads media (evidence: `electron_app/main.js`)
- Electron uploader → Desktop file probe: requests probe (evidence: `electron_app/main.js`)
- Demo data generator → Projects and clients: generates records (evidence: `base/demo_seed.py`)
- Demo data generator → Media assets: generates records (evidence: `base/demo_seed.py`)
- Media assets → Technical metadata: has metadata (evidence: `base/models.py`)
- Media assets → Tags and links: has tag links (evidence: `base/models.py`)
- Projects and clients → Media assets: organizes assets (evidence: `base/models.py`)
- Ingest batches → Media assets: collects assets (evidence: `base/models.py`)
- SQLite records → Media assets: stores (evidence: `base/models.py`)
