# et1992s/eusebiu-tamas-personal-portfolio architecture

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

- Interactive diagram: https://gitdiagram.com/et1992s/eusebiu-tamas-personal-portfolio
- Repository: https://github.com/et1992s/eusebiu-tamas-personal-portfolio

## Overview

Zebio Studio combines a portfolio and project frontend with a FastAPI backend for AI assistance, trading, and Underground route analytics. Users navigate to a project, interact with its page, and receive results through backend APIs or live connections. Trading spans historical/live market data, ML inference, paper trading, and backtesting; transit provides route/network analysis. The graph preserves these documented backend capabilities and sampled frontend flows. Several backend routes and subsystems are unsampled, so their internal call links are omitted; paths for those features use exact directories from the tree.

Main entry points: [`backend/app/main.py`](https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/backend/app/main.py) (Backend application), [`frontend/src/App.jsx`](https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/frontend/src/App.jsx) (Application routes), [`frontend/src/pages/TradingProjectPage.jsx`](https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/frontend/src/pages/TradingProjectPage.jsx) (Trading workspace), [`backend/app/api/ai.py`](https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/backend/app/api/ai.py) (AI API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_app["Application routes<br/>[App.jsx]"]
  node_trading_page["Trading workspace"]
  node_ai_chat["AI chat<br/>[AIChat.jsx]"]
  node_zebio_page["Zebio workspace<br/>[ZebioPage.jsx]"]
  node_tube_page["Tube project"]
  node_api_client["API client<br/>[api.js]"]
  node_market_hooks["Trading data hooks<br/>[useTradingData.js]"]
  node_live_chart_hook["Live chart hook"]
  node_live_prediction_hook["Live prediction hook"]
  node_chart["Candlestick chart"]
end

subgraph group_ai["AI assistant"]
  node_ai_service["AI API<br/>[ai.py]"]
  node_ai_agent["AI agent<br/>[agent.py]"]
  node_ai_memory["AI memory<br/>[memory.py]"]
  node_ai_retrieval["Memory retrieval<br/>[retrieval.py]"]
  node_ai_tasks["Task manager<br/>[task_manager.py]"]
  node_ai_prompts["Prompt library<br/>[prompts.py]"]
end

subgraph group_trading["Trading"]
  node_market_api["Trading API<br/>[trading.py]"]
  node_market_data["Market data<br/>[market_data.py]"]
  node_market_store[("Market store<br/>[market_store.py]")]
  node_market_provider["Market provider<br/>[provider.py]"]
  node_chart_service["Chart service<br/>[chart.py]"]
  node_live_stream["Live streams<br/>[stream.py]"]
  node_live_prediction["Live prediction<br/>[prediction.py]"]
  node_feature_engineering["Feature engineering"]
  node_inference["ML inference<br/>[inference.py]"]
  node_simulation["Backtesting engine<br/>[engine.py]"]
  node_paper_trading["Paper trading"]
end

subgraph group_transit["Transit"]
  node_tube_api["Transit API<br/>[tube.py]"]
  node_tube_graph["Route algorithms"]
end

subgraph group_contact["Contact"]
  node_contact_api["Contact API<br/>[contact.py]"]
  node_contact_service["Contact delivery<br/>[service.py]"]
  node_contact_model["Contact request<br/>[models.py]"]
end

node_visitor(("Visitor"))
node_backend_entry["Backend application<br/>[main.py]"]

node_visitor -->|"opens"| node_app
node_app -->|"routes to"| node_trading_page
node_app -->|"routes to"| node_ai_chat
node_app -->|"routes to"| node_zebio_page
node_app -->|"routes to"| node_tube_page
node_trading_page -->|"loads data via"| node_market_hooks
node_trading_page -->|"loads live chart"| node_live_chart_hook
node_trading_page -->|"loads live prediction"| node_live_prediction_hook
node_trading_page -->|"renders"| node_chart
node_market_hooks -->|"requests bars"| node_api_client
node_live_chart_hook -.->|"requests chart data"| node_chart_service
node_live_chart_hook -.->|"subscribes"| node_live_stream
node_live_prediction_hook -.->|"subscribes"| node_live_stream
node_ai_chat -.->|"sends chat"| node_ai_service
node_backend_entry -->|"registers"| node_ai_service
node_backend_entry -->|"registers"| node_contact_api
node_contact_api -->|"delegates to"| node_contact_service
node_contact_service -->|"accepts"| node_contact_model
node_ai_service -->|"invokes"| node_ai_agent
node_ai_service -->|"uses"| node_ai_memory
node_ai_service -->|"uses"| node_ai_prompts
node_ai_agent -.->|"retrieves context"| node_ai_retrieval
node_ai_tasks -.->|"coordinates"| node_ai_agent
node_backend_entry -.->|"registers"| node_market_api
node_market_api -.->|"requests data"| node_market_data
node_market_data -->|"reads and writes"| node_market_store
node_market_data -->|"fetches data"| node_market_provider
node_chart_service -->|"gets market data"| node_market_data
node_live_prediction -->|"fetches data"| node_market_provider
node_live_prediction -->|"runs inference"| node_inference
node_inference -->|"prepares features"| node_feature_engineering
node_backend_entry -->|"runs backtest"| node_simulation
node_backend_entry -->|"registers"| node_paper_trading
node_backend_entry -.->|"registers"| node_tube_api
node_tube_api -.->|"routes and analyzes"| node_tube_graph

click node_app "https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/frontend/src/App.jsx"
click node_trading_page "https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/frontend/src/pages/TradingProjectPage.jsx"
click node_ai_chat "https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/frontend/src/components/AI/AIChat.jsx"
click node_zebio_page "https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/frontend/src/pages/ZebioPage.jsx"
click node_tube_page "https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/frontend/src/pages/TubeProjectPage.jsx"
click node_api_client "https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/frontend/src/services/api.js"
click node_market_hooks "https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/frontend/src/hooks/useTradingData.js"
click node_live_chart_hook "https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/frontend/src/hooks/useLiveTradingChart.js"
click node_live_prediction_hook "https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/frontend/src/hooks/useLiveTradingPrediction.js"
click node_chart "https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/frontend/src/components/Chart/CandlestickChart.jsx"
click node_ai_service "https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/backend/app/api/ai.py"
click node_ai_agent "https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/backend/app/ai/agent.py"
click node_ai_memory "https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/backend/app/ai/memory.py"
click node_ai_retrieval "https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/backend/app/ai/retrieval.py"
click node_ai_tasks "https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/backend/app/ai/task_manager.py"
click node_ai_prompts "https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/backend/app/ai/prompts.py"
click node_market_api "https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/backend/app/api/trading.py"
click node_market_data "https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/backend/app/services/trading/live/market_data.py"
click node_market_store "https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/backend/app/services/trading/live/market_store.py"
click node_market_provider "https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/backend/app/services/trading/live/provider.py"
click node_chart_service "https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/backend/app/services/trading/live/chart.py"
click node_live_stream "https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/backend/app/services/trading/live/stream.py"
click node_live_prediction "https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/backend/app/services/trading/live/prediction.py"
click node_feature_engineering "https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/backend/app/services/trading/ml/feature_engineering.py"
click node_inference "https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/backend/app/services/trading/ml/inference.py"
click node_simulation "https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/backend/app/services/trading/simulation/engine.py"
click node_paper_trading "https://github.com/et1992s/eusebiu-tamas-personal-portfolio/tree/master/backend/app/services/trading/paper"
click node_tube_api "https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/backend/app/api/tube.py"
click node_tube_graph "https://github.com/et1992s/eusebiu-tamas-personal-portfolio/tree/master/backend/app/services/tube"
click node_contact_api "https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/backend/app/api/contact.py"
click node_contact_service "https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/backend/app/services/contact/service.py"
click node_contact_model "https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/backend/app/services/contact/models.py"
click node_backend_entry "https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/backend/app/main.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_trading_page,node_ai_chat,node_zebio_page,node_tube_page,node_api_client,node_market_hooks,node_live_chart_hook,node_live_prediction_hook,node_chart toneBlue
class node_ai_service,node_ai_agent,node_ai_memory,node_ai_retrieval,node_ai_tasks,node_ai_prompts toneAmber
class node_market_api,node_market_data,node_market_store,node_market_provider,node_chart_service,node_live_stream,node_live_prediction,node_feature_engineering,node_inference,node_simulation,node_paper_trading toneMint
class node_tube_api,node_tube_graph toneRose
class node_contact_api,node_contact_service,node_contact_model,node_visitor toneIndigo
class node_backend_entry toneTeal
```

## Components

### Web experience

- [Application routes](https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Trading workspace](https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/frontend/src/pages/TradingProjectPage.jsx): `frontend/src/pages/TradingProjectPage.jsx`
- [AI chat](https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/frontend/src/components/AI/AIChat.jsx): `frontend/src/components/AI/AIChat.jsx`
- [Zebio workspace](https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/frontend/src/pages/ZebioPage.jsx): `frontend/src/pages/ZebioPage.jsx`
- [Tube project](https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/frontend/src/pages/TubeProjectPage.jsx): `frontend/src/pages/TubeProjectPage.jsx`
- [API client](https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/frontend/src/services/api.js): `frontend/src/services/api.js`
- [Trading data hooks](https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/frontend/src/hooks/useTradingData.js): `frontend/src/hooks/useTradingData.js`
- [Live chart hook](https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/frontend/src/hooks/useLiveTradingChart.js): `frontend/src/hooks/useLiveTradingChart.js`
- [Live prediction hook](https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/frontend/src/hooks/useLiveTradingPrediction.js): `frontend/src/hooks/useLiveTradingPrediction.js`
- [Candlestick chart](https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/frontend/src/components/Chart/CandlestickChart.jsx): `frontend/src/components/Chart/CandlestickChart.jsx`

### AI assistant

- [AI API](https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/backend/app/api/ai.py): `backend/app/api/ai.py`
- [AI agent](https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/backend/app/ai/agent.py): `backend/app/ai/agent.py`
- [AI memory](https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/backend/app/ai/memory.py): `backend/app/ai/memory.py`
- [Memory retrieval](https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/backend/app/ai/retrieval.py): `backend/app/ai/retrieval.py`
- [Task manager](https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/backend/app/ai/task_manager.py): `backend/app/ai/task_manager.py`
- [Prompt library](https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/backend/app/ai/prompts.py): `backend/app/ai/prompts.py`

### Trading

- [Trading API](https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/backend/app/api/trading.py): `backend/app/api/trading.py`
- [Market data](https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/backend/app/services/trading/live/market_data.py): `backend/app/services/trading/live/market_data.py`
- [Market store](https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/backend/app/services/trading/live/market_store.py): `backend/app/services/trading/live/market_store.py`
- [Market provider](https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/backend/app/services/trading/live/provider.py): `backend/app/services/trading/live/provider.py`
- [Chart service](https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/backend/app/services/trading/live/chart.py): `backend/app/services/trading/live/chart.py`
- [Live streams](https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/backend/app/services/trading/live/stream.py): `backend/app/services/trading/live/stream.py`
- [Live prediction](https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/backend/app/services/trading/live/prediction.py): `backend/app/services/trading/live/prediction.py`
- [Feature engineering](https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/backend/app/services/trading/ml/feature_engineering.py): `backend/app/services/trading/ml/feature_engineering.py`
- [ML inference](https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/backend/app/services/trading/ml/inference.py): `backend/app/services/trading/ml/inference.py`
- [Backtesting engine](https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/backend/app/services/trading/simulation/engine.py): `backend/app/services/trading/simulation/engine.py`
- [Paper trading](https://github.com/et1992s/eusebiu-tamas-personal-portfolio/tree/master/backend/app/services/trading/paper): `backend/app/services/trading/paper`

### Transit

- [Transit API](https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/backend/app/api/tube.py): `backend/app/api/tube.py`
- [Route algorithms](https://github.com/et1992s/eusebiu-tamas-personal-portfolio/tree/master/backend/app/services/tube): `backend/app/services/tube`

### Contact

- [Contact API](https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/backend/app/api/contact.py): `backend/app/api/contact.py`
- [Contact delivery](https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/backend/app/services/contact/service.py): `backend/app/services/contact/service.py`
- [Contact request](https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/backend/app/services/contact/models.py): `backend/app/services/contact/models.py`

### Other components

- **Visitor**
- [Backend application](https://github.com/et1992s/eusebiu-tamas-personal-portfolio/blob/master/backend/app/main.py): `backend/app/main.py`

## Connections

- Visitor → Application routes: opens (evidence: `frontend/src/App.jsx`)
- Application routes → Trading workspace: routes to (evidence: `frontend/src/App.jsx`)
- Application routes → AI chat: routes to (evidence: `frontend/src/App.jsx`)
- Application routes → Zebio workspace: routes to (evidence: `frontend/src/App.jsx`)
- Application routes → Tube project: routes to (evidence: `frontend/src/App.jsx`)
- Trading workspace → Trading data hooks: loads data via (evidence: `frontend/src/pages/TradingProjectPage.jsx`)
- Trading workspace → Live chart hook: loads live chart (evidence: `frontend/src/pages/TradingProjectPage.jsx`)
- Trading workspace → Live prediction hook: loads live prediction (evidence: `frontend/src/pages/TradingProjectPage.jsx`)
- Trading workspace → Candlestick chart: renders (evidence: `frontend/src/pages/TradingProjectPage.jsx`)
- Trading data hooks → API client: requests bars (evidence: `frontend/src/hooks/useTradingData.js`)
- Live chart hook → Chart service: requests chart data
- Live chart hook → Live streams: subscribes
- Live prediction hook → Live streams: subscribes
- AI chat → AI API: sends chat
- Backend application → AI API: registers (evidence: `backend/app/main.py`)
- Backend application → Contact API: registers (evidence: `backend/app/main.py`)
- Contact API → Contact delivery: delegates to (evidence: `backend/app/api/contact.py`)
- Contact delivery → Contact request: accepts (evidence: `backend/app/services/contact/service.py`)
- AI API → AI agent: invokes (evidence: `backend/app/api/ai.py`)
- AI API → AI memory: uses (evidence: `backend/app/api/ai.py`)
- AI API → Prompt library: uses (evidence: `backend/app/api/ai.py`)
- AI agent → Memory retrieval: retrieves context
- Task manager → AI agent: coordinates
- Backend application → Trading API: registers
- Trading API → Market data: requests data
- Market data → Market store: reads and writes (evidence: `backend/app/services/trading/live/market_data.py`)
- Market data → Market provider: fetches data (evidence: `backend/app/services/trading/live/market_data.py`)
- Chart service → Market data: gets market data (evidence: `backend/app/services/trading/live/chart.py`)
- Live prediction → Market provider: fetches data (evidence: `backend/app/services/trading/live/prediction.py`)
- Live prediction → ML inference: runs inference (evidence: `backend/app/services/trading/live/prediction.py`)
- ML inference → Feature engineering: prepares features (evidence: `backend/app/services/trading/ml/inference.py`)
- Backend application → Backtesting engine: runs backtest (evidence: `backend/app/main.py`)
- Backend application → Paper trading: registers (evidence: `backend/app/main.py`)
- Backend application → Transit API: registers
- Transit API → Route algorithms: routes and analyzes
