# leonmmcoset/leonapp architecture

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

- Interactive diagram: https://gitdiagram.com/leonmmcoset/leonapp
- Repository: https://github.com/leonmmcoset/leonapp

## Overview

##### Project Type and Purpose
- It is a monolithic full-stack web application (“App Store”) written in PHP 7.4+.
- Uses Bootstrap for UI, MySQL for data storage, file system for app files/images, Composer for dependencies, and an SMTP server for email verification.

##### File Structure
- Top‐level entrypoints: index.php, app.php, api.php, router.php.
- Public web pages: index.php, app.php, download.php, rss.php, tags.php, thanks.php, history_announcements.php.
- Admin module: /admin/*.php
- Developer module: /developer/*.php
- Shared includes: /includes/logger.php, config.php
- Static assets: /css, /js, /scss, /less, /styles.css, /svgs, /webfonts, /sprites
- Data files: /files (uploads), /images (app previews, age_rating SVGs)
- Vendor: /vendor (Composer packages)
- Database schema: app_store.sql
- Email templates: /mail/verification_template.php
- Configuration: config.php, php.ini, nginx.htaccess

##### Key Architectural Patterns
- Monolithic PHP Front Controller pattern via router.php or direct .php entrypoints.
- Logical separation into Public UI, Admin UI, Developer UI.
- Shared services (logging, config, database connection) under /includes.
- File system storage for user‐uploaded binaries and static assets.
- REST-style API endpoints served by api.php.

##### Main Components
a. Client Browsers
- Public users
- App developers
- Admin users
b. Web Server Layer
- Nginx/Apache (nginx.htaccess)
- PHP Interpreter (config.php, router.php + .php pages)
- Composer Autoloader (/vendor)
c. Application Modules
- Public Module (index.php, app.php, download.php, rss.php, tags.php, etc.)
- Admin Module (/admin/*.php)
- Developer Module (/developer/*.php)
- API Layer (api.php)
- Shared Services (/includes/logger.php, config.php, router.php)
- Email Service (mail/verification_template.php → SMTP)
d. Data Storage
- MySQL Database (app_store.sql schema)
- File System:
- /files → uploaded app packages
- /css, /js, /svgs, /webfonts → static assets
e. External Services
- SMTP Server (for email verification)

##### Relationships & Data Flow
- Browsers → HTTP → Web Server → PHP Front Controller or direct .php
- PHP code →
- Queries MySQL (CRUD operations via PDO/mysqli)
- Reads/Writes to file system (/files, /images)
- Sends emails via SMTP (mail/verification_template.php)
- API calls from front‐end or third parties → api.php → same backend services
- Admin/Developer modules share database and file system with Public module

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Layer 1: Clients"
        PublicUser["Public Browser"]:::client
        DevUser["Developer Browser"]:::client
        AdminUser["Admin Browser"]:::client
    end

    subgraph "Layer 2: Web Server"
        WebServer["Nginx/Apache"]:::server
        PHP["PHP Interpreter"]:::server
        ComposerLoader["Composer Autoloader (vendor/)"]:::server
    end

    subgraph "Layer 3: Application Modules"
        subgraph "Public Module"
            idx["index.php"]:::module
            appp["app.php"]:::module
            down["download.php"]:::module
            rss["rss.php"]:::module
            tags["tags.php"]:::module
            thanks["thanks.php"]:::module
            hist["history_announcements.php"]:::module
            devapps["developer_apps.php"]:::module
        end
        subgraph "Admin Module"
            adminIdx["admin/index.php"]:::module
            adminLogin["admin/login.php"]:::module
            adminLogout["admin/logout.php"]:::module
            addapp["admin/addapp.php"]:::module
            editapp["admin/editapp.php"]:::module
            delapp["admin/deleteapp.php"]:::module
            ann["admin/announcements.php"]:::module
            delann["admin/delete_announcement.php"]:::module
            mdev["admin/manage_developers.php"]:::module
            mtags["admin/manage_tags.php"]:::module
            mvers["admin/manage_versions.php"]:::module
            revapps["admin/review_apps.php"]:::module
            sysinfo["admin/system_info.php"]:::module
        end
        subgraph "Developer Module"
            devReg["developer/register.php"]:::module
            devLogin["developer/login.php"]:::module
            devLogOut["developer/logout.php"]:::module
            devDash["developer/dashboard.php"]:::module
            devProf["developer/profile.php"]:::module
            devUp["developer/upload_app.php"]:::module
            devEdit["developer/edit_app.php"]:::module
            devDel["developer/delete_app.php"]:::module
            devVer["developer/version_control.php"]:::module
            devVerEmail["developer/verify_email.php"]:::module
        end
        API["api.php"]:::module
    end

    subgraph "Layer 4: Shared Services"
        Logger["includes/logger.php"]:::shared
        Config["config.php"]:::shared
        Router["router.php"]:::shared
        EmailTemplate["mail/verification_template.php"]:::shared
    end

    subgraph "Layer 5: Data Stores"
        MySQL[(MySQL Database)]:::datastore
        FS["File System\n(files, images, static assets)"]:::datastore
    end

    subgraph "Layer 6: External Service"
        SMTP["SMTP Server"]:::external
    end

    %% Connections
    PublicUser -->|HTTP| WebServer
    DevUser -->|HTTP| WebServer
    AdminUser -->|HTTP| WebServer

    WebServer --> PHP
    PHP --> ComposerLoader

    PHP -->|invoke| idx
    PHP -->|invoke| appp
    PHP -->|invoke| down
    PHP -->|invoke| rss
    PHP -->|invoke| tags
    PHP -->|invoke| thanks
    PHP -->|invoke| hist
    PHP -->|invoke| devapps
    PHP -->|invoke| adminIdx
    PHP -->|invoke| adminLogin
    PHP -->|invoke| adminLogout
    PHP -->|invoke| addapp
    PHP -->|invoke| editapp
    PHP -->|invoke| delapp
    PHP -->|invoke| ann
    PHP -->|invoke| delann
    PHP -->|invoke| mdev
    PHP -->|invoke| mtags
    PHP -->|invoke| mvers
    PHP -->|invoke| revapps
    PHP -->|invoke| sysinfo
    PHP -->|invoke| devReg
    PHP -->|invoke| devLogin
    PHP -->|invoke| devLogOut
    PHP -->|invoke| devDash
    PHP -->|invoke| devProf
    PHP -->|invoke| devUp
    PHP -->|invoke| devEdit
    PHP -->|invoke| devDel
    PHP -->|invoke| devVer
    PHP -->|invoke| devVerEmail
    PHP -->|invoke| API

    %% Modules to Shared Services
    idx --> Logger
    appp --> Logger
    adminIdx --> Logger
    devReg --> Logger
    API --> Logger

    idx --> Config
    appp --> Config
    adminIdx --> Config
    devReg --> Config
    API --> Config

    idx --> Router
    appp --> Router
    adminIdx --> Router
    devReg --> Router
    API --> Router

    %% Modules to Data Stores
    idx -->|SELECT/INSERT| MySQL
    appp -->|SELECT/INSERT| MySQL
    adminIdx -->|SELECT/INSERT| MySQL
    devReg -->|SELECT/INSERT| MySQL
    API -->|SELECT/INSERT| MySQL

    idx -->|Read/Write File| FS
    appp -->|Read/Write File| FS
    devUp -->|Read/Write File| FS

    %% Email Flow
    devReg --> EmailTemplate
    devVerEmail --> EmailTemplate
    EmailTemplate -->|Send Email| SMTP

    %% Static Assets Delivery
    WebServer -->|serves| FS

    %% Click Events
    click idx "https://github.com/leonmmcoset/leonapp/blob/new3/index.php"
    click appp "https://github.com/leonmmcoset/leonapp/blob/new3/app.php"
    click down "https://github.com/leonmmcoset/leonapp/blob/new3/download.php"
    click rss "https://github.com/leonmmcoset/leonapp/blob/new3/rss.php"
    click tags "https://github.com/leonmmcoset/leonapp/blob/new3/tags.php"
    click thanks "https://github.com/leonmmcoset/leonapp/blob/new3/thanks.php"
    click hist "https://github.com/leonmmcoset/leonapp/blob/new3/history_announcements.php"
    click devapps "https://github.com/leonmmcoset/leonapp/blob/new3/developer_apps.php"

    click adminIdx "https://github.com/leonmmcoset/leonapp/blob/new3/admin/index.php"
    click adminLogin "https://github.com/leonmmcoset/leonapp/blob/new3/admin/login.php"
    click adminLogout "https://github.com/leonmmcoset/leonapp/blob/new3/admin/logout.php"
    click addapp "https://github.com/leonmmcoset/leonapp/blob/new3/admin/addapp.php"
    click editapp "https://github.com/leonmmcoset/leonapp/blob/new3/admin/editapp.php"
    click delapp "https://github.com/leonmmcoset/leonapp/blob/new3/admin/deleteapp.php"
    click ann "https://github.com/leonmmcoset/leonapp/blob/new3/admin/announcements.php"
    click delann "https://github.com/leonmmcoset/leonapp/blob/new3/admin/delete_announcement.php"
    click mdev "https://github.com/leonmmcoset/leonapp/blob/new3/admin/manage_developers.php"
    click mtags "https://github.com/leonmmcoset/leonapp/blob/new3/admin/manage_tags.php"
    click mvers "https://github.com/leonmmcoset/leonapp/blob/new3/admin/manage_versions.php"
    click revapps "https://github.com/leonmmcoset/leonapp/blob/new3/admin/review_apps.php"
    click sysinfo "https://github.com/leonmmcoset/leonapp/blob/new3/admin/system_info.php"

    click devReg "https://github.com/leonmmcoset/leonapp/blob/new3/developer/register.php"
    click devLogin "https://github.com/leonmmcoset/leonapp/blob/new3/developer/login.php"
    click devLogOut "https://github.com/leonmmcoset/leonapp/blob/new3/developer/logout.php"
    click devDash "https://github.com/leonmmcoset/leonapp/blob/new3/developer/dashboard.php"
    click devProf "https://github.com/leonmmcoset/leonapp/blob/new3/developer/profile.php"
    click devUp "https://github.com/leonmmcoset/leonapp/blob/new3/developer/upload_app.php"
    click devEdit "https://github.com/leonmmcoset/leonapp/blob/new3/developer/edit_app.php"
    click devDel "https://github.com/leonmmcoset/leonapp/blob/new3/developer/delete_app.php"
    click devVer "https://github.com/leonmmcoset/leonapp/blob/new3/developer/version_control.php"
    click devVerEmail "https://github.com/leonmmcoset/leonapp/blob/new3/developer/verify_email.php"

    click API "https://github.com/leonmmcoset/leonapp/blob/new3/api.php"
    click Logger "https://github.com/leonmmcoset/leonapp/blob/new3/includes/logger.php"
    click Config "https://github.com/leonmmcoset/leonapp/blob/new3/config.php"
    click Router "https://github.com/leonmmcoset/leonapp/blob/new3/router.php"
    click EmailTemplate "https://github.com/leonmmcoset/leonapp/blob/new3/mail/verification_template.php"
    click ComposerLoader "https://github.com/leonmmcoset/leonapp/tree/new3/vendor/"
    click MySQL "https://github.com/leonmmcoset/leonapp/blob/new3/app_store.sql"
    click FS "https://github.com/leonmmcoset/leonapp/tree/new3/css/"

    classDef client fill:#cce5ff,stroke:#004085,color:#004085
    classDef server fill:#e2e3e5,stroke:#6c757d,color:#383d41
    classDef module fill:#d4edda,stroke:#155724,color:#155724
    classDef shared fill:#fff3cd,stroke:#856404,color:#856404
    classDef datastore fill:#ffe5b4,stroke:#cc7a00,color:#663300
    classDef external fill:#f8d7da,stroke:#721c24,color:#721c24
```
