# elmos-ai/attendo architecture

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

- Interactive diagram: https://gitdiagram.com/elmos-ai/attendo
- Repository: https://github.com/elmos-ai/attendo

## Overview

Attendo is a Vue SPA for authenticated exam-attendance management. Users sign in, browse sessions, and drill through session, UE, event, and room views to manage attendance; the views delegate data operations to Supabase-backed services. Authentication state and route guards control access. The README also describes real-time synchronization, though the sampled code does not show its implementation; that capability is marked unverified. Relationships are based on sampled imports/calls and README claims; unsampled details are not inferred.

Main entry points: [`src/router/index.js`](https://github.com/elmos-ai/attendo/blob/main/src/router/index.js) (Route guard), [`src/lib/supabaseClient.js`](https://github.com/elmos-ai/attendo/blob/main/src/lib/supabaseClient.js) (Supabase client), [`src/views/Room.vue`](https://github.com/elmos-ai/attendo/blob/main/src/views/Room.vue) (Room attendance), [`src/App.vue`](https://github.com/elmos-ai/attendo/blob/main/src/App.vue) (App shell)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application shell"]
  node_app["App shell<br/>[App.vue]"]
  node_router["Route guard<br/>[index.js]"]
  node_home["Home<br/>[Home.vue]"]
  node_about["About<br/>[About.vue]"]
end

subgraph group_auth["Authentication"]
  node_authstore["Auth store<br/>[counter.js]"]
  node_login["Login control<br/>[LoginButton.vue]"]
end

subgraph group_workflow["Exam workflow"]
  node_sessions["Sessions<br/>[Sessions.vue]"]
  node_session["Session detail<br/>[Session.vue]"]
  node_ue["UE detail<br/>[Ue.vue]"]
  node_event["Event detail<br/>[Event.vue]"]
  node_room["Room attendance<br/>[Room.vue]"]
end

subgraph group_ui["Reusable interface"]
  node_breadcrumb["Breadcrumb<br/>[Breadcrumb.vue]"]
  node_table["Data table<br/>[Table.vue]"]
  node_select["Select input<br/>[SelectInput.vue]"]
  node_text["Text input<br/>[TextInput.vue]"]
  node_attendance["Attendance list<br/>[attendanceList.vue]"]
end

subgraph group_data["Data access"]
  node_client["Supabase client<br/>[supabaseClient.js]"]
  node_sessionlist["Session service"]
  node_sessioncompo["Session UE service"]
  node_sessionue["UE event service"]
  node_eventservice["Event service<br/>[eventService.js]"]
  node_roomservice["Room service<br/>[roomService.js]"]
end

node_user(("User"))
node_supabase[("Supabase")]

node_user -->|"uses"| node_app
node_app -->|"initializes"| node_authstore
node_app -->|"observes auth"| node_client
node_app -->|"hosts routes"| node_router
node_app -->|"renders"| node_login
node_login -->|"dispatches auth"| node_authstore
node_authstore -->|"calls auth"| node_client
node_router -->|"checks user"| node_client
node_router -->|"routes to"| node_home
node_router -->|"routes to"| node_about
node_router -->|"routes to"| node_sessions
node_router -->|"routes to"| node_session
node_router -->|"routes to"| node_ue
node_router -->|"routes to"| node_event
node_router -->|"routes to"| node_room
node_sessions -->|"calls"| node_sessionlist
node_session -->|"calls"| node_sessioncompo
node_ue -->|"calls"| node_sessionue
node_event -->|"calls"| node_eventservice
node_room -->|"calls"| node_roomservice
node_sessionlist -->|"queries"| node_client
node_sessioncompo -->|"queries"| node_client
node_sessionue -->|"queries"| node_client
node_eventservice -->|"uses"| node_client
node_roomservice -->|"uses"| node_client
node_client -->|"connects"| node_supabase
node_sessions -->|"renders"| node_table
node_sessions -->|"renders"| node_text
node_session -->|"renders"| node_table
node_session -->|"renders"| node_select
node_ue -->|"renders"| node_table
node_ue -->|"renders"| node_text
node_event -->|"renders"| node_table
node_event -->|"renders"| node_select
node_room -->|"renders"| node_table
node_room -->|"renders"| node_select
node_room -->|"renders"| node_attendance
node_sessions -->|"renders"| node_breadcrumb
node_session -->|"renders"| node_breadcrumb
node_ue -->|"renders"| node_breadcrumb
node_event -->|"renders"| node_breadcrumb
node_room -->|"renders"| node_breadcrumb
node_supabase -.->|"syncs data"| node_client

click node_app "https://github.com/elmos-ai/attendo/blob/main/src/App.vue"
click node_router "https://github.com/elmos-ai/attendo/blob/main/src/router/index.js"
click node_home "https://github.com/elmos-ai/attendo/blob/main/src/views/Home.vue"
click node_about "https://github.com/elmos-ai/attendo/blob/main/src/views/About.vue"
click node_authstore "https://github.com/elmos-ai/attendo/blob/main/src/stores/counter.js"
click node_login "https://github.com/elmos-ai/attendo/blob/main/src/components/LoginButton.vue"
click node_client "https://github.com/elmos-ai/attendo/blob/main/src/lib/supabaseClient.js"
click node_sessions "https://github.com/elmos-ai/attendo/blob/main/src/views/Sessions.vue"
click node_session "https://github.com/elmos-ai/attendo/blob/main/src/views/Session.vue"
click node_ue "https://github.com/elmos-ai/attendo/blob/main/src/views/Ue.vue"
click node_event "https://github.com/elmos-ai/attendo/blob/main/src/views/Event.vue"
click node_room "https://github.com/elmos-ai/attendo/blob/main/src/views/Room.vue"
click node_sessionlist "https://github.com/elmos-ai/attendo/blob/main/src/service/listSessionsService.js"
click node_sessioncompo "https://github.com/elmos-ai/attendo/blob/main/src/service/sessionCompoService.js"
click node_sessionue "https://github.com/elmos-ai/attendo/blob/main/src/service/sessionUeService.js"
click node_eventservice "https://github.com/elmos-ai/attendo/blob/main/src/service/eventService.js"
click node_roomservice "https://github.com/elmos-ai/attendo/blob/main/src/service/roomService.js"
click node_breadcrumb "https://github.com/elmos-ai/attendo/blob/main/src/components/Breadcrumb.vue"
click node_table "https://github.com/elmos-ai/attendo/blob/main/src/components/Table.vue"
click node_select "https://github.com/elmos-ai/attendo/blob/main/src/components/SelectInput.vue"
click node_text "https://github.com/elmos-ai/attendo/blob/main/src/components/TextInput.vue"
click node_attendance "https://github.com/elmos-ai/attendo/blob/main/src/components/attendanceList.vue"

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_router,node_home,node_about,node_user toneBlue
class node_authstore,node_login,node_supabase toneAmber
class node_sessions,node_session,node_ue,node_event,node_room toneMint
class node_breadcrumb,node_table,node_select,node_text,node_attendance toneRose
class node_client,node_sessionlist,node_sessioncompo,node_sessionue,node_eventservice,node_roomservice toneIndigo
```

## Components

### Application shell

- [App shell](https://github.com/elmos-ai/attendo/blob/main/src/App.vue): `src/App.vue`
- [Route guard](https://github.com/elmos-ai/attendo/blob/main/src/router/index.js): `src/router/index.js`
- [Home](https://github.com/elmos-ai/attendo/blob/main/src/views/Home.vue): `src/views/Home.vue`
- [About](https://github.com/elmos-ai/attendo/blob/main/src/views/About.vue): `src/views/About.vue`

### Authentication

- [Auth store](https://github.com/elmos-ai/attendo/blob/main/src/stores/counter.js): `src/stores/counter.js`
- [Login control](https://github.com/elmos-ai/attendo/blob/main/src/components/LoginButton.vue): `src/components/LoginButton.vue`

### Exam workflow

- [Sessions](https://github.com/elmos-ai/attendo/blob/main/src/views/Sessions.vue): `src/views/Sessions.vue`
- [Session detail](https://github.com/elmos-ai/attendo/blob/main/src/views/Session.vue): `src/views/Session.vue`
- [UE detail](https://github.com/elmos-ai/attendo/blob/main/src/views/Ue.vue): `src/views/Ue.vue`
- [Event detail](https://github.com/elmos-ai/attendo/blob/main/src/views/Event.vue): `src/views/Event.vue`
- [Room attendance](https://github.com/elmos-ai/attendo/blob/main/src/views/Room.vue): `src/views/Room.vue`

### Reusable interface

- [Breadcrumb](https://github.com/elmos-ai/attendo/blob/main/src/components/Breadcrumb.vue): `src/components/Breadcrumb.vue`
- [Data table](https://github.com/elmos-ai/attendo/blob/main/src/components/Table.vue): `src/components/Table.vue`
- [Select input](https://github.com/elmos-ai/attendo/blob/main/src/components/SelectInput.vue): `src/components/SelectInput.vue`
- [Text input](https://github.com/elmos-ai/attendo/blob/main/src/components/TextInput.vue): `src/components/TextInput.vue`
- [Attendance list](https://github.com/elmos-ai/attendo/blob/main/src/components/attendanceList.vue): `src/components/attendanceList.vue`

### Data access

- [Supabase client](https://github.com/elmos-ai/attendo/blob/main/src/lib/supabaseClient.js): `src/lib/supabaseClient.js`
- [Session service](https://github.com/elmos-ai/attendo/blob/main/src/service/listSessionsService.js): `src/service/listSessionsService.js`
- [Session UE service](https://github.com/elmos-ai/attendo/blob/main/src/service/sessionCompoService.js): `src/service/sessionCompoService.js`
- [UE event service](https://github.com/elmos-ai/attendo/blob/main/src/service/sessionUeService.js): `src/service/sessionUeService.js`
- [Event service](https://github.com/elmos-ai/attendo/blob/main/src/service/eventService.js): `src/service/eventService.js`
- [Room service](https://github.com/elmos-ai/attendo/blob/main/src/service/roomService.js): `src/service/roomService.js`

### Other components

- **User**
- **Supabase**

## Connections

- User → App shell: uses (evidence: `src/App.vue`)
- App shell → Auth store: initializes (evidence: `src/App.vue`)
- App shell → Supabase client: observes auth (evidence: `src/App.vue`)
- App shell → Route guard: hosts routes (evidence: `src/main.js`)
- App shell → Login control: renders (evidence: `src/App.vue`)
- Login control → Auth store: dispatches auth (evidence: `src/components/LoginButton.vue`)
- Auth store → Supabase client: calls auth (evidence: `src/stores/counter.js`)
- Route guard → Supabase client: checks user (evidence: `src/router/index.js`)
- Route guard → Home: routes to (evidence: `src/router/index.js`)
- Route guard → About: routes to (evidence: `src/router/index.js`)
- Route guard → Sessions: routes to (evidence: `src/router/index.js`)
- Route guard → Session detail: routes to (evidence: `src/router/index.js`)
- Route guard → UE detail: routes to (evidence: `src/router/index.js`)
- Route guard → Event detail: routes to (evidence: `src/router/index.js`)
- Route guard → Room attendance: routes to (evidence: `src/router/index.js`)
- Sessions → Session service: calls (evidence: `src/views/Sessions.vue`)
- Session detail → Session UE service: calls (evidence: `src/views/Session.vue`)
- UE detail → UE event service: calls (evidence: `src/views/Ue.vue`)
- Event detail → Event service: calls (evidence: `src/views/Event.vue`)
- Room attendance → Room service: calls (evidence: `src/views/Room.vue`)
- Session service → Supabase client: queries (evidence: `src/service/listSessionsService.js`)
- Session UE service → Supabase client: queries (evidence: `src/service/sessionCompoService.js`)
- UE event service → Supabase client: queries (evidence: `src/service/sessionUeService.js`)
- Event service → Supabase client: uses (evidence: `src/service/eventService.js`)
- Room service → Supabase client: uses (evidence: `src/service/roomService.js`)
- Supabase client → Supabase: connects (evidence: `src/lib/supabaseClient.js`)
- Sessions → Data table: renders (evidence: `src/views/Sessions.vue`)
- Sessions → Text input: renders (evidence: `src/views/Sessions.vue`)
- Session detail → Data table: renders (evidence: `src/views/Session.vue`)
- Session detail → Select input: renders (evidence: `src/views/Session.vue`)
- UE detail → Data table: renders (evidence: `src/views/Ue.vue`)
- UE detail → Text input: renders (evidence: `src/views/Ue.vue`)
- Event detail → Data table: renders (evidence: `src/views/Event.vue`)
- Event detail → Select input: renders (evidence: `src/views/Event.vue`)
- Room attendance → Data table: renders (evidence: `src/views/Room.vue`)
- Room attendance → Select input: renders (evidence: `src/views/Room.vue`)
- Room attendance → Attendance list: renders (evidence: `src/views/Room.vue`)
- Sessions → Breadcrumb: renders (evidence: `src/views/Sessions.vue`)
- Session detail → Breadcrumb: renders (evidence: `src/views/Session.vue`)
- UE detail → Breadcrumb: renders (evidence: `src/views/Ue.vue`)
- Event detail → Breadcrumb: renders (evidence: `src/views/Event.vue`)
- Room attendance → Breadcrumb: renders (evidence: `src/views/Room.vue`)
- Supabase → Supabase client: syncs data (evidence: `README.md`)
