# happyejaz786/yagareebnawazcsc architecture

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

- Interactive diagram: https://gitdiagram.com/happyejaz786/yagareebnawazcsc
- Repository: https://github.com/happyejaz786/yagareebnawazcsc

## Overview

This repository is a collection of browser-based products: a CSC services and cart site, two similar KidsZone learning apps, and a Nikahnama form. Users browse services and prepare a cart/receipt, practice subject activities and earn sticker rewards, or enter marriage-form details. The source excerpts establish some internal calls and browser storage, but not the full page-to-script wiring; those connections are omitted rather than inferred.

Main entry points: [`kidszone/HAPPYKIDS/js/app.js`](https://github.com/happyejaz786/yagareebnawazcsc/blob/main/kidszone/HAPPYKIDS/js/app.js) (Session controller), [`kidszone/KIDSZONE/js/app.js`](https://github.com/happyejaz786/yagareebnawazcsc/blob/main/kidszone/KIDSZONE/js/app.js) (Session controller), [`kidszone/HAPPYKIDS/js/rewards.js`](https://github.com/happyejaz786/yagareebnawazcsc/blob/main/kidszone/HAPPYKIDS/js/rewards.js) (Sticker rewards), [`kidszone/KIDSZONE/js/rewards.js`](https://github.com/happyejaz786/yagareebnawazcsc/blob/main/kidszone/KIDSZONE/js/rewards.js) (Sticker rewards)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portal["CSC services portal"]
  node_portal_pages["Services and forms<br/>[services.html]"]
  node_portal_cart["Cart<br/>[cart.html]"]
  node_portal_checkout["Checkout<br/>[checkout.html]"]
  node_portal_header["Header and cart logic<br/>[logic.js]"]
  node_portal_receipt["Receipt and checkout logic<br/>[newlogic.js]"]
  node_cart_store[("Browser cart")]
end

subgraph group_happy["HappyKids learning"]
  node_happy_pages["Learning pages<br/>[index.html]"]
  node_happy_app["Session controller<br/>[app.js]"]
  node_happy_math["Math activities<br/>[maths.js]"]
  node_happy_gk["General knowledge<br/>[gk.js]"]
  node_happy_subjects["Language and science<br/>[english.js]"]
  node_happy_rewards["Sticker rewards<br/>[rewards.js]"]
  node_happy_storage[("Unlocked stickers")]
end

subgraph group_kids["KidsZone learning"]
  node_kids_pages["Learning pages<br/>[index.html]"]
  node_kids_app["Session controller<br/>[app.js]"]
  node_kids_math["Math activities<br/>[maths.js]"]
  node_kids_gk["General knowledge<br/>[gk.js]"]
  node_kids_subjects["Language and science<br/>[english.js]"]
  node_kids_rewards["Sticker rewards<br/>[rewards.js]"]
  node_kids_storage[("Unlocked stickers")]
end

subgraph group_nikah["Nikahnama forms"]
  node_nikah_form["Marriage form<br/>[nikah_index.html]"]
  node_nikah_logic["Form and print logic<br/>[nikah_script.js]"]
  node_hijri["Hijri date conversion<br/>[hijri.js]"]
end

node_visitor(("Visitor"))

node_visitor -->|"browses"| node_portal_pages
node_visitor -->|"opens"| node_happy_pages
node_visitor -->|"opens"| node_kids_pages
node_visitor -->|"fills"| node_nikah_form
node_portal_header -->|"reads and writes"| node_cart_store
node_portal_receipt -->|"reads"| node_cart_store
node_happy_app -->|"initializes"| node_happy_rewards
node_happy_app -->|"shows scratch card"| node_happy_rewards
node_happy_math -->|"awards stars"| node_happy_app
node_happy_math -->|"speaks prompts"| node_happy_app
node_happy_gk -->|"awards stars"| node_happy_app
node_happy_gk -->|"plays audio"| node_happy_app
node_happy_rewards -->|"speaks reward"| node_happy_app
node_happy_rewards -->|"saves unlocks"| node_happy_storage
node_kids_app -->|"initializes"| node_kids_rewards
node_kids_app -->|"shows scratch card"| node_kids_rewards
node_kids_math -->|"awards stars"| node_kids_app
node_kids_math -->|"speaks prompts"| node_kids_app
node_kids_gk -->|"awards stars"| node_kids_app
node_kids_gk -->|"plays audio"| node_kids_app
node_kids_rewards -->|"speaks reward"| node_kids_app
node_kids_rewards -->|"saves unlocks"| node_kids_storage
node_nikah_logic -.->|"converts dates"| node_hijri

click node_portal_pages "https://github.com/happyejaz786/yagareebnawazcsc/blob/main/services.html"
click node_portal_cart "https://github.com/happyejaz786/yagareebnawazcsc/blob/main/cart.html"
click node_portal_checkout "https://github.com/happyejaz786/yagareebnawazcsc/blob/main/checkout.html"
click node_portal_header "https://github.com/happyejaz786/yagareebnawazcsc/blob/main/logic.js"
click node_portal_receipt "https://github.com/happyejaz786/yagareebnawazcsc/blob/main/newlogic.js"
click node_happy_pages "https://github.com/happyejaz786/yagareebnawazcsc/blob/main/kidszone/HAPPYKIDS/index.html"
click node_happy_app "https://github.com/happyejaz786/yagareebnawazcsc/blob/main/kidszone/HAPPYKIDS/js/app.js"
click node_happy_math "https://github.com/happyejaz786/yagareebnawazcsc/blob/main/kidszone/HAPPYKIDS/js/maths.js"
click node_happy_gk "https://github.com/happyejaz786/yagareebnawazcsc/blob/main/kidszone/HAPPYKIDS/js/gk.js"
click node_happy_subjects "https://github.com/happyejaz786/yagareebnawazcsc/blob/main/kidszone/HAPPYKIDS/js/english.js"
click node_happy_rewards "https://github.com/happyejaz786/yagareebnawazcsc/blob/main/kidszone/HAPPYKIDS/js/rewards.js"
click node_kids_pages "https://github.com/happyejaz786/yagareebnawazcsc/blob/main/kidszone/KIDSZONE/index.html"
click node_kids_app "https://github.com/happyejaz786/yagareebnawazcsc/blob/main/kidszone/KIDSZONE/js/app.js"
click node_kids_math "https://github.com/happyejaz786/yagareebnawazcsc/blob/main/kidszone/KIDSZONE/js/maths.js"
click node_kids_gk "https://github.com/happyejaz786/yagareebnawazcsc/blob/main/kidszone/KIDSZONE/js/gk.js"
click node_kids_subjects "https://github.com/happyejaz786/yagareebnawazcsc/blob/main/kidszone/KIDSZONE/js/english.js"
click node_kids_rewards "https://github.com/happyejaz786/yagareebnawazcsc/blob/main/kidszone/KIDSZONE/js/rewards.js"
click node_nikah_form "https://github.com/happyejaz786/yagareebnawazcsc/blob/main/nikahnama/nikah_index.html"
click node_nikah_logic "https://github.com/happyejaz786/yagareebnawazcsc/blob/main/nikahnama/nikah_script.js"
click node_hijri "https://github.com/happyejaz786/yagareebnawazcsc/blob/main/nikahnama/hijri.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_portal_pages,node_portal_cart,node_portal_checkout,node_portal_header,node_portal_receipt,node_cart_store toneBlue
class node_happy_pages,node_happy_app,node_happy_math,node_happy_gk,node_happy_subjects,node_happy_rewards,node_happy_storage toneAmber
class node_kids_pages,node_kids_app,node_kids_math,node_kids_gk,node_kids_subjects,node_kids_rewards,node_kids_storage toneMint
class node_nikah_form,node_nikah_logic,node_hijri toneRose
class node_visitor toneIndigo
```

## Components

### CSC services portal

- [Services and forms](https://github.com/happyejaz786/yagareebnawazcsc/blob/main/services.html): `services.html`
- [Cart](https://github.com/happyejaz786/yagareebnawazcsc/blob/main/cart.html): `cart.html`
- [Checkout](https://github.com/happyejaz786/yagareebnawazcsc/blob/main/checkout.html): `checkout.html`
- [Header and cart logic](https://github.com/happyejaz786/yagareebnawazcsc/blob/main/logic.js): `logic.js`
- [Receipt and checkout logic](https://github.com/happyejaz786/yagareebnawazcsc/blob/main/newlogic.js): `newlogic.js`
- **Browser cart**

### HappyKids learning

- [Learning pages](https://github.com/happyejaz786/yagareebnawazcsc/blob/main/kidszone/HAPPYKIDS/index.html): `kidszone/HAPPYKIDS/index.html`
- [Session controller](https://github.com/happyejaz786/yagareebnawazcsc/blob/main/kidszone/HAPPYKIDS/js/app.js): `kidszone/HAPPYKIDS/js/app.js`
- [Math activities](https://github.com/happyejaz786/yagareebnawazcsc/blob/main/kidszone/HAPPYKIDS/js/maths.js): `kidszone/HAPPYKIDS/js/maths.js`
- [General knowledge](https://github.com/happyejaz786/yagareebnawazcsc/blob/main/kidszone/HAPPYKIDS/js/gk.js): `kidszone/HAPPYKIDS/js/gk.js`
- [Language and science](https://github.com/happyejaz786/yagareebnawazcsc/blob/main/kidszone/HAPPYKIDS/js/english.js): `kidszone/HAPPYKIDS/js/english.js`
- [Sticker rewards](https://github.com/happyejaz786/yagareebnawazcsc/blob/main/kidszone/HAPPYKIDS/js/rewards.js): `kidszone/HAPPYKIDS/js/rewards.js`
- **Unlocked stickers**

### KidsZone learning

- [Learning pages](https://github.com/happyejaz786/yagareebnawazcsc/blob/main/kidszone/KIDSZONE/index.html): `kidszone/KIDSZONE/index.html`
- [Session controller](https://github.com/happyejaz786/yagareebnawazcsc/blob/main/kidszone/KIDSZONE/js/app.js): `kidszone/KIDSZONE/js/app.js`
- [Math activities](https://github.com/happyejaz786/yagareebnawazcsc/blob/main/kidszone/KIDSZONE/js/maths.js): `kidszone/KIDSZONE/js/maths.js`
- [General knowledge](https://github.com/happyejaz786/yagareebnawazcsc/blob/main/kidszone/KIDSZONE/js/gk.js): `kidszone/KIDSZONE/js/gk.js`
- [Language and science](https://github.com/happyejaz786/yagareebnawazcsc/blob/main/kidszone/KIDSZONE/js/english.js): `kidszone/KIDSZONE/js/english.js`
- [Sticker rewards](https://github.com/happyejaz786/yagareebnawazcsc/blob/main/kidszone/KIDSZONE/js/rewards.js): `kidszone/KIDSZONE/js/rewards.js`
- **Unlocked stickers**

### Nikahnama forms

- [Marriage form](https://github.com/happyejaz786/yagareebnawazcsc/blob/main/nikahnama/nikah_index.html): `nikahnama/nikah_index.html`
- [Form and print logic](https://github.com/happyejaz786/yagareebnawazcsc/blob/main/nikahnama/nikah_script.js): `nikahnama/nikah_script.js`
- [Hijri date conversion](https://github.com/happyejaz786/yagareebnawazcsc/blob/main/nikahnama/hijri.js): `nikahnama/hijri.js`

### Other components

- **Visitor**

## Connections

- Visitor → Services and forms: browses
- Visitor → Learning pages: opens
- Visitor → Learning pages: opens
- Visitor → Marriage form: fills
- Header and cart logic → Browser cart: reads and writes (evidence: `logic.js`)
- Receipt and checkout logic → Browser cart: reads (evidence: `newlogic.js`)
- Session controller → Sticker rewards: initializes (evidence: `kidszone/HAPPYKIDS/js/app.js`)
- Session controller → Sticker rewards: shows scratch card (evidence: `kidszone/HAPPYKIDS/js/app.js`)
- Math activities → Session controller: awards stars (evidence: `kidszone/HAPPYKIDS/js/maths.js`)
- Math activities → Session controller: speaks prompts (evidence: `kidszone/HAPPYKIDS/js/maths.js`)
- General knowledge → Session controller: awards stars (evidence: `kidszone/HAPPYKIDS/js/gk.js`)
- General knowledge → Session controller: plays audio (evidence: `kidszone/HAPPYKIDS/js/gk.js`)
- Sticker rewards → Session controller: speaks reward (evidence: `kidszone/HAPPYKIDS/js/rewards.js`)
- Sticker rewards → Unlocked stickers: saves unlocks (evidence: `kidszone/HAPPYKIDS/js/rewards.js`)
- Session controller → Sticker rewards: initializes (evidence: `kidszone/KIDSZONE/js/app.js`)
- Session controller → Sticker rewards: shows scratch card (evidence: `kidszone/KIDSZONE/js/app.js`)
- Math activities → Session controller: awards stars (evidence: `kidszone/KIDSZONE/js/maths.js`)
- Math activities → Session controller: speaks prompts (evidence: `kidszone/KIDSZONE/js/maths.js`)
- General knowledge → Session controller: awards stars (evidence: `kidszone/KIDSZONE/js/gk.js`)
- General knowledge → Session controller: plays audio (evidence: `kidszone/KIDSZONE/js/gk.js`)
- Sticker rewards → Session controller: speaks reward (evidence: `kidszone/KIDSZONE/js/rewards.js`)
- Sticker rewards → Unlocked stickers: saves unlocks (evidence: `kidszone/KIDSZONE/js/rewards.js`)
- Form and print logic → Hijri date conversion: converts dates
