# tilak-21/teamant architecture

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

- Interactive diagram: https://gitdiagram.com/tilak-21/teamant
- Repository: https://github.com/tilak-21/teamant

## Overview

##### Project type and purpose
- This is a monolithic, full-stack PHP web application (“GatorATT”) whose goal is to track user applications (for jobs/scholarships/etc.) and to let admins review announcements and submissions. It is broken into five iterative “sprints,” each containing:
- html/php pages (presentation + business logic)
- client-side scripts (JavaScript form handling, UI interactions)
- styles (CSS)
- SQL restore scripts (data layer seeds)

##### File structure
- Top-level folders:
- SprintOne → SprintFive: each holds the evolving app
- .idea, Images, index.html, styles/: IDE settings, assets, static landing page
- Within SprintFive (the latest iteration):
- html/: all frontend entrypoints (some .php for dynamic pages, some plain .html)
- scripts/: JavaScript form validation and dynamic UI
- styles/: CSS
- sql/: database seeding scripts (restoreApplications.sql, restoreUsers.sql)
- Configuration surface:
- html/db.php: sets up the PDO connection to MySQL
- html/isLogged.php, loginEndpoint.php: session-based access control

##### README
- Confirms technology choices (PHP, PDO for database access, HTML, JavaScript, CSS).
- Indicates educational purpose: learn PHP, PDO, web stack.

## Diagram (Mermaid)

```mermaid
flowchart TB
    classDef client fill:#AEDFF7,stroke:#000
    classDef server fill:#CBEFCB,stroke:#000
    classDef data fill:#F7CB9E,stroke:#000
    classDef external fill:#F4C2C2,stroke:#000

    Browser["Browser / Client\n(HTML, CSS, JS)"]:::client

    subgraph "Web Server & PHP Application"
        subgraph "Presentation Layer"
            LP1["loginPage.php"]:::server
            LE["loginEndpoint.php"]:::server
            SP["signup.php"]:::server
            SR["signupReciept.php"]:::server
            SUR["signupupdateReciept.php"]:::server

            UD["userDashboard.php"]:::server
            DASH["dashboard.php"]:::server
            AD["adminDashboard.php"]:::server

            APP["application.php"]:::server
            NAS["newApplicationShared.php"]:::server
            NAR["newAppReceipt.php"]:::server
            EAPP["editApplication.php"]:::server
            EAR["editAppReceipt.php"]:::server

            AN["announcement.php"]:::server
            AVR["viewAnnouncementReceipt.php"]:::server

            C["contact.php"]:::server
            CR["contactReceipt.php"]:::server
        end

        subgraph "Session Management"
            IS["isLogged.php"]:::server
            LO["logout.php"]:::server
        end

        subgraph "Business Logic & Models"
            DBP["db.php"]:::server
        end

        subgraph "Static Assets"
            JS1["scripts.js"]:::server
            JS2["scriptsignup.js"]:::server
            CSS["styles.css"]:::server
            IMG["Images/"]:::server
        end
    end

    DB["Database\nMySQL/MariaDB"]:::data
    SMTP["SMTP Server\n(Email)"]:::external

    Browser -->|"HTTP req"| LP1
    Browser -->|"HTTP req"| LE
    Browser -->|"HTTP req"| SP
    Browser -->|"HTTP req"| SR
    Browser -->|"HTTP req"| SUR
    Browser -->|"HTTP req"| UD
    Browser -->|"HTTP req"| DASH
    Browser -->|"HTTP req"| AD
    Browser -->|"HTTP req"| APP
    Browser -->|"HTTP req"| NAS
    Browser -->|"HTTP req"| NAR
    Browser -->|"HTTP req"| EAPP
    Browser -->|"HTTP req"| EAR
    Browser -->|"HTTP req"| AN
    Browser -->|"HTTP req"| AVR
    Browser -->|"HTTP req"| C
    Browser -->|"HTTP req"| CR

    LP1 -->|"calls"| DBP
    LE -->|"calls"| DBP
    SP -->|"calls"| DBP
    SR -->|"calls"| DBP
    SUR -->|"calls"| DBP

    UD -->|"guard"| IS
    DASH -->|"guard"| IS
    AD -->|"guard"| IS

    APP -->|"guard"| IS
    NAS -->|"guard"| IS
    NAR -->|"guard"| IS
    EAPP -->|"guard"| IS
    EAR -->|"guard"| IS

    AN -->|"guard"| IS
    AVR -->|"guard"| IS

    C -->|"calls"| DBP
    CR -->|"calls"| DBP
    C -->|"emails"| SMTP
    CR -->|"emails"| SMTP

    IS -->|"verifies"| DBP
    LO -->|"destroys sess"| DBP

    DBP -->|"query via PDO"| DB

    Browser --> JS1
    Browser --> JS2
    Browser --> CSS
    Browser --> IMG

    click LP1 "https://github.com/tilak-21/teamant/blob/main/SprintFive/html/loginPage.php"
    click LE "https://github.com/tilak-21/teamant/blob/main/SprintFive/html/loginEndpoint.php"
    click SP "https://github.com/tilak-21/teamant/blob/main/SprintFive/html/signup.php"
    click SR "https://github.com/tilak-21/teamant/blob/main/SprintFive/html/signupReciept.php"
    click SUR "https://github.com/tilak-21/teamant/blob/main/SprintFive/html/signupupdateReciept.php"
    click IS "https://github.com/tilak-21/teamant/blob/main/SprintFive/html/isLogged.php"
    click LO "https://github.com/tilak-21/teamant/blob/main/SprintFive/html/logout.php"
    click UD "https://github.com/tilak-21/teamant/blob/main/SprintFive/html/userDashboard.php"
    click DASH "https://github.com/tilak-21/teamant/blob/main/SprintFive/html/dashboard.php"
    click AD "https://github.com/tilak-21/teamant/blob/main/SprintFive/html/adminDashboard.php"
    click APP "https://github.com/tilak-21/teamant/blob/main/SprintFive/html/application.php"
    click NAS "https://github.com/tilak-21/teamant/blob/main/SprintFive/html/newApplicationShared.php"
    click NAR "https://github.com/tilak-21/teamant/blob/main/SprintFive/html/newAppReceipt.php"
    click EAPP "https://github.com/tilak-21/teamant/blob/main/SprintFive/html/editApplication.php"
    click EAR "https://github.com/tilak-21/teamant/blob/main/SprintFive/html/editAppReceipt.php"
    click AN "https://github.com/tilak-21/teamant/blob/main/SprintFive/html/announcement.php"
    click AVR "https://github.com/tilak-21/teamant/blob/main/SprintFive/html/viewAnnouncementReceipt.php"
    click C "https://github.com/tilak-21/teamant/blob/main/SprintFive/html/contact.php"
    click CR "https://github.com/tilak-21/teamant/blob/main/SprintFive/html/contactReceipt.php"
    click DBP "https://github.com/tilak-21/teamant/blob/main/SprintFive/html/db.php"
    click JS1 "https://github.com/tilak-21/teamant/blob/main/SprintFive/scripts/scripts.js"
    click JS2 "https://github.com/tilak-21/teamant/blob/main/SprintFive/scripts/scriptsignup.js"
    click CSS "https://github.com/tilak-21/teamant/blob/main/SprintFive/styles/styles.css"
    click IMG "https://github.com/tilak-21/teamant/tree/main/Images/"
```
