# progettotecweb/squealer architecture

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

- Interactive diagram: https://gitdiagram.com/progettotecweb/squealer
- Repository: https://github.com/progettotecweb/squealer

## Overview

##### Project Type and Purpose
- This is a monorepo hosting a full-stack social-media platform (“Squealer”) plus two admin dashboards:
- SquealerApp: a user-facing Next.js (React) application
- Squealer SMM Dashboard: a Vue.js analytics/marketing dashboard
- Squealer Moderator Dashboard: a pure-JS moderator interface
- It also contains:
- A Node.js/Express backend (under `server/`) exposing REST routes for users, channels, notifications, subscriptions, etc.
- A MongoDB access layer (under `db/`), with JS wrappers and JSON fixtures.
- Utility scripts (bots, AI pipeline, Python startup script), static assets, Docker and Nginx configs.

##### File Structure
- Top-level directories separate concerns:
- `SquealerApp/` (Next.js) – React pages & API routes, custom hooks, components, styling, authentication.
- `SquealerSMMDashboard/` (Vue/Vite) – SMM analytics for social media managers.
- `SquealerModeratorDashboard/` – static HTML/JS for moderators.
- `server/` – Express server with routers: `usersRouter.js`, `channelsRouter.js`, `squealsRouter.js`, `subscriptionRouter.js`, plus `notifications/`.
- `db/` – Mongo connection and data access logic; JSON backups/fixtures.
- `bots/` & `AI/` – automation scripts and AI pipeline module.
- `nginx/` – reverse-proxy config.
- `docker-compose.yaml` – container definitions (frontend, backend, MongoDB, nginx, etc.).

##### README Insights
- Confirms three front-end apps built with different stacks (React/Vue/js).

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Clients
    Users["Users (Web)"]:::client
    SMM["Social Media Managers"]:::client
    Mods["Moderators"]:::client

    %% Infrastructure
    Nginx["Nginx Reverse Proxy"]:::infra
    Docker["Docker Compose"]:::infra

    %% Frontend Applications
    subgraph "Front-End Layer"
        SquealerApp["SquealerApp (Next.js)"]:::frontend
        SquealerSMMDashboard["Squealer SMM Dashboard (Vue.js)"]:::frontend
        SquealerModeratorDashboard["Squealer Moderator Dashboard (Static JS/HTML)"]:::frontend
    end

    %% Backend Services
    subgraph "API Layer"
        NextAPI["Next.js API Routes"]:::api
        ExpressServer["Express API Server"]:::api
        UsersRouter["usersRouter.js"]:::api
        ChannelsRouter["channelRouter.js"]:::api
        SquealsRouter["squealsRouter.js"]:::api
        SubscriptionRouter["subscriptionRouter.js"]:::api
        NotificationsModule["notifications.js"]:::api
        ServerEntry["server.js"]:::api
    end

    %% Database
    DB["MongoDB Database"]:::db
    MongoConn["mongo.js"]:::db
    DBWrappers["db/*.js & db/*.json"]:::db

    %% Automation & Utils
    subgraph "Automation & Utilities"
        Bots["Bots (Automation Scripts)"]:::auto
        AIPipeline["AI Pipeline Module"]:::auto
        ResetDB["resetdb.js"]:::auto
        StartupPy["start.py"]:::auto
        Utils["Shared Utilities"]:::auto
    end

    %% Connections
    Users --> Nginx
    SMM --> Nginx
    Mods --> Nginx

    Nginx --> SquealerApp
    Nginx --> SquealerSMMDashboard
    Nginx --> SquealerModeratorDashboard
    Nginx --> ExpressServer

    SquealerApp --> NextAPI
    NextAPI --> ExpressServer

    SquealerSMMDashboard --> ExpressServer
    SquealerModeratorDashboard --> ExpressServer

    ExpressServer --> UsersRouter
    ExpressServer --> ChannelsRouter
    ExpressServer --> SquealsRouter
    ExpressServer --> SubscriptionRouter
    ExpressServer --> NotificationsModule

    ExpressServer --> DB
    DB --> MongoConn
    DB --> DBWrappers

    Bots --> ExpressServer
    Bots --> DB

    AIPipeline --> ExpressServer
    AIPipeline --> DB

    ResetDB --> DB
    StartupPy --> ExpressServer

    Utils --> SquealerApp
    Utils --> SquealerSMMDashboard
    Utils --> ExpressServer
    Utils --> Bots
    Utils --> AIPipeline

    Docker --> Nginx
    Docker --> SquealerApp
    Docker --> SquealerSMMDashboard
    Docker --> SquealerModeratorDashboard
    Docker --> ExpressServer
    Docker --> DB
    Docker --> Bots
    Docker --> AIPipeline

    %% Click Events
    click SquealerApp "https://github.com/progettotecweb/squealer/tree/squeals/SquealerApp/"
    click SquealerSMMDashboard "https://github.com/progettotecweb/squealer/tree/squeals/SquealerSMMDashboard/"
    click SquealerModeratorDashboard "https://github.com/progettotecweb/squealer/tree/squeals/SquealerModeratorDashboard/"
    click ExpressServer "https://github.com/progettotecweb/squealer/tree/squeals/server/"
    click UsersRouter "https://github.com/progettotecweb/squealer/blob/squeals/server/usersRouter.js"
    click ChannelsRouter "https://github.com/progettotecweb/squealer/blob/squeals/server/channelRouter.js"
    click SquealsRouter "https://github.com/progettotecweb/squealer/blob/squeals/server/squealsRouter.js"
    click SubscriptionRouter "https://github.com/progettotecweb/squealer/blob/squeals/server/subscriptionRouter.js"
    click NotificationsModule "https://github.com/progettotecweb/squealer/blob/squeals/server/notifications/notifications.js"
    click ServerEntry "https://github.com/progettotecweb/squealer/blob/squeals/server/server.js"
    click MongoConn "https://github.com/progettotecweb/squealer/blob/squeals/db/mongo.js"
    click DBWrappers "https://github.com/progettotecweb/squealer/tree/squeals/db/"
    click Bots "https://github.com/progettotecweb/squealer/tree/squeals/bots/"
    click AIPipeline "https://github.com/progettotecweb/squealer/blob/squeals/AI/pipeline.mjs"
    click ResetDB "https://github.com/progettotecweb/squealer/blob/squeals/resetdb.js"
    click StartupPy "https://github.com/progettotecweb/squealer/blob/squeals/start.py"
    click Docker "https://github.com/progettotecweb/squealer/blob/squeals/docker-compose.yaml"
    click Nginx "https://github.com/progettotecweb/squealer/blob/squeals/nginx/default_https.conf"
    click Utils "https://github.com/progettotecweb/squealer/blob/squeals/utils/utils.js"

    %% Styles
    classDef client fill:#e0f7fa,stroke:#006064,color:#004d40;
    classDef frontend fill:#bbdefb,stroke:#0d47a1,color:#0d47a1;
    classDef api fill:#c8e6c9,stroke:#1b5e20,color:#1b5e20;
    classDef db fill:#fff9c4,stroke:#f57f17,color:#f57f17;
    classDef auto fill:#ffe0b2,stroke:#e65100,color:#e65100;
    classDef infra fill:#eceff1,stroke:#37474f,color:#37474f;
```
