# oriolbegnat/linqi-linqi architecture

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

- Interactive diagram: https://gitdiagram.com/oriolbegnat/linqi-linqi
- Repository: https://github.com/oriolbegnat/linqi-linqi

## Overview

Linqi-linqi is documented as a web app for guiding beginner musicians through audio mastering. Its main workflow is to upload audio, build and reorder an effects chain, hear changes in real time, and download the result; a step-by-step guide supports the session. The README also names waveform and spectrum visualization. The repository contains no source excerpts, so this is a documented product map, not a verified implementation architecture; relationships are limited to those described in the README.

Main entry points: [`README.md`](https://github.com/oriolbegnat/linqi-linqi/blob/main/README.md) (Effects chain)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Mastering workflow"]
  node_upload["Audio upload<br/>[README.md]"]
  node_effects["Effects chain<br/>[README.md]"]
  node_reorder["Chain reordering<br/>[README.md]"]
  node_download["Result download<br/>[README.md]"]
end

subgraph group_audio["Audio interaction"]
  node_preview["Live preview<br/>[README.md]"]
  node_audio_api["Web Audio API"]
  node_visualizer["Waveform and spectrum<br/>[README.md]"]
  node_canvas_api["Canvas API"]
end

subgraph group_guidance["Learning guide"]
  node_guide["Step-by-step guide<br/>[README.md]"]
  node_guide_content["Tips and glossary<br/>[README.md]"]
end

node_user(("Musician"))

node_user -->|"uploads audio"| node_upload
node_upload -->|"starts mastering"| node_effects
node_user -->|"adds effects"| node_effects
node_user -->|"reorders effects"| node_reorder
node_reorder -->|"reorders chain"| node_effects
node_effects -->|"processes audio"| node_audio_api
node_audio_api -->|"enables listening"| node_preview
node_preview -->|"plays changes"| node_user
node_audio_api -->|"provides visualization"| node_visualizer
node_visualizer -->|"uses canvas"| node_canvas_api
node_user -->|"downloads result"| node_download
node_user -->|"follows steps"| node_guide
node_guide -->|"offers guidance"| node_guide_content

click node_upload "https://github.com/oriolbegnat/linqi-linqi/blob/main/README.md"
click node_effects "https://github.com/oriolbegnat/linqi-linqi/blob/main/README.md"
click node_reorder "https://github.com/oriolbegnat/linqi-linqi/blob/main/README.md"
click node_preview "https://github.com/oriolbegnat/linqi-linqi/blob/main/README.md"
click node_visualizer "https://github.com/oriolbegnat/linqi-linqi/blob/main/README.md"
click node_download "https://github.com/oriolbegnat/linqi-linqi/blob/main/README.md"
click node_guide "https://github.com/oriolbegnat/linqi-linqi/blob/main/README.md"
click node_guide_content "https://github.com/oriolbegnat/linqi-linqi/blob/main/README.md"

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_upload,node_effects,node_reorder,node_download toneBlue
class node_preview,node_audio_api,node_visualizer,node_canvas_api toneAmber
class node_guide,node_guide_content toneMint
class node_user toneIndigo
```

## Components

### Mastering workflow

- [Audio upload](https://github.com/oriolbegnat/linqi-linqi/blob/main/README.md): `README.md`
- [Effects chain](https://github.com/oriolbegnat/linqi-linqi/blob/main/README.md): `README.md`
- [Chain reordering](https://github.com/oriolbegnat/linqi-linqi/blob/main/README.md): `README.md`
- [Result download](https://github.com/oriolbegnat/linqi-linqi/blob/main/README.md): `README.md`

### Audio interaction

- [Live preview](https://github.com/oriolbegnat/linqi-linqi/blob/main/README.md): `README.md`
- **Web Audio API**
- [Waveform and spectrum](https://github.com/oriolbegnat/linqi-linqi/blob/main/README.md): `README.md`
- **Canvas API**

### Learning guide

- [Step-by-step guide](https://github.com/oriolbegnat/linqi-linqi/blob/main/README.md): `README.md`
- [Tips and glossary](https://github.com/oriolbegnat/linqi-linqi/blob/main/README.md): `README.md`

### Other components

- **Musician**

## Connections

- Musician → Audio upload: uploads audio (evidence: `README.md`)
- Audio upload → Effects chain: starts mastering (evidence: `README.md`)
- Musician → Effects chain: adds effects (evidence: `README.md`)
- Musician → Chain reordering: reorders effects (evidence: `README.md`)
- Chain reordering → Effects chain: reorders chain (evidence: `README.md`)
- Effects chain → Web Audio API: processes audio (evidence: `README.md`)
- Web Audio API → Live preview: enables listening (evidence: `README.md`)
- Live preview → Musician: plays changes (evidence: `README.md`)
- Web Audio API → Waveform and spectrum: provides visualization (evidence: `README.md`)
- Waveform and spectrum → Canvas API: uses canvas (evidence: `README.md`)
- Musician → Result download: downloads result (evidence: `README.md`)
- Musician → Step-by-step guide: follows steps (evidence: `README.md`)
- Step-by-step guide → Tips and glossary: offers guidance (evidence: `README.md`)
