# jev-ai/jev-api architecture

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

- Interactive diagram: https://gitdiagram.com/jev-ai/jev-api
- Repository: https://github.com/jev-ai/jev-api

## Overview

This tree is a static Next.js site snapshot, not the Jev decision service implementation. The README describes a typed-decision API and Playground workflow; sampled browser bundles also expose an AI generation studio with model forms, task status, history, and results. Paths below identify the available page and compiled chunks, so internal wiring beyond the documented workflow is intentionally limited.

Main entry points: [`_next/static/chunks/13cc3e46dbf9f9d4.js`](https://github.com/jev-ai/jev-api/blob/main/_next/static/chunks/13cc3e46dbf9f9d4.js) (Generation studio), [`_next/static/chunks/be70605be73fce34.js`](https://github.com/jev-ai/jev-api/blob/main/_next/static/chunks/be70605be73fce34.js) (Decision Playground), [`README.md`](https://github.com/jev-ai/jev-api/blob/main/README.md) (Typed results), [`index.html`](https://github.com/jev-ai/jev-api/blob/main/index.html) (Jev website)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_decision["Decision workflow"]
  node_playground["Decision Playground"]
  node_state["Shared state<br/>[README.md]"]
  node_questions["Typed questions<br/>[README.md]"]
  node_decision_api{{"Decision API"}}
  node_typed_results["Typed results<br/>[README.md]"]
  node_app_logic["Application logic<br/>[README.md]"]
end

subgraph group_studio["Generation studio"]
  node_studio["Generation studio"]
  node_model_form["Model form"]
  node_generation_api{{"Generation endpoint"}}
  node_task_tracking["Task tracking"]
  node_generation_results["Generated media"]
  node_auth_credits["Auth and credits"]
  node_history["Generation history"]
end

subgraph group_site["Site interface"]
  node_site["Jev website<br/>[index.html]"]
end

node_user(("Developer / user"))

node_user -->|"uses"| node_site
node_user -->|"defines"| node_playground
node_playground -->|"provides"| node_state
node_playground -->|"defines"| node_questions
node_playground -->|"submits"| node_decision_api
node_decision_api -->|"returns"| node_typed_results
node_typed_results -->|"informs"| node_app_logic
node_user -->|"opens"| node_studio
node_studio -->|"configures"| node_model_form
node_studio -->|"checks access"| node_auth_credits
node_studio -->|"submits"| node_generation_api
node_studio -->|"tracks"| node_task_tracking
node_studio -->|"loads"| node_history
node_task_tracking -->|"displays"| node_generation_results

click node_site "https://github.com/jev-ai/jev-api/blob/main/index.html"
click node_playground "https://github.com/jev-ai/jev-api/blob/main/_next/static/chunks/be70605be73fce34.js"
click node_state "https://github.com/jev-ai/jev-api/blob/main/README.md"
click node_questions "https://github.com/jev-ai/jev-api/blob/main/README.md"
click node_typed_results "https://github.com/jev-ai/jev-api/blob/main/README.md"
click node_app_logic "https://github.com/jev-ai/jev-api/blob/main/README.md"
click node_studio "https://github.com/jev-ai/jev-api/blob/main/_next/static/chunks/13cc3e46dbf9f9d4.js"
click node_model_form "https://github.com/jev-ai/jev-api/blob/main/_next/static/chunks/13cc3e46dbf9f9d4.js"
click node_task_tracking "https://github.com/jev-ai/jev-api/blob/main/_next/static/chunks/13cc3e46dbf9f9d4.js"
click node_generation_results "https://github.com/jev-ai/jev-api/blob/main/_next/static/chunks/13cc3e46dbf9f9d4.js"
click node_auth_credits "https://github.com/jev-ai/jev-api/blob/main/_next/static/chunks/be70605be73fce34.js"
click node_history "https://github.com/jev-ai/jev-api/blob/main/_next/static/chunks/be70605be73fce34.js"

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_playground,node_state,node_questions,node_decision_api,node_typed_results,node_app_logic,node_user toneBlue
class node_studio,node_model_form,node_generation_api,node_task_tracking,node_generation_results,node_auth_credits,node_history toneAmber
class node_site toneMint
```

## Components

### Decision workflow

- [Decision Playground](https://github.com/jev-ai/jev-api/blob/main/_next/static/chunks/be70605be73fce34.js): `_next/static/chunks/be70605be73fce34.js`
- [Shared state](https://github.com/jev-ai/jev-api/blob/main/README.md): `README.md`
- [Typed questions](https://github.com/jev-ai/jev-api/blob/main/README.md): `README.md`
- **Decision API**
- [Typed results](https://github.com/jev-ai/jev-api/blob/main/README.md): `README.md`
- [Application logic](https://github.com/jev-ai/jev-api/blob/main/README.md): `README.md`

### Generation studio

- [Generation studio](https://github.com/jev-ai/jev-api/blob/main/_next/static/chunks/13cc3e46dbf9f9d4.js): `_next/static/chunks/13cc3e46dbf9f9d4.js`
- [Model form](https://github.com/jev-ai/jev-api/blob/main/_next/static/chunks/13cc3e46dbf9f9d4.js): `_next/static/chunks/13cc3e46dbf9f9d4.js`
- **Generation endpoint**
- [Task tracking](https://github.com/jev-ai/jev-api/blob/main/_next/static/chunks/13cc3e46dbf9f9d4.js): `_next/static/chunks/13cc3e46dbf9f9d4.js`
- [Generated media](https://github.com/jev-ai/jev-api/blob/main/_next/static/chunks/13cc3e46dbf9f9d4.js): `_next/static/chunks/13cc3e46dbf9f9d4.js`
- [Auth and credits](https://github.com/jev-ai/jev-api/blob/main/_next/static/chunks/be70605be73fce34.js): `_next/static/chunks/be70605be73fce34.js`
- [Generation history](https://github.com/jev-ai/jev-api/blob/main/_next/static/chunks/be70605be73fce34.js): `_next/static/chunks/be70605be73fce34.js`

### Site interface

- [Jev website](https://github.com/jev-ai/jev-api/blob/main/index.html): `index.html`

### Other components

- **Developer / user**

## Connections

- Developer / user → Jev website: uses
- Developer / user → Decision Playground: defines
- Decision Playground → Shared state: provides
- Decision Playground → Typed questions: defines
- Decision Playground → Decision API: submits
- Decision API → Typed results: returns
- Typed results → Application logic: informs
- Developer / user → Generation studio: opens
- Generation studio → Model form: configures
- Generation studio → Auth and credits: checks access
- Generation studio → Generation endpoint: submits
- Generation studio → Task tracking: tracks
- Generation studio → Generation history: loads
- Task tracking → Generated media: displays