# marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system architecture

> Architecture diagram of the GitHub repository marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system, 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/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system
- Repository: https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system

## Overview

This repository implements an alumni-community platform with web and mobile clients backed by an Express API. Users authenticate and then use community, profile, career, event, achievement, and donation features; staff also manage approvals and platform activity. The graph highlights these product areas and the sampled persistence, authorization, storage, and realtime layers. Evidence is limited to the supplied excerpts and SOURCE INDEX; unsampled feature wiring is not inferred.

Main entry points: [`frontend/src/App.jsx`](https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system/blob/main/frontend/src/App.jsx) (Web Application), [`backend/src/routes/alumniRoutes.js`](https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system/blob/main/backend/src/routes/alumniRoutes.js) (Alumni Records), [`backend/src/config/prisma.js`](https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system/blob/main/backend/src/config/prisma.js) (Application Database), [`mobile/App.js`](https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system/blob/main/mobile/App.js) (Mobile Application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["Client Applications"]
  node_webapp["Web Application<br/>[App.jsx]"]
  node_web_home["Home Dashboard<br/>[Home.jsx]"]
  node_mobile_app["Mobile Application<br/>[App.js]"]
end

subgraph group_identity["Identity and Access"]
  node_web_auth["Web Authentication<br/>[authService.js]"]
  node_mobile_auth["Mobile Authentication<br/>[authService.js]"]
  node_auth_routes["Authentication Routes<br/>[authRoutes.js]"]
  node_auth_logic["Authentication Logic<br/>[authService.js]"]
  node_access_control["Access Control<br/>[auth.js]"]
end

subgraph group_community["Alumni Community"]
  node_web_directory["Alumni Directory"]
  node_web_profile["Alumni Profile<br/>[AlumniProfile.jsx]"]
  node_mobile_community["Mobile Community"]
  node_alumni_routes["Alumni Records<br/>[alumniRoutes.js]"]
end

subgraph group_activities["Platform Activities"]
  node_web_donations["Donation Experience<br/>[DonatePage.jsx]"]
  node_mobile_donations["Mobile Donations<br/>[donationService.js]"]
  node_donation_routes["Donation Campaigns<br/>[donationRoutes.js]"]
end

subgraph group_backend["Backend Services"]
  node_api["Express API<br/>[index.js]"]
  node_activity_log["Activity Logging"]
  node_realtime["Realtime Updates<br/>[realtimeService.js]"]
  node_file_storage["File Storage<br/>[storageService.js]"]
  node_supabase_storage[("Supabase Storage<br/>[supabase.js]")]
  node_database[("Application Database<br/>[prisma.js]")]
end

node_person(("Member or Staff"))

node_person -.->|"uses"| node_webapp
node_person -.->|"uses"| node_mobile_app
node_webapp -->|"routes to"| node_web_auth
node_webapp -->|"routes to"| node_web_directory
node_webapp -->|"routes to"| node_web_profile
node_webapp -->|"routes to"| node_web_home
node_webapp -->|"routes to"| node_web_donations
node_mobile_app -.->|"uses"| node_mobile_auth
node_mobile_app -.->|"uses"| node_mobile_community
node_mobile_app -.->|"uses"| node_mobile_donations
node_api -->|"mounts"| node_auth_routes
node_api -->|"mounts"| node_alumni_routes
node_api -->|"mounts"| node_donation_routes
node_web_auth -->|"posts auth requests"| node_auth_routes
node_auth_routes -->|"delegates to"| node_auth_logic
node_auth_routes -->|"applies middleware"| node_access_control
node_auth_logic -->|"reads and writes"| node_database
node_access_control -->|"checks account"| node_database
node_alumni_routes -->|"reads and writes"| node_database
node_alumni_routes -->|"uploads files"| node_file_storage
node_alumni_routes -->|"broadcasts updates"| node_realtime
node_alumni_routes -->|"records activity"| node_activity_log
node_donation_routes -->|"reads and writes"| node_database
node_donation_routes -->|"uploads files"| node_file_storage
node_file_storage -->|"uploads and resolves URLs"| node_supabase_storage
node_activity_log -->|"stores log entries"| node_database

click node_webapp "https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system/blob/main/frontend/src/App.jsx"
click node_web_auth "https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system/blob/main/frontend/src/services/authService.js"
click node_web_directory "https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system/blob/main/frontend/src/components/AlumniDirectory.jsx"
click node_web_profile "https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system/blob/main/frontend/src/components/AlumniProfile.jsx"
click node_web_home "https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system/blob/main/frontend/src/components/Home.jsx"
click node_web_donations "https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system/blob/main/frontend/src/components/DonatePage.jsx"
click node_mobile_app "https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system/blob/main/mobile/App.js"
click node_mobile_auth "https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system/blob/main/mobile/src/services/authService.js"
click node_mobile_community "https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system/blob/main/mobile/src/services/communityService.js"
click node_mobile_donations "https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system/blob/main/mobile/src/services/donationService.js"
click node_api "https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system/blob/main/backend/src/index.js"
click node_auth_routes "https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system/blob/main/backend/src/routes/authRoutes.js"
click node_auth_logic "https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system/blob/main/backend/src/services/authService.js"
click node_access_control "https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system/blob/main/backend/src/middleware/auth.js"
click node_alumni_routes "https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system/blob/main/backend/src/routes/alumniRoutes.js"
click node_donation_routes "https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system/blob/main/backend/src/routes/donationRoutes.js"
click node_activity_log "https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system/blob/main/backend/src/services/activityLogService.js"
click node_realtime "https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system/blob/main/backend/src/services/realtimeService.js"
click node_file_storage "https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system/blob/main/backend/src/services/storageService.js"
click node_supabase_storage "https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system/blob/main/backend/src/config/supabase.js"
click node_database "https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system/blob/main/backend/src/config/prisma.js"

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_webapp,node_web_home,node_mobile_app toneBlue
class node_web_auth,node_mobile_auth,node_auth_routes,node_auth_logic,node_access_control toneAmber
class node_web_directory,node_web_profile,node_mobile_community,node_alumni_routes toneMint
class node_web_donations,node_mobile_donations,node_donation_routes toneRose
class node_api,node_activity_log,node_realtime,node_file_storage,node_supabase_storage,node_database,node_person toneIndigo
```

## Components

### Client Applications

- [Web Application](https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Home Dashboard](https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system/blob/main/frontend/src/components/Home.jsx): `frontend/src/components/Home.jsx`
- [Mobile Application](https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system/blob/main/mobile/App.js): `mobile/App.js`

### Identity and Access

- [Web Authentication](https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system/blob/main/frontend/src/services/authService.js): `frontend/src/services/authService.js`
- [Mobile Authentication](https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system/blob/main/mobile/src/services/authService.js): `mobile/src/services/authService.js`
- [Authentication Routes](https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system/blob/main/backend/src/routes/authRoutes.js): `backend/src/routes/authRoutes.js`
- [Authentication Logic](https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system/blob/main/backend/src/services/authService.js): `backend/src/services/authService.js`
- [Access Control](https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system/blob/main/backend/src/middleware/auth.js): `backend/src/middleware/auth.js`

### Alumni Community

- [Alumni Directory](https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system/blob/main/frontend/src/components/AlumniDirectory.jsx): `frontend/src/components/AlumniDirectory.jsx`
- [Alumni Profile](https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system/blob/main/frontend/src/components/AlumniProfile.jsx): `frontend/src/components/AlumniProfile.jsx`
- [Mobile Community](https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system/blob/main/mobile/src/services/communityService.js): `mobile/src/services/communityService.js`
- [Alumni Records](https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system/blob/main/backend/src/routes/alumniRoutes.js): `backend/src/routes/alumniRoutes.js`

### Platform Activities

- [Donation Experience](https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system/blob/main/frontend/src/components/DonatePage.jsx): `frontend/src/components/DonatePage.jsx`
- [Mobile Donations](https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system/blob/main/mobile/src/services/donationService.js): `mobile/src/services/donationService.js`
- [Donation Campaigns](https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system/blob/main/backend/src/routes/donationRoutes.js): `backend/src/routes/donationRoutes.js`

### Backend Services

- [Express API](https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system/blob/main/backend/src/index.js): `backend/src/index.js`
- [Activity Logging](https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system/blob/main/backend/src/services/activityLogService.js): `backend/src/services/activityLogService.js`
- [Realtime Updates](https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system/blob/main/backend/src/services/realtimeService.js): `backend/src/services/realtimeService.js`
- [File Storage](https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system/blob/main/backend/src/services/storageService.js): `backend/src/services/storageService.js`
- [Supabase Storage](https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system/blob/main/backend/src/config/supabase.js): `backend/src/config/supabase.js`
- [Application Database](https://github.com/marclorenzlas-vibecoder/lccb-alumni-database-and-tracking-system/blob/main/backend/src/config/prisma.js): `backend/src/config/prisma.js`

### Other components

- **Member or Staff**

## Connections

- Member or Staff → Web Application: uses
- Member or Staff → Mobile Application: uses
- Web Application → Web Authentication: routes to (evidence: `frontend/src/App.jsx`)
- Web Application → Alumni Directory: routes to (evidence: `frontend/src/App.jsx`)
- Web Application → Alumni Profile: routes to (evidence: `frontend/src/App.jsx`)
- Web Application → Home Dashboard: routes to (evidence: `frontend/src/App.jsx`)
- Web Application → Donation Experience: routes to (evidence: `frontend/src/App.jsx`)
- Mobile Application → Mobile Authentication: uses
- Mobile Application → Mobile Community: uses
- Mobile Application → Mobile Donations: uses
- Express API → Authentication Routes: mounts (evidence: `backend/src/index.js`)
- Express API → Alumni Records: mounts (evidence: `backend/src/index.js`)
- Express API → Donation Campaigns: mounts (evidence: `backend/src/index.js`)
- Web Authentication → Authentication Routes: posts auth requests (evidence: `frontend/src/services/authService.js`)
- Authentication Routes → Authentication Logic: delegates to (evidence: `backend/src/routes/authRoutes.js`)
- Authentication Routes → Access Control: applies middleware (evidence: `backend/src/routes/authRoutes.js`)
- Authentication Logic → Application Database: reads and writes (evidence: `backend/src/services/authService.js`)
- Access Control → Application Database: checks account (evidence: `backend/src/middleware/auth.js`)
- Alumni Records → Application Database: reads and writes (evidence: `backend/src/routes/alumniRoutes.js`)
- Alumni Records → File Storage: uploads files (evidence: `backend/src/routes/alumniRoutes.js`)
- Alumni Records → Realtime Updates: broadcasts updates (evidence: `backend/src/routes/alumniRoutes.js`)
- Alumni Records → Activity Logging: records activity (evidence: `backend/src/routes/alumniRoutes.js`)
- Donation Campaigns → Application Database: reads and writes (evidence: `backend/src/routes/donationRoutes.js`)
- Donation Campaigns → File Storage: uploads files (evidence: `backend/src/routes/donationRoutes.js`)
- File Storage → Supabase Storage: uploads and resolves URLs (evidence: `backend/src/services/storageService.js`)
- Activity Logging → Application Database: stores log entries (evidence: `backend/src/services/activityLogService.js`)
