# nct-bca/alumini-connect architecture

> Architecture diagram of the GitHub repository nct-bca/alumini-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/nct-bca/alumini-connect
- Repository: https://github.com/nct-bca/alumini-connect

## Overview

This repository combines a static BCA alumni directory with a Firebase-backed alumni hub. In the directory, visitors can browse alumni and connect through profile and contact flows; the hub supports account registration and sign-in, opportunity posts, and admin approval and moderation. The sampled hub code shows its UI coordinating authentication, post operations, and admin actions against Firebase. The excerpts do not establish how the HTML pages load their scripts, so those links are omitted.

Main entry points: [`firebase-config.js`](https://github.com/nct-bca/alumini-connect/blob/main/firebase-config.js) (Firebase setup), [`alumni-hub.js`](https://github.com/nct-bca/alumini-connect/blob/main/alumni-hub.js) (Hub workflows), [`firebase-auth.js`](https://github.com/nct-bca/alumini-connect/blob/main/firebase-auth.js) (Authentication), [`firebase-admin.js`](https://github.com/nct-bca/alumini-connect/blob/main/firebase-admin.js) (Admin operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_directory["Alumni Directory"]
  node_directory_ui["Directory page<br/>[alumni-hub.html]"]
  node_directory_logic["Directory logic<br/>[script.js]"]
end

subgraph group_hub["Alumni Hub"]
  node_hub_ui["Hub page<br/>[index.html]"]
  node_hub_logic["Hub workflows<br/>[alumni-hub.js]"]
  node_authentication["Authentication<br/>[firebase-auth.js]"]
  node_admin_ops["Admin operations<br/>[firebase-admin.js]"]
end

subgraph group_services["Firebase Services"]
  node_firebase_config["Firebase setup<br/>[firebase-config.js]"]
  node_firebase_auth["Firebase Auth"]
  node_firestore[("Cloud Firestore")]
end

node_visitor(("Visitor"))
node_member(("Alumni member"))

node_hub_logic -->|"calls auth"| node_authentication
node_hub_logic -->|"calls admin"| node_admin_ops
node_authentication -->|"uses setup"| node_firebase_config
node_admin_ops -->|"uses setup"| node_firebase_config
node_hub_logic -->|"reads and writes"| node_firestore
node_authentication -->|"reads and writes"| node_firestore
node_admin_ops -->|"reads and writes"| node_firestore
node_firebase_config -->|"initializes"| node_firebase_auth
node_firebase_config -->|"initializes"| node_firestore

click node_directory_ui "https://github.com/nct-bca/alumini-connect/blob/main/alumni-hub.html"
click node_directory_logic "https://github.com/nct-bca/alumini-connect/blob/main/script.js"
click node_hub_ui "https://github.com/nct-bca/alumini-connect/blob/main/index.html"
click node_hub_logic "https://github.com/nct-bca/alumini-connect/blob/main/alumni-hub.js"
click node_authentication "https://github.com/nct-bca/alumini-connect/blob/main/firebase-auth.js"
click node_admin_ops "https://github.com/nct-bca/alumini-connect/blob/main/firebase-admin.js"
click node_firebase_config "https://github.com/nct-bca/alumini-connect/blob/main/firebase-config.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_directory_ui,node_directory_logic toneBlue
class node_hub_ui,node_hub_logic,node_authentication,node_admin_ops toneAmber
class node_firebase_config,node_firebase_auth,node_firestore toneMint
class node_visitor,node_member toneIndigo
```

## Components

### Alumni Directory

- [Directory page](https://github.com/nct-bca/alumini-connect/blob/main/alumni-hub.html): `alumni-hub.html`
- [Directory logic](https://github.com/nct-bca/alumini-connect/blob/main/script.js): `script.js`

### Alumni Hub

- [Hub page](https://github.com/nct-bca/alumini-connect/blob/main/index.html): `index.html`
- [Hub workflows](https://github.com/nct-bca/alumini-connect/blob/main/alumni-hub.js): `alumni-hub.js`
- [Authentication](https://github.com/nct-bca/alumini-connect/blob/main/firebase-auth.js): `firebase-auth.js`
- [Admin operations](https://github.com/nct-bca/alumini-connect/blob/main/firebase-admin.js): `firebase-admin.js`

### Firebase Services

- [Firebase setup](https://github.com/nct-bca/alumini-connect/blob/main/firebase-config.js): `firebase-config.js`
- **Firebase Auth**
- **Cloud Firestore**

### Other components

- **Visitor**
- **Alumni member**

## Connections

- Hub workflows → Authentication: calls auth (evidence: `alumni-hub.js`)
- Hub workflows → Admin operations: calls admin (evidence: `alumni-hub.js`)
- Authentication → Firebase setup: uses setup (evidence: `firebase-auth.js`)
- Admin operations → Firebase setup: uses setup (evidence: `firebase-admin.js`)
- Hub workflows → Cloud Firestore: reads and writes (evidence: `alumni-hub.js`)
- Authentication → Cloud Firestore: reads and writes (evidence: `firebase-auth.js`)
- Admin operations → Cloud Firestore: reads and writes (evidence: `firebase-admin.js`)
- Firebase setup → Firebase Auth: initializes (evidence: `firebase-config.js`)
- Firebase setup → Cloud Firestore: initializes (evidence: `firebase-config.js`)
