# abdenourbouaziz/bac2026 architecture

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

- Interactive diagram: https://gitdiagram.com/abdenourbouaziz/bac2026
- Repository: https://github.com/abdenourbouaziz/bac2026

## Overview

Bac 2026 Algérie is a browser-based assistant for students, offering chat, creative image/video generation, document scanning and analysis, and voice features in French and Arabic. The main workflow is implemented in one large app module, with a separate visual-enhancement layer. The excerpts show calls to Puter AI, browser storage, and speech APIs; the README is empty, and unsampled implementation details are not inferred.

Main entry points: [`js/premium.js`](https://github.com/abdenourbouaziz/bac2026/blob/master/js/premium.js) (Visual enhancements), [`js/app.js`](https://github.com/abdenourbouaziz/bac2026/blob/master/js/app.js) (Guidance chat), [`index.html`](https://github.com/abdenourbouaziz/bac2026/blob/master/index.html) (Web app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workspace["Student workspace"]
  node_webapp["Web app<br/>[index.html]"]
  node_chat["Guidance chat<br/>[app.js]"]
  node_localization["French and Arabic<br/>[app.js]"]
  node_history["Chat preferences<br/>[app.js]"]
  node_voice["Voice input and output<br/>[app.js]"]
  node_image["Image studio<br/>[app.js]"]
  node_video["Video studio<br/>[app.js]"]
  node_scanner["Document scanner<br/>[app.js]"]
end

subgraph group_services["AI and browser services"]
  node_puter{{"Puter AI"}}
  node_storage[("Browser storage")]
  node_speech["Browser speech"]
end

subgraph group_presentation["Visual experience"]
  node_premium["Visual enhancements<br/>[premium.js]"]
  node_gsap{{"GSAP and ScrollTrigger"}}
  node_confetti{{"Confetti library"}}
  node_lucide{{"Lucide icons"}}
end

node_student(("Student"))

node_student -.->|"uses"| node_webapp
node_chat -->|"requests chat"| node_puter
node_image -->|"generates images"| node_puter
node_scanner -->|"analyzes documents"| node_puter
node_chat -->|"saves history"| node_storage
node_localization -->|"reads language"| node_storage
node_voice -->|"requests speech"| node_puter
node_voice -->|"uses speech synthesis"| node_speech
node_premium -->|"animates reveals"| node_gsap
node_premium -->|"triggers effects"| node_confetti
node_premium -->|"renders icons"| node_lucide

click node_webapp "https://github.com/abdenourbouaziz/bac2026/blob/master/index.html"
click node_chat "https://github.com/abdenourbouaziz/bac2026/blob/master/js/app.js"
click node_localization "https://github.com/abdenourbouaziz/bac2026/blob/master/js/app.js"
click node_history "https://github.com/abdenourbouaziz/bac2026/blob/master/js/app.js"
click node_voice "https://github.com/abdenourbouaziz/bac2026/blob/master/js/app.js"
click node_image "https://github.com/abdenourbouaziz/bac2026/blob/master/js/app.js"
click node_video "https://github.com/abdenourbouaziz/bac2026/blob/master/js/app.js"
click node_scanner "https://github.com/abdenourbouaziz/bac2026/blob/master/js/app.js"
click node_premium "https://github.com/abdenourbouaziz/bac2026/blob/master/js/premium.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_webapp,node_chat,node_localization,node_history,node_voice,node_image,node_video,node_scanner toneBlue
class node_puter,node_storage,node_speech toneAmber
class node_premium,node_gsap,node_confetti,node_lucide toneMint
class node_student toneIndigo
```

## Components

### Student workspace

- [Web app](https://github.com/abdenourbouaziz/bac2026/blob/master/index.html): `index.html`
- [Guidance chat](https://github.com/abdenourbouaziz/bac2026/blob/master/js/app.js): `js/app.js`
- [French and Arabic](https://github.com/abdenourbouaziz/bac2026/blob/master/js/app.js): `js/app.js`
- [Chat preferences](https://github.com/abdenourbouaziz/bac2026/blob/master/js/app.js): `js/app.js`
- [Voice input and output](https://github.com/abdenourbouaziz/bac2026/blob/master/js/app.js): `js/app.js`
- [Image studio](https://github.com/abdenourbouaziz/bac2026/blob/master/js/app.js): `js/app.js`
- [Video studio](https://github.com/abdenourbouaziz/bac2026/blob/master/js/app.js): `js/app.js`
- [Document scanner](https://github.com/abdenourbouaziz/bac2026/blob/master/js/app.js): `js/app.js`

### AI and browser services

- **Puter AI**
- **Browser storage**
- **Browser speech**

### Visual experience

- [Visual enhancements](https://github.com/abdenourbouaziz/bac2026/blob/master/js/premium.js): `js/premium.js`
- **GSAP and ScrollTrigger**
- **Confetti library**
- **Lucide icons**

### Other components

- **Student**

## Connections

- Student → Web app: uses
- Guidance chat → Puter AI: requests chat (evidence: `js/app.js`)
- Image studio → Puter AI: generates images (evidence: `js/app.js`)
- Document scanner → Puter AI: analyzes documents (evidence: `js/app.js`)
- Guidance chat → Browser storage: saves history (evidence: `js/app.js`)
- French and Arabic → Browser storage: reads language (evidence: `js/app.js`)
- Voice input and output → Puter AI: requests speech (evidence: `js/app.js`)
- Voice input and output → Browser speech: uses speech synthesis (evidence: `js/app.js`)
- Visual enhancements → GSAP and ScrollTrigger: animates reveals (evidence: `js/premium.js`)
- Visual enhancements → Confetti library: triggers effects (evidence: `js/premium.js`)
- Visual enhancements → Lucide icons: renders icons (evidence: `js/premium.js`)
