# maxxl1fe/cso---norsu-portal architecture

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

- Interactive diagram: https://gitdiagram.com/maxxl1fe/cso---norsu-portal
- Repository: https://github.com/maxxl1fe/cso---norsu-portal

## Overview

CSO-MIS is a browser-based organization management portal. Members register or log in, browse public organization and event information, register for events, and check in during event dates; staff use role-based management capabilities for members, events, announcements, attendance, profiles, and feedback. The visible PHP pages show authentication, public browsing, registration, and QR check-in, while the README documents broader dashboard capabilities. Those dashboard implementations and the database/configuration files are absent from the supplied tree, so their node paths are null and their documented links cite the README.

Main entry points: [`login.php`](https://github.com/maxxl1fe/cso---norsu-portal/blob/main/login.php) (Member login), [`admin_login.php`](https://github.com/maxxl1fe/cso---norsu-portal/blob/main/admin_login.php) (Admin login), [`index.php`](https://github.com/maxxl1fe/cso---norsu-portal/blob/main/index.php) (Login-first router), [`register.php`](https://github.com/maxxl1fe/cso---norsu-portal/blob/main/register.php) (Account registration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry_auth["Entry and accounts"]
  node_entry["Login-first router<br/>[index.php]"]
  node_member_login["Member login<br/>[login.php]"]
  node_admin_login["Admin login<br/>[admin_login.php]"]
  node_registration["Account registration<br/>[register.php]"]
end

subgraph group_public_info["Public information"]
  node_public_home["Public homepage<br/>[home.php]"]
  node_officer_directory["Officer directory<br/>[officers.php]"]
end

subgraph group_event_ops["Event participation"]
  node_event_detail["Event details and signup<br/>[event.php]"]
  node_qr_checkin["QR check-in<br/>[checkin.php]"]
end

subgraph group_management["Organization management"]
  node_dashboard_suite["Role-based dashboards"]
end

node_visitor(("Visitor or member"))
node_mysql[("MySQL or MariaDB")]

node_visitor -->|"opens"| node_entry
node_entry -->|"routes unauthenticated"| node_member_login
node_visitor -->|"registers"| node_registration
node_visitor -->|"uses admin access"| node_admin_login
node_visitor -->|"browses"| node_public_home
node_visitor -->|"searches"| node_officer_directory
node_visitor -->|"views and registers"| node_event_detail
node_visitor -->|"scans event QR"| node_qr_checkin
node_registration -->|"creates member"| node_mysql
node_member_login -->|"checks credentials"| node_mysql
node_admin_login -->|"checks credentials"| node_mysql
node_public_home -->|"reads public content"| node_mysql
node_officer_directory -->|"reads officers"| node_mysql
node_event_detail -->|"reads and updates registrations"| node_mysql
node_qr_checkin -->|"reads event and writes attendance"| node_mysql
node_member_login -->|"routes authenticated roles"| node_dashboard_suite
node_admin_login -->|"routes authenticated roles"| node_dashboard_suite
node_dashboard_suite -.->|"manages organization data"| node_mysql

click node_entry "https://github.com/maxxl1fe/cso---norsu-portal/blob/main/index.php"
click node_member_login "https://github.com/maxxl1fe/cso---norsu-portal/blob/main/login.php"
click node_admin_login "https://github.com/maxxl1fe/cso---norsu-portal/blob/main/admin_login.php"
click node_registration "https://github.com/maxxl1fe/cso---norsu-portal/blob/main/register.php"
click node_public_home "https://github.com/maxxl1fe/cso---norsu-portal/blob/main/home.php"
click node_officer_directory "https://github.com/maxxl1fe/cso---norsu-portal/blob/main/officers.php"
click node_event_detail "https://github.com/maxxl1fe/cso---norsu-portal/blob/main/event.php"
click node_qr_checkin "https://github.com/maxxl1fe/cso---norsu-portal/blob/main/checkin.php"

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_entry,node_member_login,node_admin_login,node_registration toneBlue
class node_public_home,node_officer_directory,node_mysql toneAmber
class node_event_detail,node_qr_checkin toneMint
class node_dashboard_suite toneRose
class node_visitor toneIndigo
```

## Components

### Entry and accounts

- [Login-first router](https://github.com/maxxl1fe/cso---norsu-portal/blob/main/index.php): `index.php`
- [Member login](https://github.com/maxxl1fe/cso---norsu-portal/blob/main/login.php): `login.php`
- [Admin login](https://github.com/maxxl1fe/cso---norsu-portal/blob/main/admin_login.php): `admin_login.php`
- [Account registration](https://github.com/maxxl1fe/cso---norsu-portal/blob/main/register.php): `register.php`

### Public information

- [Public homepage](https://github.com/maxxl1fe/cso---norsu-portal/blob/main/home.php): `home.php`
- [Officer directory](https://github.com/maxxl1fe/cso---norsu-portal/blob/main/officers.php): `officers.php`

### Event participation

- [Event details and signup](https://github.com/maxxl1fe/cso---norsu-portal/blob/main/event.php): `event.php`
- [QR check-in](https://github.com/maxxl1fe/cso---norsu-portal/blob/main/checkin.php): `checkin.php`

### Organization management

- **Role-based dashboards**

### Other components

- **Visitor or member**
- **MySQL or MariaDB**

## Connections

- Visitor or member → Login-first router: opens (evidence: `index.php`)
- Login-first router → Member login: routes unauthenticated (evidence: `index.php`)
- Visitor or member → Account registration: registers
- Visitor or member → Admin login: uses admin access
- Visitor or member → Public homepage: browses
- Visitor or member → Officer directory: searches (evidence: `README.md`)
- Visitor or member → Event details and signup: views and registers
- Visitor or member → QR check-in: scans event QR (evidence: `README.md`)
- Account registration → MySQL or MariaDB: creates member (evidence: `register.php`)
- Member login → MySQL or MariaDB: checks credentials (evidence: `login.php`)
- Admin login → MySQL or MariaDB: checks credentials (evidence: `admin_login.php`)
- Public homepage → MySQL or MariaDB: reads public content (evidence: `home.php`)
- Officer directory → MySQL or MariaDB: reads officers (evidence: `officers.php`)
- Event details and signup → MySQL or MariaDB: reads and updates registrations (evidence: `event.php`)
- QR check-in → MySQL or MariaDB: reads event and writes attendance (evidence: `checkin.php`)
- Member login → Role-based dashboards: routes authenticated roles (evidence: `README.md`)
- Admin login → Role-based dashboards: routes authenticated roles (evidence: `README.md`)
- Role-based dashboards → MySQL or MariaDB: manages organization data (evidence: `README.md`)
