# belksihassani/dz-bridge-frontend architecture

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

- Interactive diagram: https://gitdiagram.com/belksihassani/dz-bridge-frontend
- Repository: https://github.com/belksihassani/dz-bridge-frontend

## Overview

DZ-Expertise is a multilingual frontend prototype for connecting Algerian experts and institutions. Its principal workflow is account creation and profile setup, followed by institution project submission and expert discovery or collaboration; public events provide a parallel discovery and contribution path. The tree and excerpts support the screen families and shared browser-side helpers, but not a complete account-to-project runtime trace. Local storage stands in for several documented APIs. The SVG/PDF tools are a separate interface-export utility, included because export_svg.py is a listed core module.

Main entry points: [`tools/svg-export/export_svg.py`](https://github.com/belksihassani/dz-bridge-frontend/blob/main/tools/svg-export/export_svg.py) (SVG export runner), [`expert-dashboard.html`](https://github.com/belksihassani/dz-bridge-frontend/blob/main/expert-dashboard.html) (Expert dashboard), [`org-dashboard.html`](https://github.com/belksihassani/dz-bridge-frontend/blob/main/org-dashboard.html) (Institution dashboard), [`signup.html`](https://github.com/belksihassani/dz-bridge-frontend/blob/main/signup.html) (Account signup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public discovery"]
  node_home["Home and landing<br/>[homepage.html]"]
  node_eventlist["Event listings<br/>[events.html]"]
  node_eventdetail["Event detail<br/>[event.html]"]
  node_eventdata["Event data<br/>[events-data.js]"]
end

subgraph group_accounts["Accounts and profiles"]
  node_login["Login and signup<br/>[login.html]"]
  node_signup["Account signup<br/>[signup.html]"]
  node_expertprofile["Expert setup"]
  node_orgprofile["Institution setup<br/>[org-profile.html]"]
end

subgraph group_collab["Project collaboration"]
  node_expertboard["Expert dashboard"]
  node_orgboard["Institution dashboard<br/>[org-dashboard.html]"]
  node_adminboard["Admin dashboard"]
end

subgraph group_shared["Shared interface"]
  node_branding["Platform branding<br/>[brand.js]"]
  node_help["Contextual help<br/>[help.js]"]
  node_datepicker["Date picker<br/>[datepicker.js]"]
  node_usermenu["User menu<br/>[user-menu.js]"]
end

subgraph group_export["Interface export"]
  node_svgexport["SVG export runner<br/>[export_svg.py]"]
  node_browserdrive["Browser state driver<br/>[drive.js]"]
  node_domconvert["DOM to SVG<br/>[dom2svg.js]"]
  node_pdfexport["PDF bundler<br/>[export_pdf.py]"]
end

node_visitor(("Visitor"))

node_visitor -->|"browses"| node_home
node_visitor -->|"browses"| node_eventlist
node_eventlist -->|"reads events"| node_eventdata
node_eventdetail -->|"reads events"| node_eventdata
node_visitor -->|"authenticates"| node_login
node_visitor -->|"creates account"| node_signup
node_signup -.->|"sets up profile"| node_expertprofile
node_signup -.->|"sets up profile"| node_orgprofile
node_visitor -->|"uses dashboard"| node_expertboard
node_visitor -->|"uses dashboard"| node_orgboard
node_visitor -->|"administers platform"| node_adminboard
node_login -->|"stores session"| node_usermenu
node_usermenu -->|"links dashboard"| node_expertboard
node_usermenu -->|"links dashboard"| node_orgboard
node_adminboard -->|"sets branding"| node_branding
node_branding -.->|"applies branding"| node_home
node_branding -.->|"applies branding"| node_login
node_help -->|"guides workflows"| node_expertboard
node_help -->|"guides workflows"| node_orgboard
node_datepicker -->|"selects dates"| node_expertboard
node_datepicker -->|"selects dates"| node_orgboard
node_svgexport -->|"loads script"| node_browserdrive
node_svgexport -->|"loads script"| node_domconvert
node_svgexport -.->|"provides SVGs"| node_pdfexport
node_pdfexport -->|"imports helpers"| node_svgexport

click node_home "https://github.com/belksihassani/dz-bridge-frontend/blob/main/homepage.html"
click node_eventlist "https://github.com/belksihassani/dz-bridge-frontend/blob/main/events.html"
click node_eventdetail "https://github.com/belksihassani/dz-bridge-frontend/blob/main/event.html"
click node_eventdata "https://github.com/belksihassani/dz-bridge-frontend/blob/main/events-data.js"
click node_login "https://github.com/belksihassani/dz-bridge-frontend/blob/main/login.html"
click node_signup "https://github.com/belksihassani/dz-bridge-frontend/blob/main/signup.html"
click node_expertprofile "https://github.com/belksihassani/dz-bridge-frontend/blob/main/expert-profile.html"
click node_orgprofile "https://github.com/belksihassani/dz-bridge-frontend/blob/main/org-profile.html"
click node_expertboard "https://github.com/belksihassani/dz-bridge-frontend/blob/main/expert-dashboard.html"
click node_orgboard "https://github.com/belksihassani/dz-bridge-frontend/blob/main/org-dashboard.html"
click node_adminboard "https://github.com/belksihassani/dz-bridge-frontend/blob/main/admin-dashboard.html"
click node_branding "https://github.com/belksihassani/dz-bridge-frontend/blob/main/brand.js"
click node_help "https://github.com/belksihassani/dz-bridge-frontend/blob/main/help.js"
click node_datepicker "https://github.com/belksihassani/dz-bridge-frontend/blob/main/datepicker.js"
click node_usermenu "https://github.com/belksihassani/dz-bridge-frontend/blob/main/user-menu.js"
click node_svgexport "https://github.com/belksihassani/dz-bridge-frontend/blob/main/tools/svg-export/export_svg.py"
click node_browserdrive "https://github.com/belksihassani/dz-bridge-frontend/blob/main/tools/svg-export/drive.js"
click node_domconvert "https://github.com/belksihassani/dz-bridge-frontend/blob/main/tools/svg-export/dom2svg.js"
click node_pdfexport "https://github.com/belksihassani/dz-bridge-frontend/blob/main/tools/svg-export/export_pdf.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_home,node_eventlist,node_eventdetail,node_eventdata toneBlue
class node_login,node_signup,node_expertprofile,node_orgprofile toneAmber
class node_expertboard,node_orgboard,node_adminboard toneMint
class node_branding,node_help,node_datepicker,node_usermenu toneRose
class node_svgexport,node_browserdrive,node_domconvert,node_pdfexport,node_visitor toneIndigo
```

## Components

### Public discovery

- [Home and landing](https://github.com/belksihassani/dz-bridge-frontend/blob/main/homepage.html): `homepage.html`
- [Event listings](https://github.com/belksihassani/dz-bridge-frontend/blob/main/events.html): `events.html`
- [Event detail](https://github.com/belksihassani/dz-bridge-frontend/blob/main/event.html): `event.html`
- [Event data](https://github.com/belksihassani/dz-bridge-frontend/blob/main/events-data.js): `events-data.js`

### Accounts and profiles

- [Login and signup](https://github.com/belksihassani/dz-bridge-frontend/blob/main/login.html): `login.html`
- [Account signup](https://github.com/belksihassani/dz-bridge-frontend/blob/main/signup.html): `signup.html`
- [Expert setup](https://github.com/belksihassani/dz-bridge-frontend/blob/main/expert-profile.html): `expert-profile.html`
- [Institution setup](https://github.com/belksihassani/dz-bridge-frontend/blob/main/org-profile.html): `org-profile.html`

### Project collaboration

- [Expert dashboard](https://github.com/belksihassani/dz-bridge-frontend/blob/main/expert-dashboard.html): `expert-dashboard.html`
- [Institution dashboard](https://github.com/belksihassani/dz-bridge-frontend/blob/main/org-dashboard.html): `org-dashboard.html`
- [Admin dashboard](https://github.com/belksihassani/dz-bridge-frontend/blob/main/admin-dashboard.html): `admin-dashboard.html`

### Shared interface

- [Platform branding](https://github.com/belksihassani/dz-bridge-frontend/blob/main/brand.js): `brand.js`
- [Contextual help](https://github.com/belksihassani/dz-bridge-frontend/blob/main/help.js): `help.js`
- [Date picker](https://github.com/belksihassani/dz-bridge-frontend/blob/main/datepicker.js): `datepicker.js`
- [User menu](https://github.com/belksihassani/dz-bridge-frontend/blob/main/user-menu.js): `user-menu.js`

### Interface export

- [SVG export runner](https://github.com/belksihassani/dz-bridge-frontend/blob/main/tools/svg-export/export_svg.py): `tools/svg-export/export_svg.py`
- [Browser state driver](https://github.com/belksihassani/dz-bridge-frontend/blob/main/tools/svg-export/drive.js): `tools/svg-export/drive.js`
- [DOM to SVG](https://github.com/belksihassani/dz-bridge-frontend/blob/main/tools/svg-export/dom2svg.js): `tools/svg-export/dom2svg.js`
- [PDF bundler](https://github.com/belksihassani/dz-bridge-frontend/blob/main/tools/svg-export/export_pdf.py): `tools/svg-export/export_pdf.py`

### Other components

- **Visitor**

## Connections

- Visitor → Home and landing: browses
- Visitor → Event listings: browses
- Event listings → Event data: reads events (evidence: `events-data.js`)
- Event detail → Event data: reads events (evidence: `events-data.js`)
- Visitor → Login and signup: authenticates
- Visitor → Account signup: creates account
- Account signup → Expert setup: sets up profile
- Account signup → Institution setup: sets up profile
- Visitor → Expert dashboard: uses dashboard
- Visitor → Institution dashboard: uses dashboard
- Visitor → Admin dashboard: administers platform
- Login and signup → User menu: stores session (evidence: `user-menu.js`)
- User menu → Expert dashboard: links dashboard (evidence: `user-menu.js`)
- User menu → Institution dashboard: links dashboard (evidence: `user-menu.js`)
- Admin dashboard → Platform branding: sets branding (evidence: `brand.js`)
- Platform branding → Home and landing: applies branding (evidence: `brand.js`)
- Platform branding → Login and signup: applies branding (evidence: `brand.js`)
- Contextual help → Expert dashboard: guides workflows (evidence: `help.js`)
- Contextual help → Institution dashboard: guides workflows (evidence: `help.js`)
- Date picker → Expert dashboard: selects dates (evidence: `datepicker.js`)
- Date picker → Institution dashboard: selects dates (evidence: `datepicker.js`)
- SVG export runner → Browser state driver: loads script (evidence: `tools/svg-export/export_svg.py`)
- SVG export runner → DOM to SVG: loads script (evidence: `tools/svg-export/export_svg.py`)
- SVG export runner → PDF bundler: provides SVGs (evidence: `tools/svg-export/export_pdf.py`)
- PDF bundler → SVG export runner: imports helpers (evidence: `tools/svg-export/export_pdf.py`)
