# cliffamadeus/blitz architecture

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

- Interactive diagram: https://gitdiagram.com/cliffamadeus/blitz
- Repository: https://github.com/cliffamadeus/blitz

## Overview

This is a PHP library-management application with role-based login. The main workflow authenticates a user, checks verification and active-session status, then routes them to role-specific pages. Managers manage students, books, and borrowing records; administrators manage users and review activity and session history. Shared modules provide authentication, CSRF checks, activity logging, and session lifecycle behavior. Source excerpts show application SQL against a MySQL database; the schema files are present but unsampled, so their detailed structure is not mapped.

Main entry points: [`config/config.php`](https://github.com/cliffamadeus/blitz/blob/main/config/config.php) (App configuration), [`functions/auth.php`](https://github.com/cliffamadeus/blitz/blob/main/functions/auth.php) (Authentication), [`functions/activity.php`](https://github.com/cliffamadeus/blitz/blob/main/functions/activity.php) (Activity logging), [`index.php`](https://github.com/cliffamadeus/blitz/blob/main/index.php) (Login page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Login and access"]
  node_login["Login page<br/>[index.php]"]
  node_signout["Sign out<br/>[signout.php]"]
end

subgraph group_shared["Shared services"]
  node_config["App configuration<br/>[config.php]"]
  node_auth["Authentication<br/>[auth.php]"]
  node_csrf["CSRF protection<br/>[csrf.php]"]
  node_activity["Activity logging<br/>[activity.php]"]
  node_sessions["Session lifecycle<br/>[session.php]"]
  node_redirect["Redirect helper<br/>[redirect.php]"]
end

subgraph group_roles["Role workflows"]
  node_admin["Admin dashboard<br/>[index.php]"]
  node_user_admin["User management<br/>[users.php]"]
  node_manager["Library management<br/>[index.php]"]
  node_user_page["User page<br/>[index.php]"]
end

subgraph group_state["Persistent state"]
  node_database[("MySQL data")]
end

node_visitor(("Visitor"))

node_visitor -->|"submits credentials"| node_login
node_login -->|"loads"| node_config
node_login -->|"checks token"| node_csrf
node_login -->|"authenticates"| node_auth
node_login -->|"logs attempt"| node_activity
node_auth -->|"queries users"| node_database
node_auth -->|"checks and starts"| node_sessions
node_auth -->|"logs login"| node_activity
node_auth -->|"redirects unauthenticated"| node_login
node_admin -->|"loads"| node_config
node_admin -->|"reads logs and sessions"| node_database
node_user_admin -->|"loads"| node_config
node_user_admin -->|"manages accounts"| node_database
node_user_admin -->|"logs changes"| node_activity
node_manager -->|"loads"| node_config
node_manager -->|"manages library records"| node_database
node_manager -->|"logs actions"| node_activity
node_signout -->|"loads"| node_config
node_signout -->|"logs out"| node_auth
node_auth -->|"ends session"| node_sessions
node_sessions -->|"records session state"| node_database
node_sessions -->|"logs timeout"| node_activity
node_activity -->|"writes activity"| node_database
node_config -->|"loads"| node_activity
node_config -->|"loads"| node_auth
node_config -->|"loads"| node_csrf
node_config -->|"loads"| node_redirect
node_config -->|"loads"| node_sessions
node_user_page -->|"links to"| node_signout

click node_login "https://github.com/cliffamadeus/blitz/blob/main/index.php"
click node_signout "https://github.com/cliffamadeus/blitz/blob/main/auth/signout.php"
click node_admin "https://github.com/cliffamadeus/blitz/blob/main/app/admin/index.php"
click node_user_admin "https://github.com/cliffamadeus/blitz/blob/main/app/admin/users.php"
click node_manager "https://github.com/cliffamadeus/blitz/blob/main/app/manager/index.php"
click node_user_page "https://github.com/cliffamadeus/blitz/blob/main/app/user/index.php"
click node_config "https://github.com/cliffamadeus/blitz/blob/main/config/config.php"
click node_auth "https://github.com/cliffamadeus/blitz/blob/main/functions/auth.php"
click node_csrf "https://github.com/cliffamadeus/blitz/blob/main/functions/csrf.php"
click node_activity "https://github.com/cliffamadeus/blitz/blob/main/functions/activity.php"
click node_sessions "https://github.com/cliffamadeus/blitz/blob/main/functions/session.php"
click node_redirect "https://github.com/cliffamadeus/blitz/blob/main/functions/redirect.php"
click node_database "https://github.com/cliffamadeus/blitz/tree/main/database"

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_login,node_signout toneBlue
class node_config,node_auth,node_csrf,node_activity,node_sessions,node_redirect toneAmber
class node_admin,node_user_admin,node_manager,node_user_page toneMint
class node_database toneRose
class node_visitor toneIndigo
```

## Components

### Login and access

- [Login page](https://github.com/cliffamadeus/blitz/blob/main/index.php): `index.php`
- [Sign out](https://github.com/cliffamadeus/blitz/blob/main/auth/signout.php): `auth/signout.php`

### Shared services

- [App configuration](https://github.com/cliffamadeus/blitz/blob/main/config/config.php): `config/config.php`
- [Authentication](https://github.com/cliffamadeus/blitz/blob/main/functions/auth.php): `functions/auth.php`
- [CSRF protection](https://github.com/cliffamadeus/blitz/blob/main/functions/csrf.php): `functions/csrf.php`
- [Activity logging](https://github.com/cliffamadeus/blitz/blob/main/functions/activity.php): `functions/activity.php`
- [Session lifecycle](https://github.com/cliffamadeus/blitz/blob/main/functions/session.php): `functions/session.php`
- [Redirect helper](https://github.com/cliffamadeus/blitz/blob/main/functions/redirect.php): `functions/redirect.php`

### Role workflows

- [Admin dashboard](https://github.com/cliffamadeus/blitz/blob/main/app/admin/index.php): `app/admin/index.php`
- [User management](https://github.com/cliffamadeus/blitz/blob/main/app/admin/users.php): `app/admin/users.php`
- [Library management](https://github.com/cliffamadeus/blitz/blob/main/app/manager/index.php): `app/manager/index.php`
- [User page](https://github.com/cliffamadeus/blitz/blob/main/app/user/index.php): `app/user/index.php`

### Persistent state

- [MySQL data](https://github.com/cliffamadeus/blitz/tree/main/database): `database`

### Other components

- **Visitor**

## Connections

- Visitor → Login page: submits credentials (evidence: `index.php`)
- Login page → App configuration: loads (evidence: `index.php`)
- Login page → CSRF protection: checks token (evidence: `index.php`)
- Login page → Authentication: authenticates (evidence: `index.php`)
- Login page → Activity logging: logs attempt (evidence: `index.php`)
- Authentication → MySQL data: queries users (evidence: `functions/auth.php`)
- Authentication → Session lifecycle: checks and starts (evidence: `functions/auth.php`)
- Authentication → Activity logging: logs login (evidence: `functions/auth.php`)
- Authentication → Login page: redirects unauthenticated (evidence: `functions/auth.php`)
- Admin dashboard → App configuration: loads (evidence: `app/admin/index.php`)
- Admin dashboard → MySQL data: reads logs and sessions (evidence: `app/admin/index.php`)
- User management → App configuration: loads (evidence: `app/admin/users.php`)
- User management → MySQL data: manages accounts (evidence: `app/admin/users.php`)
- User management → Activity logging: logs changes (evidence: `app/admin/users.php`)
- Library management → App configuration: loads (evidence: `app/manager/index.php`)
- Library management → MySQL data: manages library records (evidence: `app/manager/index.php`)
- Library management → Activity logging: logs actions (evidence: `app/manager/index.php`)
- Sign out → App configuration: loads (evidence: `auth/signout.php`)
- Sign out → Authentication: logs out (evidence: `auth/signout.php`)
- Authentication → Session lifecycle: ends session (evidence: `functions/auth.php`)
- Session lifecycle → MySQL data: records session state (evidence: `functions/session.php`)
- Session lifecycle → Activity logging: logs timeout (evidence: `functions/session.php`)
- Activity logging → MySQL data: writes activity (evidence: `functions/activity.php`)
- App configuration → Activity logging: loads (evidence: `config/config.php`)
- App configuration → Authentication: loads (evidence: `config/config.php`)
- App configuration → CSRF protection: loads (evidence: `config/config.php`)
- App configuration → Redirect helper: loads (evidence: `config/config.php`)
- App configuration → Session lifecycle: loads (evidence: `config/config.php`)
- User page → Sign out: links to (evidence: `app/user/index.php`)
