# erma0x/cellule-scienze architecture

> Architecture diagram of the GitHub repository erma0x/cellule-scienze, 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/erma0x/cellule-scienze
- Repository: https://github.com/erma0x/cellule-scienze

## Overview

CellExplorer is an educational cell-biology application centered on exploring animal and plant cells in 3D, selecting organelles for details, comparing cell types, and taking quizzes. Quiz results can be submitted to and retrieved from a FastAPI backend backed by MongoDB. The sampled code confirms how 3D cell components use shared organelle renderers and how the backend persists quiz results. The page-level wiring is not shown in the supplied excerpts, so those links are marked unverified rather than presented as observed calls.

Main entry points: [`frontend/src/App.js`](https://github.com/erma0x/cellule-scienze/blob/main/frontend/src/App.js) (Application shell), [`frontend/src/components/CellViewer.jsx`](https://github.com/erma0x/cellule-scienze/blob/main/frontend/src/components/CellViewer.jsx) (Cell viewer), [`frontend/src/components/QuizPage.jsx`](https://github.com/erma0x/cellule-scienze/blob/main/frontend/src/components/QuizPage.jsx) (Quiz), [`frontend/src/components/cells/AnimalCell3D.jsx`](https://github.com/erma0x/cellule-scienze/blob/main/frontend/src/components/cells/AnimalCell3D.jsx) (Animal cell model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Learning experience"]
  node_app["Application shell<br/>[App.js]"]
  node_navigation["Navigation<br/>[Navigation.jsx]"]
  node_cell_viewer["Cell viewer<br/>[CellViewer.jsx]"]
  node_organelle_panel["Organelle panel<br/>[OrganellePanel.jsx]"]
  node_comparison["Cell comparison<br/>[ComparisonPage.jsx]"]
  node_quiz["Quiz<br/>[QuizPage.jsx]"]
end

subgraph group_visualization["3D cell models"]
  node_animal_cell["Animal cell model<br/>[AnimalCell3D.jsx]"]
  node_plant_cell["Plant cell model<br/>[PlantCell3D.jsx]"]
  node_organelle_mesh["Organelle renderer<br/>[OrganelleMesh.jsx]"]
  node_mitochondrion["Mitochondrion renderer<br/>[Mitochondrion.jsx]"]
end

subgraph group_content["Learning content"]
  node_organelle_content["Organelle content<br/>[organelles.js]"]
  node_comparison_content["Comparison content<br/>[comparisonData.js]"]
  node_quiz_content["Quiz questions<br/>[quizData.js]"]
end

subgraph group_results["Quiz results"]
  node_quiz_api["Quiz results API<br/>[server.py]"]
  node_mongo[("MongoDB")]
end

node_learner(("Learner"))

node_learner -.->|"uses"| node_app
node_app -.->|"renders"| node_navigation
node_app -.->|"renders"| node_cell_viewer
node_app -.->|"renders"| node_comparison
node_app -.->|"renders"| node_quiz
node_cell_viewer -.->|"selects model"| node_animal_cell
node_cell_viewer -.->|"selects model"| node_plant_cell
node_cell_viewer -.->|"shows selection"| node_organelle_panel
node_comparison -.->|"uses content"| node_comparison_content
node_quiz -.->|"uses questions"| node_quiz_content
node_quiz -.->|"submits results"| node_quiz_api
node_animal_cell -->|"renders"| node_organelle_mesh
node_animal_cell -->|"renders"| node_mitochondrion
node_plant_cell -->|"renders"| node_organelle_mesh
node_plant_cell -->|"renders"| node_mitochondrion
node_quiz_api -->|"writes results"| node_mongo
node_quiz_api -->|"reads results"| node_mongo

click node_app "https://github.com/erma0x/cellule-scienze/blob/main/frontend/src/App.js"
click node_navigation "https://github.com/erma0x/cellule-scienze/blob/main/frontend/src/components/Navigation.jsx"
click node_cell_viewer "https://github.com/erma0x/cellule-scienze/blob/main/frontend/src/components/CellViewer.jsx"
click node_organelle_panel "https://github.com/erma0x/cellule-scienze/blob/main/frontend/src/components/OrganellePanel.jsx"
click node_comparison "https://github.com/erma0x/cellule-scienze/blob/main/frontend/src/components/ComparisonPage.jsx"
click node_quiz "https://github.com/erma0x/cellule-scienze/blob/main/frontend/src/components/QuizPage.jsx"
click node_animal_cell "https://github.com/erma0x/cellule-scienze/blob/main/frontend/src/components/cells/AnimalCell3D.jsx"
click node_plant_cell "https://github.com/erma0x/cellule-scienze/blob/main/frontend/src/components/cells/PlantCell3D.jsx"
click node_organelle_mesh "https://github.com/erma0x/cellule-scienze/blob/main/frontend/src/components/cells/OrganelleMesh.jsx"
click node_mitochondrion "https://github.com/erma0x/cellule-scienze/blob/main/frontend/src/components/cells/Mitochondrion.jsx"
click node_organelle_content "https://github.com/erma0x/cellule-scienze/blob/main/frontend/src/data/organelles.js"
click node_comparison_content "https://github.com/erma0x/cellule-scienze/blob/main/frontend/src/data/comparisonData.js"
click node_quiz_content "https://github.com/erma0x/cellule-scienze/blob/main/frontend/src/data/quizData.js"
click node_quiz_api "https://github.com/erma0x/cellule-scienze/blob/main/backend/server.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_app,node_navigation,node_cell_viewer,node_organelle_panel,node_comparison,node_quiz toneBlue
class node_animal_cell,node_plant_cell,node_organelle_mesh,node_mitochondrion toneAmber
class node_organelle_content,node_comparison_content,node_quiz_content toneMint
class node_quiz_api,node_mongo toneRose
class node_learner toneIndigo
```

## Components

### Learning experience

- [Application shell](https://github.com/erma0x/cellule-scienze/blob/main/frontend/src/App.js): `frontend/src/App.js`
- [Navigation](https://github.com/erma0x/cellule-scienze/blob/main/frontend/src/components/Navigation.jsx): `frontend/src/components/Navigation.jsx`
- [Cell viewer](https://github.com/erma0x/cellule-scienze/blob/main/frontend/src/components/CellViewer.jsx): `frontend/src/components/CellViewer.jsx`
- [Organelle panel](https://github.com/erma0x/cellule-scienze/blob/main/frontend/src/components/OrganellePanel.jsx): `frontend/src/components/OrganellePanel.jsx`
- [Cell comparison](https://github.com/erma0x/cellule-scienze/blob/main/frontend/src/components/ComparisonPage.jsx): `frontend/src/components/ComparisonPage.jsx`
- [Quiz](https://github.com/erma0x/cellule-scienze/blob/main/frontend/src/components/QuizPage.jsx): `frontend/src/components/QuizPage.jsx`

### 3D cell models

- [Animal cell model](https://github.com/erma0x/cellule-scienze/blob/main/frontend/src/components/cells/AnimalCell3D.jsx): `frontend/src/components/cells/AnimalCell3D.jsx`
- [Plant cell model](https://github.com/erma0x/cellule-scienze/blob/main/frontend/src/components/cells/PlantCell3D.jsx): `frontend/src/components/cells/PlantCell3D.jsx`
- [Organelle renderer](https://github.com/erma0x/cellule-scienze/blob/main/frontend/src/components/cells/OrganelleMesh.jsx): `frontend/src/components/cells/OrganelleMesh.jsx`
- [Mitochondrion renderer](https://github.com/erma0x/cellule-scienze/blob/main/frontend/src/components/cells/Mitochondrion.jsx): `frontend/src/components/cells/Mitochondrion.jsx`

### Learning content

- [Organelle content](https://github.com/erma0x/cellule-scienze/blob/main/frontend/src/data/organelles.js): `frontend/src/data/organelles.js`
- [Comparison content](https://github.com/erma0x/cellule-scienze/blob/main/frontend/src/data/comparisonData.js): `frontend/src/data/comparisonData.js`
- [Quiz questions](https://github.com/erma0x/cellule-scienze/blob/main/frontend/src/data/quizData.js): `frontend/src/data/quizData.js`

### Quiz results

- [Quiz results API](https://github.com/erma0x/cellule-scienze/blob/main/backend/server.py): `backend/server.py`
- **MongoDB**

### Other components

- **Learner**

## Connections

- Learner → Application shell: uses
- Application shell → Navigation: renders
- Application shell → Cell viewer: renders
- Application shell → Cell comparison: renders
- Application shell → Quiz: renders
- Cell viewer → Animal cell model: selects model
- Cell viewer → Plant cell model: selects model
- Cell viewer → Organelle panel: shows selection
- Cell comparison → Comparison content: uses content
- Quiz → Quiz questions: uses questions
- Quiz → Quiz results API: submits results
- Animal cell model → Organelle renderer: renders (evidence: `frontend/src/components/cells/AnimalCell3D.jsx`)
- Animal cell model → Mitochondrion renderer: renders (evidence: `frontend/src/components/cells/AnimalCell3D.jsx`)
- Plant cell model → Organelle renderer: renders (evidence: `frontend/src/components/cells/PlantCell3D.jsx`)
- Plant cell model → Mitochondrion renderer: renders (evidence: `frontend/src/components/cells/PlantCell3D.jsx`)
- Quiz results API → MongoDB: writes results (evidence: `backend/server.py`)
- Quiz results API → MongoDB: reads results (evidence: `backend/server.py`)
