# shipransh28aug2016-lab/ifinite-horizon architecture

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

- Interactive diagram: https://gitdiagram.com/shipransh28aug2016-lab/ifinite-horizon
- Repository: https://github.com/shipransh28aug2016-lab/ifinite-horizon

## Overview

Vigyan Atlas is a bilingual CBSE Class IX–X science learning site centered on interactive 3D topic viewers, with 2D diagrams, simulations, guided explorations, and teacher-facing AI tools. The likely learner journey is selecting a science topic, exploring its visual model or activity, and using supporting explanations; the supplied excerpts do not show the site’s navigation wiring, so those user-flow links are left unverified. AI request handling and its curriculum data flow are directly visible. Several product areas are represented by their exact directories because their implementation was not sampled.

Main entry points: [`public`](https://github.com/shipransh28aug2016-lab/ifinite-horizon/tree/main/public) (Science topic viewers), [`api/ai`](https://github.com/shipransh28aug2016-lab/ifinite-horizon/tree/main/api/ai) (AI tool endpoints), [`lib/ai.js`](https://github.com/shipransh28aug2016-lab/ifinite-horizon/blob/main/lib/ai.js) (AI request service), [`index.html`](https://github.com/shipransh28aug2016-lab/ifinite-horizon/blob/main/index.html) (Atlas entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_site["Learning site"]
  node_home["Atlas entry<br/>[index.html]"]
end

subgraph group_visual["Visual learning"]
  node_topic_viewers["Science topic viewers"]
  node_anatomy_assets["Anatomy models"]
  node_two_d["2D diagrams<br/>[va-2d.js]"]
  node_conditions["Condition images<br/>[conditions.js]"]
  node_cell_models["Cell and biology models<br/>[cell-module.js]"]
end

subgraph group_interactive["Interactive activities"]
  node_simulators["Science simulators<br/>[va-simulator.js]"]
  node_mindmaps["Mind maps<br/>[va-mindmap.js]"]
  node_curiosity["Curiosity labs"]
  node_guided["Guided explorations<br/>[guided-module.js]"]
end

subgraph group_teacher["Teacher tools"]
  node_ai_tools["AI tool endpoints"]
  node_ai_service["AI request service<br/>[ai.js]"]
  node_curriculum["AI curriculum<br/>[curriculum.json]"]
  node_supplementary["Supplementary curriculum"]
end

subgraph group_render["Rendering support"]
  node_composer["Effect composer<br/>[EffectComposer.js]"]
  node_shader_pass["Shader pass<br/>[ShaderPass.js]"]
end

node_learner(("Learner or teacher"))
node_gemini["Google Gemini"]
node_rate_limit[("Rate-limit service")]

node_learner -.->|"opens"| node_home
node_home -.->|"selects topic"| node_topic_viewers
node_topic_viewers -.->|"uses models"| node_anatomy_assets
node_topic_viewers -.->|"offers diagrams"| node_two_d
node_topic_viewers -.->|"shows conditions"| node_conditions
node_topic_viewers -.->|"offers simulations"| node_simulators
node_topic_viewers -.->|"offers mind maps"| node_mindmaps
node_topic_viewers -.->|"offers labs"| node_curiosity
node_topic_viewers -.->|"offers guidance"| node_guided
node_topic_viewers -.->|"uses models"| node_cell_models
node_ai_tools -->|"calls"| node_ai_service
node_ai_tools -->|"lists chapters"| node_ai_service
node_ai_service -->|"loads"| node_curriculum
node_ai_service -->|"loads"| node_supplementary
node_ai_tools -->|"requests generation"| node_gemini
node_ai_tools -->|"checks limits"| node_rate_limit
node_composer -->|"creates pass"| node_shader_pass

click node_home "https://github.com/shipransh28aug2016-lab/ifinite-horizon/blob/main/index.html"
click node_topic_viewers "https://github.com/shipransh28aug2016-lab/ifinite-horizon/tree/main/public"
click node_anatomy_assets "https://github.com/shipransh28aug2016-lab/ifinite-horizon/tree/main/assets"
click node_two_d "https://github.com/shipransh28aug2016-lab/ifinite-horizon/blob/main/assets/va-2d.js"
click node_conditions "https://github.com/shipransh28aug2016-lab/ifinite-horizon/blob/main/public/2d/conditions.js"
click node_simulators "https://github.com/shipransh28aug2016-lab/ifinite-horizon/blob/main/assets/va-simulator.js"
click node_mindmaps "https://github.com/shipransh28aug2016-lab/ifinite-horizon/blob/main/assets/va-mindmap.js"
click node_curiosity "https://github.com/shipransh28aug2016-lab/ifinite-horizon/tree/main/assets/curiosity"
click node_guided "https://github.com/shipransh28aug2016-lab/ifinite-horizon/blob/main/tools/guided-module.js"
click node_cell_models "https://github.com/shipransh28aug2016-lab/ifinite-horizon/blob/main/tools/cell-module.js"
click node_ai_tools "https://github.com/shipransh28aug2016-lab/ifinite-horizon/tree/main/api/ai"
click node_ai_service "https://github.com/shipransh28aug2016-lab/ifinite-horizon/blob/main/lib/ai.js"
click node_curriculum "https://github.com/shipransh28aug2016-lab/ifinite-horizon/blob/main/api/ai/curriculum.json"
click node_supplementary "https://github.com/shipransh28aug2016-lab/ifinite-horizon/blob/main/api/ai/supplementary-curriculum.json"
click node_composer "https://github.com/shipransh28aug2016-lab/ifinite-horizon/blob/main/public/lib/EffectComposer.js"
click node_shader_pass "https://github.com/shipransh28aug2016-lab/ifinite-horizon/blob/main/public/lib/ShaderPass.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_home toneBlue
class node_topic_viewers,node_anatomy_assets,node_two_d,node_conditions,node_cell_models,node_rate_limit toneAmber
class node_simulators,node_mindmaps,node_curiosity,node_guided toneMint
class node_ai_tools,node_ai_service,node_curriculum,node_supplementary toneRose
class node_composer,node_shader_pass,node_learner,node_gemini toneIndigo
```

## Components

### Learning site

- [Atlas entry](https://github.com/shipransh28aug2016-lab/ifinite-horizon/blob/main/index.html): `index.html`

### Visual learning

- [Science topic viewers](https://github.com/shipransh28aug2016-lab/ifinite-horizon/tree/main/public): `public`
- [Anatomy models](https://github.com/shipransh28aug2016-lab/ifinite-horizon/tree/main/assets): `assets`
- [2D diagrams](https://github.com/shipransh28aug2016-lab/ifinite-horizon/blob/main/assets/va-2d.js): `assets/va-2d.js`
- [Condition images](https://github.com/shipransh28aug2016-lab/ifinite-horizon/blob/main/public/2d/conditions.js): `public/2d/conditions.js`
- [Cell and biology models](https://github.com/shipransh28aug2016-lab/ifinite-horizon/blob/main/tools/cell-module.js): `tools/cell-module.js`

### Interactive activities

- [Science simulators](https://github.com/shipransh28aug2016-lab/ifinite-horizon/blob/main/assets/va-simulator.js): `assets/va-simulator.js`
- [Mind maps](https://github.com/shipransh28aug2016-lab/ifinite-horizon/blob/main/assets/va-mindmap.js): `assets/va-mindmap.js`
- [Curiosity labs](https://github.com/shipransh28aug2016-lab/ifinite-horizon/tree/main/assets/curiosity): `assets/curiosity`
- [Guided explorations](https://github.com/shipransh28aug2016-lab/ifinite-horizon/blob/main/tools/guided-module.js): `tools/guided-module.js`

### Teacher tools

- [AI tool endpoints](https://github.com/shipransh28aug2016-lab/ifinite-horizon/tree/main/api/ai): `api/ai`
- [AI request service](https://github.com/shipransh28aug2016-lab/ifinite-horizon/blob/main/lib/ai.js): `lib/ai.js`
- [AI curriculum](https://github.com/shipransh28aug2016-lab/ifinite-horizon/blob/main/api/ai/curriculum.json): `api/ai/curriculum.json`
- [Supplementary curriculum](https://github.com/shipransh28aug2016-lab/ifinite-horizon/blob/main/api/ai/supplementary-curriculum.json): `api/ai/supplementary-curriculum.json`

### Rendering support

- [Effect composer](https://github.com/shipransh28aug2016-lab/ifinite-horizon/blob/main/public/lib/EffectComposer.js): `public/lib/EffectComposer.js`
- [Shader pass](https://github.com/shipransh28aug2016-lab/ifinite-horizon/blob/main/public/lib/ShaderPass.js): `public/lib/ShaderPass.js`

### Other components

- **Learner or teacher**
- **Google Gemini**
- **Rate-limit service**

## Connections

- Learner or teacher → Atlas entry: opens
- Atlas entry → Science topic viewers: selects topic
- Science topic viewers → Anatomy models: uses models
- Science topic viewers → 2D diagrams: offers diagrams
- Science topic viewers → Condition images: shows conditions
- Science topic viewers → Science simulators: offers simulations
- Science topic viewers → Mind maps: offers mind maps
- Science topic viewers → Curiosity labs: offers labs
- Science topic viewers → Guided explorations: offers guidance
- Science topic viewers → Cell and biology models: uses models
- AI tool endpoints → AI request service: calls (evidence: `api/ai/generate.js`)
- AI tool endpoints → AI request service: lists chapters (evidence: `api/ai/status.js`)
- AI request service → AI curriculum: loads (evidence: `lib/ai.js`)
- AI request service → Supplementary curriculum: loads (evidence: `lib/ai.js`)
- AI tool endpoints → Google Gemini: requests generation (evidence: `api/ai/generate.js`)
- AI tool endpoints → Rate-limit service: checks limits (evidence: `api/ai/generate.js`)
- Effect composer → Shader pass: creates pass (evidence: `public/lib/EffectComposer.js`)
