# maryam843/oryxeye architecture

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

- Interactive diagram: https://gitdiagram.com/maryam843/oryxeye
- Repository: https://github.com/maryam843/oryxeye

## Overview

OryxEye is a nature-learning app for children: users identify uploaded plant or animal photos, learn through an AI guide and quizzes, and track discoveries alongside daily challenges and a clue-based guessing game. The React app routes these experiences to a Node API; documented backend capabilities include account handling, progress, NLP guess checking, and AI-generated learning content. The README describes a separate Flask classifier and MongoDB Atlas. Backend internals were not excerpted, so the graph keeps them at documented subsystem level and limits uncertain wiring.

Main entry points: [`frontend/src/App.js`](https://github.com/maryam843/oryxeye/blob/master/frontend/src/App.js) (App shell), [`server/server.js`](https://github.com/maryam843/oryxeye/blob/master/server/server.js) (Node API), [`frontend/src/pages/DiscoverPage.jsx`](https://github.com/maryam843/oryxeye/blob/master/frontend/src/pages/DiscoverPage.jsx) (Photo discovery), [`frontend/src/pages/DailyPage.jsx`](https://github.com/maryam843/oryxeye/blob/master/frontend/src/pages/DailyPage.jsx) (Daily challenge)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Learning app"]
  node_app["App shell<br/>[App.js]"]
  node_navigation["Feature navigation<br/>[BottomNav.jsx]"]
  node_landing["Landing and signup<br/>[LandingPage.jsx]"]
  node_discover["Photo discovery<br/>[DiscoverPage.jsx]"]
  node_quiz["Interactive quiz<br/>[QuizSection.jsx]"]
  node_chat["Nature chatbot<br/>[ChatbotPage.jsx]"]
  node_daily["Daily challenge<br/>[DailyPage.jsx]"]
  node_guess["Guessing game<br/>[GuessPage.jsx]"]
  node_journal["Discovery journal<br/>[JournalPage.jsx]"]
  node_dashboard["Progress dashboard<br/>[DashboardPage.jsx]"]
  node_notifications["Toast notifications<br/>[Toast.jsx]"]
end

subgraph group_backend["Application services"]
  node_api["Node API<br/>[server.js]"]
  node_accounts["Accounts and sessions<br/>[server.js]"]
  node_learning["AI learning content<br/>[server.js]"]
  node_guesslogic["Guess NLP checker<br/>[server.js]"]
  node_progress["Progress tracking<br/>[server.js]"]
end

subgraph group_ml["Image identification"]
  node_classifier["Flask image classifier<br/>[app.py]"]
  node_models["Plant and animal models"]
end

subgraph group_external["External services"]
  node_database[("MongoDB Atlas")]
  node_groq["Groq AI"]
  node_naturedata["iNaturalist and Wikipedia"]
end

node_child(("Young explorer"))

node_child -->|"starts exploring"| node_landing
node_app -->|"renders"| node_landing
node_app -->|"renders"| node_navigation
node_app -->|"routes to"| node_discover
node_app -->|"routes to"| node_chat
node_app -->|"routes to"| node_daily
node_app -->|"routes to"| node_guess
node_app -->|"routes to"| node_journal
node_app -->|"routes to"| node_dashboard
node_app -->|"renders"| node_notifications
node_discover -->|"requests classification"| node_api
node_discover -->|"requests quiz"| node_api
node_discover -->|"renders"| node_quiz
node_daily -->|"loads challenge"| node_api
node_daily -->|"fetches species images"| node_naturedata
node_daily -->|"renders"| node_quiz
node_guess -->|"requests game and checks"| node_api
node_chat -->|"sends questions"| node_api
node_app -->|"submits login and signup"| node_accounts
node_app -->|"loads progress and saves results"| node_api
node_api -->|"forwards image classification"| node_classifier
node_classifier -->|"runs models"| node_models
node_api -->|"requests AI content"| node_groq
node_api -->|"stores user progress"| node_database
node_api -->|"handles account endpoints"| node_accounts
node_api -->|"handles learning endpoints"| node_learning
node_api -->|"checks guesses"| node_guesslogic
node_api -->|"tracks results"| node_progress
node_progress -->|"persists progress"| node_database
node_app -->|"loads and saves results"| node_progress

click node_app "https://github.com/maryam843/oryxeye/blob/master/frontend/src/App.js"
click node_navigation "https://github.com/maryam843/oryxeye/blob/master/frontend/src/components/BottomNav.jsx"
click node_landing "https://github.com/maryam843/oryxeye/blob/master/frontend/src/pages/LandingPage.jsx"
click node_discover "https://github.com/maryam843/oryxeye/blob/master/frontend/src/pages/DiscoverPage.jsx"
click node_quiz "https://github.com/maryam843/oryxeye/blob/master/frontend/src/components/QuizSection.jsx"
click node_chat "https://github.com/maryam843/oryxeye/blob/master/frontend/src/pages/ChatbotPage.jsx"
click node_daily "https://github.com/maryam843/oryxeye/blob/master/frontend/src/pages/DailyPage.jsx"
click node_guess "https://github.com/maryam843/oryxeye/blob/master/frontend/src/pages/GuessPage.jsx"
click node_journal "https://github.com/maryam843/oryxeye/blob/master/frontend/src/pages/JournalPage.jsx"
click node_dashboard "https://github.com/maryam843/oryxeye/blob/master/frontend/src/pages/DashboardPage.jsx"
click node_notifications "https://github.com/maryam843/oryxeye/blob/master/frontend/src/components/Toast.jsx"
click node_api "https://github.com/maryam843/oryxeye/blob/master/server/server.js"
click node_accounts "https://github.com/maryam843/oryxeye/blob/master/server/server.js"
click node_learning "https://github.com/maryam843/oryxeye/blob/master/server/server.js"
click node_guesslogic "https://github.com/maryam843/oryxeye/blob/master/server/server.js"
click node_progress "https://github.com/maryam843/oryxeye/blob/master/server/server.js"
click node_classifier "https://github.com/maryam843/oryxeye/blob/master/CNN/app.py"
click node_models "https://github.com/maryam843/oryxeye/tree/master/CNN"

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_landing,node_discover,node_quiz,node_chat,node_daily,node_guess,node_journal,node_dashboard,node_notifications toneBlue
class node_api,node_accounts,node_learning,node_guesslogic,node_progress toneAmber
class node_classifier,node_models toneMint
class node_database,node_groq,node_naturedata toneRose
class node_child toneIndigo
```

## Components

### Learning app

- [App shell](https://github.com/maryam843/oryxeye/blob/master/frontend/src/App.js): `frontend/src/App.js`
- [Feature navigation](https://github.com/maryam843/oryxeye/blob/master/frontend/src/components/BottomNav.jsx): `frontend/src/components/BottomNav.jsx`
- [Landing and signup](https://github.com/maryam843/oryxeye/blob/master/frontend/src/pages/LandingPage.jsx): `frontend/src/pages/LandingPage.jsx`
- [Photo discovery](https://github.com/maryam843/oryxeye/blob/master/frontend/src/pages/DiscoverPage.jsx): `frontend/src/pages/DiscoverPage.jsx`
- [Interactive quiz](https://github.com/maryam843/oryxeye/blob/master/frontend/src/components/QuizSection.jsx): `frontend/src/components/QuizSection.jsx`
- [Nature chatbot](https://github.com/maryam843/oryxeye/blob/master/frontend/src/pages/ChatbotPage.jsx): `frontend/src/pages/ChatbotPage.jsx`
- [Daily challenge](https://github.com/maryam843/oryxeye/blob/master/frontend/src/pages/DailyPage.jsx): `frontend/src/pages/DailyPage.jsx`
- [Guessing game](https://github.com/maryam843/oryxeye/blob/master/frontend/src/pages/GuessPage.jsx): `frontend/src/pages/GuessPage.jsx`
- [Discovery journal](https://github.com/maryam843/oryxeye/blob/master/frontend/src/pages/JournalPage.jsx): `frontend/src/pages/JournalPage.jsx`
- [Progress dashboard](https://github.com/maryam843/oryxeye/blob/master/frontend/src/pages/DashboardPage.jsx): `frontend/src/pages/DashboardPage.jsx`
- [Toast notifications](https://github.com/maryam843/oryxeye/blob/master/frontend/src/components/Toast.jsx): `frontend/src/components/Toast.jsx`

### Application services

- [Node API](https://github.com/maryam843/oryxeye/blob/master/server/server.js): `server/server.js`
- [Accounts and sessions](https://github.com/maryam843/oryxeye/blob/master/server/server.js): `server/server.js`
- [AI learning content](https://github.com/maryam843/oryxeye/blob/master/server/server.js): `server/server.js`
- [Guess NLP checker](https://github.com/maryam843/oryxeye/blob/master/server/server.js): `server/server.js`
- [Progress tracking](https://github.com/maryam843/oryxeye/blob/master/server/server.js): `server/server.js`

### Image identification

- [Flask image classifier](https://github.com/maryam843/oryxeye/blob/master/CNN/app.py): `CNN/app.py`
- [Plant and animal models](https://github.com/maryam843/oryxeye/tree/master/CNN): `CNN`

### External services

- **MongoDB Atlas**
- **Groq AI**
- **iNaturalist and Wikipedia**

### Other components

- **Young explorer**

## Connections

- Young explorer → Landing and signup: starts exploring (evidence: `frontend/src/pages/LandingPage.jsx`)
- App shell → Landing and signup: renders (evidence: `frontend/src/App.js`)
- App shell → Feature navigation: renders (evidence: `frontend/src/App.js`)
- App shell → Photo discovery: routes to (evidence: `frontend/src/App.js`)
- App shell → Nature chatbot: routes to (evidence: `frontend/src/App.js`)
- App shell → Daily challenge: routes to (evidence: `frontend/src/App.js`)
- App shell → Guessing game: routes to (evidence: `frontend/src/App.js`)
- App shell → Discovery journal: routes to (evidence: `frontend/src/App.js`)
- App shell → Progress dashboard: routes to (evidence: `frontend/src/App.js`)
- App shell → Toast notifications: renders (evidence: `frontend/src/App.js`)
- Photo discovery → Node API: requests classification (evidence: `frontend/src/pages/DiscoverPage.jsx`)
- Photo discovery → Node API: requests quiz (evidence: `frontend/src/pages/DiscoverPage.jsx`)
- Photo discovery → Interactive quiz: renders (evidence: `frontend/src/pages/DiscoverPage.jsx`)
- Daily challenge → Node API: loads challenge (evidence: `README.md`)
- Daily challenge → iNaturalist and Wikipedia: fetches species images (evidence: `frontend/src/pages/DailyPage.jsx`)
- Daily challenge → Interactive quiz: renders (evidence: `frontend/src/pages/DailyPage.jsx`)
- Guessing game → Node API: requests game and checks (evidence: `frontend/src/pages/GuessPage.jsx`)
- Nature chatbot → Node API: sends questions (evidence: `README.md`)
- App shell → Accounts and sessions: submits login and signup (evidence: `frontend/src/App.js`)
- App shell → Node API: loads progress and saves results (evidence: `frontend/src/App.js`)
- Node API → Flask image classifier: forwards image classification (evidence: `README.md`)
- Flask image classifier → Plant and animal models: runs models (evidence: `README.md`)
- Node API → Groq AI: requests AI content (evidence: `README.md`)
- Node API → MongoDB Atlas: stores user progress (evidence: `README.md`)
- Node API → Accounts and sessions: handles account endpoints (evidence: `README.md`)
- Node API → AI learning content: handles learning endpoints (evidence: `README.md`)
- Node API → Guess NLP checker: checks guesses (evidence: `README.md`)
- Node API → Progress tracking: tracks results (evidence: `README.md`)
- Progress tracking → MongoDB Atlas: persists progress (evidence: `README.md`)
- App shell → Progress tracking: loads and saves results (evidence: `frontend/src/App.js`)
