# markot0164/cloudroom architecture

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

## Overview

CloudRoom is a student-facing exam-organization platform. Students sign in, then manage documents, checklists, calendar events, and notifications from a personal area. The sampled React pages call API endpoints for documents, checklists, user registration, and notifications; calendar operations call Microsoft Graph directly. The README also describes document summaries and sharing, plus Azure-backed storage and identity services. The function source was indexed as read but no excerpt was provided, so backend internals and most service-level connections are shown only where documented.

Main entry points: [`function_app/function_app.py`](https://github.com/markot0164/cloudroom/blob/main/function_app/function_app.py) (Azure Functions API), [`static_app/src/pages/PersonalArea.js`](https://github.com/markot0164/cloudroom/blob/main/static_app/src/pages/PersonalArea.js) (Personal area), [`static_app/src/App.js`](https://github.com/markot0164/cloudroom/blob/main/static_app/src/App.js) (App and routes), [`static_app/src/pages/Checklist.js`](https://github.com/markot0164/cloudroom/blob/main/static_app/src/pages/Checklist.js) (Checklist management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_app["App and routes<br/>[App.js]"]
  node_sign_in["Microsoft sign-in<br/>[HomePage.js]"]
  node_personal["Personal area<br/>[PersonalArea.js]"]
  node_header["Header<br/>[Header.js]"]
  node_footer["Footer<br/>[Footer.js]"]
end

subgraph group_study["Study features"]
  node_documents["Document management<br/>[Documenti.js]"]
  node_checklists["Checklist management<br/>[Checklist.js]"]
  node_calendar["Calendar planning<br/>[Calendario.js]"]
  node_notifications["Notifications view<br/>[Notifiche.js]"]
  node_sharing["Document sharing"]
end

subgraph group_backend["Application backend"]
  node_api["Azure Functions API<br/>[function_app.py]"]
end

subgraph group_cloud["Cloud services"]
  node_blob[("Blob Storage")]
  node_cosmos[("Cosmos DB")]
  node_openai["Azure OpenAI"]
  node_graph["Microsoft Graph"]
  node_entra["Microsoft Entra ID"]
  node_keyvault[("Azure Key Vault")]
end

node_student(("Student"))

node_student -->|"uses"| node_app
node_app -->|"routes to"| node_sign_in
node_app -->|"routes to"| node_personal
node_app -->|"routes to"| node_calendar
node_app -->|"routes to"| node_checklists
node_sign_in -->|"authenticates with"| node_entra
node_personal -->|"registers user"| node_api
node_personal -->|"renders"| node_documents
node_personal -->|"renders"| node_notifications
node_personal -->|"navigates to"| node_calendar
node_personal -->|"navigates to"| node_checklists
node_personal -->|"renders"| node_header
node_personal -->|"renders"| node_footer
node_documents -->|"requests documents"| node_api
node_checklists -->|"manages checklists"| node_api
node_notifications -->|"fetches notifications"| node_api
node_calendar -->|"reads and edits events"| node_graph
node_calendar -->|"renders"| node_header
node_calendar -->|"renders"| node_footer
node_checklists -->|"renders"| node_header
node_checklists -->|"renders"| node_footer
node_api -->|"stores documents"| node_blob
node_api -->|"stores structured data"| node_cosmos
node_api -->|"summarizes documents"| node_openai
node_api -->|"protects credentials"| node_keyvault
node_api -.->|"supports collaboration"| node_sharing
node_student -.->|"shares documents"| node_sharing

click node_app "https://github.com/markot0164/cloudroom/blob/main/static_app/src/App.js"
click node_sign_in "https://github.com/markot0164/cloudroom/blob/main/static_app/src/pages/HomePage.js"
click node_personal "https://github.com/markot0164/cloudroom/blob/main/static_app/src/pages/PersonalArea.js"
click node_header "https://github.com/markot0164/cloudroom/blob/main/static_app/src/component/Header.js"
click node_footer "https://github.com/markot0164/cloudroom/blob/main/static_app/src/component/Footer.js"
click node_documents "https://github.com/markot0164/cloudroom/blob/main/static_app/src/component/Documenti.js"
click node_checklists "https://github.com/markot0164/cloudroom/blob/main/static_app/src/pages/Checklist.js"
click node_calendar "https://github.com/markot0164/cloudroom/blob/main/static_app/src/pages/Calendario.js"
click node_notifications "https://github.com/markot0164/cloudroom/blob/main/static_app/src/component/Notifiche.js"
click node_sharing "https://github.com/markot0164/cloudroom/tree/main/static_app/src"
click node_api "https://github.com/markot0164/cloudroom/blob/main/function_app/function_app.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_sign_in,node_personal,node_header,node_footer toneBlue
class node_documents,node_checklists,node_calendar,node_notifications,node_sharing toneAmber
class node_api toneMint
class node_blob,node_cosmos,node_openai,node_graph,node_entra,node_keyvault toneRose
class node_student toneIndigo
```

## Components

### Web application

- [App and routes](https://github.com/markot0164/cloudroom/blob/main/static_app/src/App.js): `static_app/src/App.js`
- [Microsoft sign-in](https://github.com/markot0164/cloudroom/blob/main/static_app/src/pages/HomePage.js): `static_app/src/pages/HomePage.js`
- [Personal area](https://github.com/markot0164/cloudroom/blob/main/static_app/src/pages/PersonalArea.js): `static_app/src/pages/PersonalArea.js`
- [Header](https://github.com/markot0164/cloudroom/blob/main/static_app/src/component/Header.js): `static_app/src/component/Header.js`
- [Footer](https://github.com/markot0164/cloudroom/blob/main/static_app/src/component/Footer.js): `static_app/src/component/Footer.js`

### Study features

- [Document management](https://github.com/markot0164/cloudroom/blob/main/static_app/src/component/Documenti.js): `static_app/src/component/Documenti.js`
- [Checklist management](https://github.com/markot0164/cloudroom/blob/main/static_app/src/pages/Checklist.js): `static_app/src/pages/Checklist.js`
- [Calendar planning](https://github.com/markot0164/cloudroom/blob/main/static_app/src/pages/Calendario.js): `static_app/src/pages/Calendario.js`
- [Notifications view](https://github.com/markot0164/cloudroom/blob/main/static_app/src/component/Notifiche.js): `static_app/src/component/Notifiche.js`
- [Document sharing](https://github.com/markot0164/cloudroom/tree/main/static_app/src): `static_app/src`

### Application backend

- [Azure Functions API](https://github.com/markot0164/cloudroom/blob/main/function_app/function_app.py): `function_app/function_app.py`

### Cloud services

- **Blob Storage**
- **Cosmos DB**
- **Azure OpenAI**
- **Microsoft Graph**
- **Microsoft Entra ID**
- **Azure Key Vault**

### Other components

- **Student**

## Connections

- Student → App and routes: uses (evidence: `static_app/src/App.js`)
- App and routes → Microsoft sign-in: routes to (evidence: `static_app/src/App.js`)
- App and routes → Personal area: routes to (evidence: `static_app/src/App.js`)
- App and routes → Calendar planning: routes to (evidence: `static_app/src/App.js`)
- App and routes → Checklist management: routes to (evidence: `static_app/src/App.js`)
- Microsoft sign-in → Microsoft Entra ID: authenticates with (evidence: `static_app/src/pages/HomePage.js`)
- Personal area → Azure Functions API: registers user (evidence: `static_app/src/pages/PersonalArea.js`)
- Personal area → Document management: renders (evidence: `static_app/src/pages/PersonalArea.js`)
- Personal area → Notifications view: renders (evidence: `static_app/src/pages/PersonalArea.js`)
- Personal area → Calendar planning: navigates to (evidence: `static_app/src/pages/PersonalArea.js`)
- Personal area → Checklist management: navigates to (evidence: `static_app/src/pages/PersonalArea.js`)
- Personal area → Header: renders (evidence: `static_app/src/pages/PersonalArea.js`)
- Personal area → Footer: renders (evidence: `static_app/src/pages/PersonalArea.js`)
- Document management → Azure Functions API: requests documents (evidence: `static_app/src/component/Documenti.js`)
- Checklist management → Azure Functions API: manages checklists (evidence: `static_app/src/pages/Checklist.js`)
- Notifications view → Azure Functions API: fetches notifications (evidence: `static_app/src/component/Notifiche.js`)
- Calendar planning → Microsoft Graph: reads and edits events (evidence: `static_app/src/pages/Calendario.js`)
- Calendar planning → Header: renders (evidence: `static_app/src/pages/Calendario.js`)
- Calendar planning → Footer: renders (evidence: `static_app/src/pages/Calendario.js`)
- Checklist management → Header: renders (evidence: `static_app/src/pages/Checklist.js`)
- Checklist management → Footer: renders (evidence: `static_app/src/pages/Checklist.js`)
- Azure Functions API → Blob Storage: stores documents (evidence: `README.md`)
- Azure Functions API → Cosmos DB: stores structured data (evidence: `README.md`)
- Azure Functions API → Azure OpenAI: summarizes documents (evidence: `README.md`)
- Azure Functions API → Azure Key Vault: protects credentials (evidence: `README.md`)
- Azure Functions API → Document sharing: supports collaboration (evidence: `README.md`)
- Student → Document sharing: shares documents (evidence: `README.md`)
