# manho30/student-connect architecture

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

- Interactive diagram: https://gitdiagram.com/manho30/student-connect
- Repository: https://github.com/manho30/student-connect

## Overview

Lend a Hand is a student community frontend for sharing carpools, errands, study groups, and campus activities. Students authenticate, navigate protected routes, browse listings and details, and create or manage services through domain-specific views and components; profile and My Services summarize their activity. Views call a centralized REST client, while Firebase handles identity and Cloudinary supports activity posters. The graph preserves documented workflows and administrative capabilities; some connections rely on README or SOURCE INDEX references because not all source was excerpted.

Main entry points: [`src/router/index.js`](https://github.com/manho30/student-connect/blob/main/src/router/index.js) (Route and Access Control), [`src/api/index.js`](https://github.com/manho30/student-connect/blob/main/src/api/index.js) (REST API Client), [`src/views/ProfileView.vue`](https://github.com/manho30/student-connect/blob/main/src/views/ProfileView.vue) (Profile and My Services), [`src/services/auth.js`](https://github.com/manho30/student-connect/blob/main/src/services/auth.js) (Authentication State)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application Core"]
  node_router["Route and Access Control<br/>[index.js]"]
  node_shell["App Navigation<br/>[App.vue]"]
  node_api["REST API Client<br/>[index.js]"]
end

subgraph group_community["Community Services"]
  node_carpool["Carpool Workflows<br/>[CarpoolView.vue]"]
  node_carpoolform["Carpool Create and Edit"]
  node_carpoolui["Carpool Cards and Details"]
  node_errands["Errand Workflows<br/>[ErrandsView.vue]"]
  node_errandform["Errand Create and Edit<br/>[ErrandFormView.vue]"]
  node_errandui["Errand Cards and Details"]
  node_study["Study Group Workflows"]
  node_studyform["Study Create and Edit<br/>[StudyFormView.vue]"]
  node_studyui["Study Cards and Details"]
end

subgraph group_activities["Activities"]
  node_activity["Activity Discovery<br/>[ActivitiesView.vue]"]
  node_activityform["Activity Create and Edit"]
  node_activityui["Activity Cards and Details"]
  node_poster["Poster Upload<br/>[cloudinary.js]"]
end

subgraph group_identity["Identity and Accounts"]
  node_auth["Authentication State<br/>[auth.js]"]
  node_login["Login<br/>[LoginView.vue]"]
end

subgraph group_insights["Account and Admin"]
  node_profile["Profile and My Services<br/>[ProfileView.vue]"]
  node_myservices["My Services Summary<br/>[MyServiceView.vue]"]
  node_admin["User Administration<br/>[AdminUsersView.vue]"]
  node_statistics["Service Statistics<br/>[StatisticsView.vue]"]
end

node_student(("Student"))
node_backend["Lend a Hand API"]
node_cloudinary["Cloudinary"]
node_firebase["Firebase Authentication"]

node_student -->|"navigates"| node_router
node_router -->|"routes to"| node_login
node_router -->|"routes to"| node_carpool
node_router -->|"routes to"| node_carpoolform
node_router -->|"routes to"| node_errands
node_router -->|"routes to"| node_errandform
node_router -->|"routes to"| node_study
node_router -->|"routes to"| node_studyform
node_router -->|"routes to"| node_activity
node_router -->|"routes to"| node_activityform
node_router -->|"routes to"| node_profile
node_router -->|"routes to"| node_myservices
node_router -->|"routes to"| node_admin
node_router -->|"routes to"| node_statistics
node_router -->|"checks identity"| node_auth
node_router -->|"loads profile"| node_api
node_shell -->|"reads identity"| node_auth
node_shell -->|"loads profile"| node_api
node_login -->|"authenticates"| node_auth
node_auth -->|"uses SDK"| node_firebase
node_api -->|"gets ID token"| node_auth
node_api -->|"sends requests"| node_backend
node_carpool -->|"loads and updates"| node_api
node_carpoolform -->|"saves service"| node_api
node_carpool -->|"renders"| node_carpoolui
node_carpoolform -->|"uses date helper"| node_carpoolui
node_errands -->|"loads and updates"| node_api
node_errandform -->|"saves service"| node_api
node_errands -->|"renders"| node_errandui
node_errandform -->|"uses form"| node_errandui
node_study -->|"loads and updates"| node_api
node_studyform -->|"saves service"| node_api
node_study -->|"renders"| node_studyui
node_studyform -->|"uses form"| node_studyui
node_activity -->|"loads and updates"| node_api
node_activityform -->|"saves activity"| node_api
node_activity -->|"renders"| node_activityui
node_activityform -->|"uses form"| node_activityui
node_activityform -->|"uploads poster"| node_poster
node_poster -->|"uploads image"| node_cloudinary
node_profile -->|"loads and saves"| node_api
node_profile -->|"reads identity"| node_auth
node_profile -->|"renders cards"| node_carpoolui
node_profile -->|"renders cards"| node_errandui
node_profile -->|"renders cards"| node_studyui
node_profile -->|"renders cards"| node_activityui
node_myservices -->|"loads services"| node_api
node_admin -->|"manages users"| node_api

click node_router "https://github.com/manho30/student-connect/blob/main/src/router/index.js"
click node_shell "https://github.com/manho30/student-connect/blob/main/src/App.vue"
click node_api "https://github.com/manho30/student-connect/blob/main/src/api/index.js"
click node_carpool "https://github.com/manho30/student-connect/blob/main/src/views/CarpoolView.vue"
click node_carpoolform "https://github.com/manho30/student-connect/blob/main/src/views/CarpoolFormView.vue"
click node_carpoolui "https://github.com/manho30/student-connect/tree/main/src/components/carpool"
click node_errands "https://github.com/manho30/student-connect/blob/main/src/views/ErrandsView.vue"
click node_errandform "https://github.com/manho30/student-connect/blob/main/src/views/ErrandFormView.vue"
click node_errandui "https://github.com/manho30/student-connect/tree/main/src/components/errands"
click node_study "https://github.com/manho30/student-connect/blob/main/src/views/StudyGroupsView.vue"
click node_studyform "https://github.com/manho30/student-connect/blob/main/src/views/StudyFormView.vue"
click node_studyui "https://github.com/manho30/student-connect/tree/main/src/components/study"
click node_activity "https://github.com/manho30/student-connect/blob/main/src/views/ActivitiesView.vue"
click node_activityform "https://github.com/manho30/student-connect/blob/main/src/views/ActivitiesFormView.vue"
click node_activityui "https://github.com/manho30/student-connect/tree/main/src/components/activities"
click node_poster "https://github.com/manho30/student-connect/blob/main/src/utils/cloudinary.js"
click node_auth "https://github.com/manho30/student-connect/blob/main/src/services/auth.js"
click node_login "https://github.com/manho30/student-connect/blob/main/src/views/LoginView.vue"
click node_profile "https://github.com/manho30/student-connect/blob/main/src/views/ProfileView.vue"
click node_myservices "https://github.com/manho30/student-connect/blob/main/src/views/MyServiceView.vue"
click node_admin "https://github.com/manho30/student-connect/blob/main/src/views/AdminUsersView.vue"
click node_statistics "https://github.com/manho30/student-connect/blob/main/src/views/StatisticsView.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_router,node_shell,node_api toneBlue
class node_carpool,node_carpoolform,node_carpoolui,node_errands,node_errandform,node_errandui,node_study,node_studyform,node_studyui toneAmber
class node_activity,node_activityform,node_activityui,node_poster,node_backend toneMint
class node_auth,node_login toneRose
class node_profile,node_myservices,node_admin,node_statistics,node_student,node_cloudinary,node_firebase toneIndigo
```

## Components

### Application Core

- [Route and Access Control](https://github.com/manho30/student-connect/blob/main/src/router/index.js): `src/router/index.js`
- [App Navigation](https://github.com/manho30/student-connect/blob/main/src/App.vue): `src/App.vue`
- [REST API Client](https://github.com/manho30/student-connect/blob/main/src/api/index.js): `src/api/index.js`

### Community Services

- [Carpool Workflows](https://github.com/manho30/student-connect/blob/main/src/views/CarpoolView.vue): `src/views/CarpoolView.vue`
- [Carpool Create and Edit](https://github.com/manho30/student-connect/blob/main/src/views/CarpoolFormView.vue): `src/views/CarpoolFormView.vue`
- [Carpool Cards and Details](https://github.com/manho30/student-connect/tree/main/src/components/carpool): `src/components/carpool`
- [Errand Workflows](https://github.com/manho30/student-connect/blob/main/src/views/ErrandsView.vue): `src/views/ErrandsView.vue`
- [Errand Create and Edit](https://github.com/manho30/student-connect/blob/main/src/views/ErrandFormView.vue): `src/views/ErrandFormView.vue`
- [Errand Cards and Details](https://github.com/manho30/student-connect/tree/main/src/components/errands): `src/components/errands`
- [Study Group Workflows](https://github.com/manho30/student-connect/blob/main/src/views/StudyGroupsView.vue): `src/views/StudyGroupsView.vue`
- [Study Create and Edit](https://github.com/manho30/student-connect/blob/main/src/views/StudyFormView.vue): `src/views/StudyFormView.vue`
- [Study Cards and Details](https://github.com/manho30/student-connect/tree/main/src/components/study): `src/components/study`

### Activities

- [Activity Discovery](https://github.com/manho30/student-connect/blob/main/src/views/ActivitiesView.vue): `src/views/ActivitiesView.vue`
- [Activity Create and Edit](https://github.com/manho30/student-connect/blob/main/src/views/ActivitiesFormView.vue): `src/views/ActivitiesFormView.vue`
- [Activity Cards and Details](https://github.com/manho30/student-connect/tree/main/src/components/activities): `src/components/activities`
- [Poster Upload](https://github.com/manho30/student-connect/blob/main/src/utils/cloudinary.js): `src/utils/cloudinary.js`

### Identity and Accounts

- [Authentication State](https://github.com/manho30/student-connect/blob/main/src/services/auth.js): `src/services/auth.js`
- [Login](https://github.com/manho30/student-connect/blob/main/src/views/LoginView.vue): `src/views/LoginView.vue`

### Account and Admin

- [Profile and My Services](https://github.com/manho30/student-connect/blob/main/src/views/ProfileView.vue): `src/views/ProfileView.vue`
- [My Services Summary](https://github.com/manho30/student-connect/blob/main/src/views/MyServiceView.vue): `src/views/MyServiceView.vue`
- [User Administration](https://github.com/manho30/student-connect/blob/main/src/views/AdminUsersView.vue): `src/views/AdminUsersView.vue`
- [Service Statistics](https://github.com/manho30/student-connect/blob/main/src/views/StatisticsView.vue): `src/views/StatisticsView.vue`

### Other components

- **Student**
- **Lend a Hand API**
- **Cloudinary**
- **Firebase Authentication**

## Connections

- Student → Route and Access Control: navigates (evidence: `README.md`)
- Route and Access Control → Login: routes to (evidence: `src/router/index.js`)
- Route and Access Control → Carpool Workflows: routes to (evidence: `src/router/index.js`)
- Route and Access Control → Carpool Create and Edit: routes to (evidence: `src/router/index.js`)
- Route and Access Control → Errand Workflows: routes to (evidence: `src/router/index.js`)
- Route and Access Control → Errand Create and Edit: routes to (evidence: `src/router/index.js`)
- Route and Access Control → Study Group Workflows: routes to (evidence: `src/router/index.js`)
- Route and Access Control → Study Create and Edit: routes to (evidence: `src/router/index.js`)
- Route and Access Control → Activity Discovery: routes to (evidence: `src/router/index.js`)
- Route and Access Control → Activity Create and Edit: routes to (evidence: `src/router/index.js`)
- Route and Access Control → Profile and My Services: routes to (evidence: `src/router/index.js`)
- Route and Access Control → My Services Summary: routes to (evidence: `src/router/index.js`)
- Route and Access Control → User Administration: routes to (evidence: `src/router/index.js`)
- Route and Access Control → Service Statistics: routes to (evidence: `src/router/index.js`)
- Route and Access Control → Authentication State: checks identity (evidence: `src/router/index.js`)
- Route and Access Control → REST API Client: loads profile (evidence: `src/router/index.js`)
- App Navigation → Authentication State: reads identity (evidence: `src/App.vue`)
- App Navigation → REST API Client: loads profile (evidence: `src/App.vue`)
- Login → Authentication State: authenticates (evidence: `src/views/LoginView.vue`)
- Authentication State → Firebase Authentication: uses SDK (evidence: `src/services/auth.js`)
- REST API Client → Authentication State: gets ID token (evidence: `src/api/index.js`)
- REST API Client → Lend a Hand API: sends requests (evidence: `README.md`)
- Carpool Workflows → REST API Client: loads and updates (evidence: `src/views/CarpoolView.vue`)
- Carpool Create and Edit → REST API Client: saves service (evidence: `src/views/CarpoolFormView.vue`)
- Carpool Workflows → Carpool Cards and Details: renders (evidence: `src/views/CarpoolView.vue`)
- Carpool Create and Edit → Carpool Cards and Details: uses date helper (evidence: `src/components/carpool/CarpoolForm.vue`)
- Errand Workflows → REST API Client: loads and updates (evidence: `src/views/ErrandsView.vue`)
- Errand Create and Edit → REST API Client: saves service (evidence: `src/views/ErrandFormView.vue`)
- Errand Workflows → Errand Cards and Details: renders (evidence: `src/views/ErrandsView.vue`)
- Errand Create and Edit → Errand Cards and Details: uses form (evidence: `src/views/ErrandFormView.vue`)
- Study Group Workflows → REST API Client: loads and updates (evidence: `src/views/StudyGroupsView.vue`)
- Study Create and Edit → REST API Client: saves service (evidence: `src/views/StudyFormView.vue`)
- Study Group Workflows → Study Cards and Details: renders (evidence: `src/views/StudyGroupsView.vue`)
- Study Create and Edit → Study Cards and Details: uses form (evidence: `src/views/StudyFormView.vue`)
- Activity Discovery → REST API Client: loads and updates (evidence: `src/views/ActivitiesView.vue`)
- Activity Create and Edit → REST API Client: saves activity (evidence: `src/views/ActivitiesFormView.vue`)
- Activity Discovery → Activity Cards and Details: renders (evidence: `src/views/ActivitiesView.vue`)
- Activity Create and Edit → Activity Cards and Details: uses form (evidence: `src/views/ActivitiesFormView.vue`)
- Activity Create and Edit → Poster Upload: uploads poster
- Poster Upload → Cloudinary: uploads image (evidence: `README.md`)
- Profile and My Services → REST API Client: loads and saves (evidence: `src/views/ProfileView.vue`)
- Profile and My Services → Authentication State: reads identity (evidence: `src/views/ProfileView.vue`)
- Profile and My Services → Carpool Cards and Details: renders cards (evidence: `src/views/ProfileView.vue`)
- Profile and My Services → Errand Cards and Details: renders cards (evidence: `src/views/ProfileView.vue`)
- Profile and My Services → Study Cards and Details: renders cards (evidence: `src/views/ProfileView.vue`)
- Profile and My Services → Activity Cards and Details: renders cards (evidence: `src/views/ProfileView.vue`)
- My Services Summary → REST API Client: loads services (evidence: `src/views/MyServiceView.vue`)
- User Administration → REST API Client: manages users (evidence: `src/views/AdminUsersView.vue`)
