# sbiswas256/vl-shareable architecture

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

- Interactive diagram: https://gitdiagram.com/sbiswas256/vl-shareable
- Repository: https://github.com/sbiswas256/vl-shareable

## Overview

This repository is a static educational-learning site organized around a home page, subject menus, and subject chapter pages, with additional contact/about and admin pages. The apparent learner journey is choosing a subject and opening its chapter content, but the HTML pages were not sampled and the README provides no workflow details, so their links are not asserted. Sampled JavaScript adds configurable embedded chapter cards, browser-local activity logging, and client-side shortcut/context-menu blocking; no backend integration is implemented in the shown tracker.

Main entry points: [`chapters-config.js`](https://github.com/sbiswas256/vl-shareable/blob/VL--Shareable-br1/chapters-config.js) (Embedded card config), [`activity-tracker.js`](https://github.com/sbiswas256/vl-shareable/blob/VL--Shareable-br1/activity-tracker.js) (Activity tracker), [`security-vls.js`](https://github.com/sbiswas256/vl-shareable/blob/VL--Shareable-br1/security-vls.js) (Shortcut protection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_learning["Learning content"]
  node_biology["Biology chapters"]
  node_bengali["Bengali chapter<br/>[BengChapt1.html]"]
  node_english["English chapter<br/>[EngChapt1.html]"]
  node_geography["Geography chapter<br/>[Geo chapt1.html]"]
  node_history["History chapter<br/>[his chapter1.html]"]
  node_math["Math pages<br/>[MathMenu.html]"]
  node_political["Political science pages<br/>[PScMenu.html]"]
  node_chapter_cards["Chapter card renderer<br/>[chapters-config.js]"]
  node_card_config["Embedded card config<br/>[chapters-config.js]"]
end

subgraph group_site["Site pages"]
  node_home["Home page<br/>[index.html]"]
  node_menus["Subject menus"]
  node_about_contact["About and contact<br/>[About Us.html]"]
  node_suggestion["Suggestions<br/>[Suggestion.html]"]
  node_login["Login page<br/>[login.html]"]
  node_admin["Admin panel"]
end

subgraph group_tracking["Activity tracking"]
  node_tracker["Activity tracker"]
  node_local_logs[("Browser log storage")]
end

subgraph group_security["Client security"]
  node_security_guard["Shortcut protection<br/>[security-vls.js]"]
  node_security_flash["Security flash message<br/>[security-vls.js]"]
end

node_learner(("Learner"))

node_card_config -->|"configures"| node_chapter_cards
node_tracker -->|"loads and saves"| node_local_logs
node_security_guard -->|"displays warning"| node_security_flash

click node_home "https://github.com/sbiswas256/vl-shareable/blob/VL--Shareable-br1/index.html"
click node_biology "https://github.com/sbiswas256/vl-shareable/tree/VL--Shareable-br1/Bio%20Chapters"
click node_bengali "https://github.com/sbiswas256/vl-shareable/blob/VL--Shareable-br1/Beng%20Chapters/BengChapt1.html"
click node_english "https://github.com/sbiswas256/vl-shareable/blob/VL--Shareable-br1/Eng%20Chapters/EngChapt1.html"
click node_geography "https://github.com/sbiswas256/vl-shareable/blob/VL--Shareable-br1/Geo%20Chapters/Geo%20chapt1.html"
click node_history "https://github.com/sbiswas256/vl-shareable/blob/VL--Shareable-br1/Hist%20Chapters/his%20chapter1.html"
click node_math "https://github.com/sbiswas256/vl-shareable/blob/VL--Shareable-br1/Math%20Chapters/MathMenu.html"
click node_political "https://github.com/sbiswas256/vl-shareable/blob/VL--Shareable-br1/PSc%20Chapters/PScMenu.html"
click node_chapter_cards "https://github.com/sbiswas256/vl-shareable/blob/VL--Shareable-br1/chapters-config.js"
click node_card_config "https://github.com/sbiswas256/vl-shareable/blob/VL--Shareable-br1/chapters-config.js"
click node_about_contact "https://github.com/sbiswas256/vl-shareable/blob/VL--Shareable-br1/Find%20Us/About%20Us.html"
click node_suggestion "https://github.com/sbiswas256/vl-shareable/blob/VL--Shareable-br1/Find%20Us/Suggestion.html"
click node_login "https://github.com/sbiswas256/vl-shareable/blob/VL--Shareable-br1/Find%20Us/login.html"
click node_admin "https://github.com/sbiswas256/vl-shareable/blob/VL--Shareable-br1/vls-secure-admin-panel.html"
click node_tracker "https://github.com/sbiswas256/vl-shareable/blob/VL--Shareable-br1/activity-tracker.js"
click node_security_guard "https://github.com/sbiswas256/vl-shareable/blob/VL--Shareable-br1/security-vls.js"
click node_security_flash "https://github.com/sbiswas256/vl-shareable/blob/VL--Shareable-br1/security-vls.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_biology,node_bengali,node_english,node_geography,node_history,node_math,node_political,node_chapter_cards,node_card_config toneBlue
class node_home,node_menus,node_about_contact,node_suggestion,node_login,node_admin toneAmber
class node_tracker,node_local_logs toneMint
class node_security_guard,node_security_flash toneRose
class node_learner toneIndigo
```

## Components

### Learning content

- [Biology chapters](https://github.com/sbiswas256/vl-shareable/tree/VL--Shareable-br1/Bio%20Chapters): `Bio Chapters`
- [Bengali chapter](https://github.com/sbiswas256/vl-shareable/blob/VL--Shareable-br1/Beng%20Chapters/BengChapt1.html): `Beng Chapters/BengChapt1.html`
- [English chapter](https://github.com/sbiswas256/vl-shareable/blob/VL--Shareable-br1/Eng%20Chapters/EngChapt1.html): `Eng Chapters/EngChapt1.html`
- [Geography chapter](https://github.com/sbiswas256/vl-shareable/blob/VL--Shareable-br1/Geo%20Chapters/Geo%20chapt1.html): `Geo Chapters/Geo chapt1.html`
- [History chapter](https://github.com/sbiswas256/vl-shareable/blob/VL--Shareable-br1/Hist%20Chapters/his%20chapter1.html): `Hist Chapters/his chapter1.html`
- [Math pages](https://github.com/sbiswas256/vl-shareable/blob/VL--Shareable-br1/Math%20Chapters/MathMenu.html): `Math Chapters/MathMenu.html`
- [Political science pages](https://github.com/sbiswas256/vl-shareable/blob/VL--Shareable-br1/PSc%20Chapters/PScMenu.html): `PSc Chapters/PScMenu.html`
- [Chapter card renderer](https://github.com/sbiswas256/vl-shareable/blob/VL--Shareable-br1/chapters-config.js): `chapters-config.js`
- [Embedded card config](https://github.com/sbiswas256/vl-shareable/blob/VL--Shareable-br1/chapters-config.js): `chapters-config.js`

### Site pages

- [Home page](https://github.com/sbiswas256/vl-shareable/blob/VL--Shareable-br1/index.html): `index.html`
- **Subject menus**
- [About and contact](https://github.com/sbiswas256/vl-shareable/blob/VL--Shareable-br1/Find%20Us/About%20Us.html): `Find Us/About Us.html`
- [Suggestions](https://github.com/sbiswas256/vl-shareable/blob/VL--Shareable-br1/Find%20Us/Suggestion.html): `Find Us/Suggestion.html`
- [Login page](https://github.com/sbiswas256/vl-shareable/blob/VL--Shareable-br1/Find%20Us/login.html): `Find Us/login.html`
- [Admin panel](https://github.com/sbiswas256/vl-shareable/blob/VL--Shareable-br1/vls-secure-admin-panel.html): `vls-secure-admin-panel.html`

### Activity tracking

- [Activity tracker](https://github.com/sbiswas256/vl-shareable/blob/VL--Shareable-br1/activity-tracker.js): `activity-tracker.js`
- **Browser log storage**

### Client security

- [Shortcut protection](https://github.com/sbiswas256/vl-shareable/blob/VL--Shareable-br1/security-vls.js): `security-vls.js`
- [Security flash message](https://github.com/sbiswas256/vl-shareable/blob/VL--Shareable-br1/security-vls.js): `security-vls.js`

### Other components

- **Learner**

## Connections

- Embedded card config → Chapter card renderer: configures (evidence: `chapters-config.js`)
- Activity tracker → Browser log storage: loads and saves (evidence: `activity-tracker.js`)
- Shortcut protection → Security flash message: displays warning (evidence: `security-vls.js`)