# sarker5523/jav architecture

> Architecture diagram of the GitHub repository sarker5523/jav, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sarker5523/jav
- Repository: https://github.com/sarker5523/jav

## Overview

This repository combines a small Express-hosted video site, described as supporting playlists, with a separate Python JAV metadata extractor. The visible server entry point returns the home page; the extractor reads video identifiers, fetches scene metadata from ThePornDB, and writes scene, performer, and site JSON. Other pages and JSON files are present, but their runtime relationships are not shown in the sampled source, so they are represented without guessed connections.

Main entry points: [`jav_extract.py`](https://github.com/sarker5523/jav/blob/main/jav_extract.py) (JAV extractor), [`server.js`](https://github.com/sarker5523/jav/blob/main/server.js) (Express server), [`index.html`](https://github.com/sarker5523/jav/blob/main/index.html) (Home page), [`video.json`](https://github.com/sarker5523/jav/blob/main/video.json) (Video inputs)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Video site"]
  node_express["Express server<br/>[server.js]"]
  node_home["Home page<br/>[index.html]"]
  node_video["Video page<br/>[video.html]"]
  node_playlist["Playlist page<br/>[jav.html]"]
  node_other_pages["Other site pages<br/>[performer.html]"]
end

subgraph group_extract["Metadata extraction"]
  node_extractor["JAV extractor<br/>[jav_extract.py]"]
  node_tpdb{{"ThePornDB API"}}
end

subgraph group_data["Local data"]
  node_video_ids["Video inputs<br/>[video.json]"]
  node_scenes["Scene details<br/>[scene_details.json]"]
  node_performers["Performer records<br/>[performer.json]"]
  node_sites["Site records<br/>[site.json]"]
  node_jav_scenes["JAV scene data"]
  node_jav_performers["JAV performer data<br/>[performer_jav.json]"]
  node_site_data["Site data<br/>[site_jav.json]"]
end

node_visitor(("Site visitor"))

node_visitor -->|"requests page"| node_express
node_express -->|"sends home"| node_home
node_extractor -->|"reads identifiers"| node_video_ids
node_extractor -->|"fetches scenes"| node_tpdb
node_extractor -->|"writes results"| node_scenes
node_extractor -->|"writes records"| node_performers
node_extractor -->|"writes records"| node_sites

click node_express "https://github.com/sarker5523/jav/blob/main/server.js"
click node_home "https://github.com/sarker5523/jav/blob/main/index.html"
click node_video "https://github.com/sarker5523/jav/blob/main/video.html"
click node_playlist "https://github.com/sarker5523/jav/blob/main/jav.html"
click node_other_pages "https://github.com/sarker5523/jav/blob/main/performer.html"
click node_extractor "https://github.com/sarker5523/jav/blob/main/jav_extract.py"
click node_video_ids "https://github.com/sarker5523/jav/blob/main/video.json"
click node_scenes "https://github.com/sarker5523/jav/blob/main/scene_details.json"
click node_performers "https://github.com/sarker5523/jav/blob/main/performer.json"
click node_sites "https://github.com/sarker5523/jav/blob/main/site.json"
click node_jav_scenes "https://github.com/sarker5523/jav/blob/main/scene_details_jav.json"
click node_jav_performers "https://github.com/sarker5523/jav/blob/main/performer_jav.json"
click node_site_data "https://github.com/sarker5523/jav/blob/main/site_jav.json"

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_express,node_home,node_video,node_playlist,node_other_pages toneBlue
class node_extractor,node_tpdb toneAmber
class node_video_ids,node_scenes,node_performers,node_sites,node_jav_scenes,node_jav_performers,node_site_data toneMint
class node_visitor toneIndigo
```

## Components

### Video site

- [Express server](https://github.com/sarker5523/jav/blob/main/server.js): `server.js`
- [Home page](https://github.com/sarker5523/jav/blob/main/index.html): `index.html`
- [Video page](https://github.com/sarker5523/jav/blob/main/video.html): `video.html`
- [Playlist page](https://github.com/sarker5523/jav/blob/main/jav.html): `jav.html`
- [Other site pages](https://github.com/sarker5523/jav/blob/main/performer.html): `performer.html`

### Metadata extraction

- [JAV extractor](https://github.com/sarker5523/jav/blob/main/jav_extract.py): `jav_extract.py`
- **ThePornDB API**

### Local data

- [Video inputs](https://github.com/sarker5523/jav/blob/main/video.json): `video.json`
- [Scene details](https://github.com/sarker5523/jav/blob/main/scene_details.json): `scene_details.json`
- [Performer records](https://github.com/sarker5523/jav/blob/main/performer.json): `performer.json`
- [Site records](https://github.com/sarker5523/jav/blob/main/site.json): `site.json`
- [JAV scene data](https://github.com/sarker5523/jav/blob/main/scene_details_jav.json): `scene_details_jav.json`
- [JAV performer data](https://github.com/sarker5523/jav/blob/main/performer_jav.json): `performer_jav.json`
- [Site data](https://github.com/sarker5523/jav/blob/main/site_jav.json): `site_jav.json`

### Other components

- **Site visitor**

## Connections

- Site visitor → Express server: requests page (evidence: `server.js`)
- Express server → Home page: sends home (evidence: `server.js`)
- JAV extractor → Video inputs: reads identifiers (evidence: `jav_extract.py`)
- JAV extractor → ThePornDB API: fetches scenes (evidence: `jav_extract.py`)
- JAV extractor → Scene details: writes results (evidence: `jav_extract.py`)
- JAV extractor → Performer records: writes records (evidence: `jav_extract.py`)
- JAV extractor → Site records: writes records (evidence: `jav_extract.py`)
