# macalistair1/sex_actions_app architecture

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

- Interactive diagram: https://gitdiagram.com/macalistair1/sex_actions_app
- Repository: https://github.com/macalistair1/sex_actions_app

## Overview

##### Project type and purpose
- This is a full-stack, monolithic web application with both RESTful HTTP APIs and real-time (WebSocket) capabilities.
- Purpose: an online interactive “sex actions” game/platform where users authenticate, interact via messages, media and game actions, file uploads, blocking, complaints, and receive email notifications.

##### File structure
- Entry points: app.js or server.js
- config/: application-wide configuration (database, Passport strategies)
- routes/: HTTP endpoint definitions (split by feature)
- controllers/: business logic for each resource (user, message, action, etc.)
- middleware/authenticate.js: JWT-based auth gating
- models/: Sequelize ORM models mapping to MySQL tables
- services/emailService.js: Nodemailer wrapper for sending mail
- socket.js: WebSocket (likely Socket.IO) setup for real-time interactions
- utils/validation.js: shared input-validation logic
- uploads/: local media storage for user-uploaded files

##### README for additional insights
- Tech stack: Node.js/Express, MySQL via Sequelize, JWT for auth, Passport for social login, Nodemailer, Express Validator, Bcrypt.
- Features call out key domains: auth, messaging, action requests, blocking, complaints, email notifications, real-time gaming.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Presentation Layer
    subgraph "Presentation Layer"
        direction TB
        Client["Web/Mobile Client"]:::client
        Static["Static Client Entry<br/>(index.html)"]:::client
    end

    %% Backend Application
    subgraph "Backend Application"
        direction TB
        Entry["HTTP Server<br/>(app.js / server.js)"]:::backend
        Config["Configuration<br/>(config/)"]:::backend
        Middleware["Auth Middleware<br/>(JWT)"]:::backend
        subgraph "REST API Layer"
            direction TB
            AuthRoutes["Auth Routes"]:::backend
            UserRoutes["User Routes"]:::backend
            ProfileRoutes["Profile Routes"]:::backend
            MessageRoutes["Message Routes"]:::backend
            ActionRoutes["Action Routes"]:::backend
            RequestRoutes["Request Routes"]:::backend
            BlockRoutes["Block Routes"]:::backend
            ComplaintRoutes["Complaint Routes"]:::backend
        end
        subgraph "Controller Layer"
            direction TB
            AuthController["Auth Controller"]:::backend
            UserController["User Controller"]:::backend
            ProfileController["Profile Controller"]:::backend
            MessageController["Message Controller"]:::backend
            ActionController["Action Controller"]:::backend
            RequestController["Request Controller"]:::backend
            BlockController["Block Controller"]:::backend
            ComplaintController["Complaint Controller"]:::backend
        end
        subgraph "Services & Utils"
            direction TB
            EmailService["Email Service<br/>(Nodemailer)"]:::backend
            Validation["Validation Utilities"]:::backend
            RealTime["Real-time Engine<br/>(Socket.IO)"]:::backend
            Uploads["File Storage<br/>(uploads/)"]:::backend
        end
        subgraph "Data Access Layer"
            direction TB
            ModelsIndex["Sequelize Initializer"]:::backend
            UserModel["User Model"]:::backend
            MessageModel["Message Model"]:::backend
            ActionModel["Action Model"]:::backend
            RequestModel["Request Model"]:::backend
            BlockModel["Block Model"]:::backend
            ComplaintModel["Complaint Model"]:::backend
        end
    end

    %% Data Layer
    DB["MySQL Database"]:::db

    %% External Services
    subgraph "External Services"
        direction TB
        OAuth["OAuth Providers<br/>(Google, Facebook, Apple)"]:::external
        SMTP["SMTP Server"]:::external
    end

    %% Connections
    Client -->|"loads"| Static
    Client -->|"HTTP REST"| Entry
    Entry --> Config
    Entry --> AuthRoutes
    Entry --> UserRoutes
    Entry --> ProfileRoutes
    Entry --> MessageRoutes
    Entry --> ActionRoutes
    Entry --> RequestRoutes
    Entry --> BlockRoutes
    Entry --> ComplaintRoutes
    AuthRoutes --> Middleware
    UserRoutes --> Middleware
    ProfileRoutes --> Middleware
    MessageRoutes --> Middleware
    ActionRoutes --> Middleware
    RequestRoutes --> Middleware
    BlockRoutes --> Middleware
    ComplaintRoutes --> Middleware
    Middleware --> AuthController
    AuthController --> UserController
    AuthController -->|"issues JWT"| Client
    UserController --> ModelsIndex
    ProfileController --> ModelsIndex
    MessageController --> ModelsIndex
    ActionController --> ModelsIndex
    RequestController --> ModelsIndex
    BlockController --> ModelsIndex
    ComplaintController --> ModelsIndex
    ModelsIndex --> DB
    UserModel --> ModelsIndex
    MessageModel --> ModelsIndex
    ActionModel --> ModelsIndex
    RequestModel --> ModelsIndex
    BlockModel --> ModelsIndex
    ComplaintModel --> ModelsIndex
    AuthController --> OAuth
    RealTime --> AuthController
    Client -->|"WebSocket"| RealTime
    AuthController --> EmailService
    EmailService --> SMTP
    Client -->|"Upload File"| Uploads

    %% Click Events
    click Entry "https://github.com/macalistair1/sex_actions_app/blob/main/app.js"
    click Entry "https://github.com/macalistair1/sex_actions_app/blob/main/server.js"
    click Config "https://github.com/macalistair1/sex_actions_app/blob/main/config/config.js"
    click Config "https://github.com/macalistair1/sex_actions_app/blob/main/config/passport.js"
    click Middleware "https://github.com/macalistair1/sex_actions_app/blob/main/middleware/authenticate.js"
    click AuthRoutes "https://github.com/macalistair1/sex_actions_app/blob/main/routes/auth.js"
    click UserRoutes "https://github.com/macalistair1/sex_actions_app/blob/main/routes/user.js"
    click ProfileRoutes "https://github.com/macalistair1/sex_actions_app/blob/main/routes/profile.js"
    click MessageRoutes "https://github.com/macalistair1/sex_actions_app/blob/main/routes/message.js"
    click ActionRoutes "https://github.com/macalistair1/sex_actions_app/blob/main/routes/action.js"
    click RequestRoutes "https://github.com/macalistair1/sex_actions_app/blob/main/routes/request.js"
    click BlockRoutes "https://github.com/macalistair1/sex_actions_app/blob/main/routes/block.js"
    click ComplaintRoutes "https://github.com/macalistair1/sex_actions_app/blob/main/routes/complaint.js"
    click AuthController "https://github.com/macalistair1/sex_actions_app/blob/main/controllers/authController.js"
    click UserController "https://github.com/macalistair1/sex_actions_app/blob/main/controllers/userController.js"
    click ProfileController "https://github.com/macalistair1/sex_actions_app/blob/main/controllers/profileController.js"
    click MessageController "https://github.com/macalistair1/sex_actions_app/blob/main/controllers/messageController.js"
    click ActionController "https://github.com/macalistair1/sex_actions_app/blob/main/controllers/actionController.js"
    click RequestController "https://github.com/macalistair1/sex_actions_app/blob/main/controllers/requestController.js"
    click BlockController "https://github.com/macalistair1/sex_actions_app/blob/main/controllers/blockController.js"
    click ComplaintController "https://github.com/macalistair1/sex_actions_app/blob/main/controllers/complaintController.js"
    click UserModel "https://github.com/macalistair1/sex_actions_app/blob/main/models/user.js"
    click MessageModel "https://github.com/macalistair1/sex_actions_app/blob/main/models/message.js"
    click ActionModel "https://github.com/macalistair1/sex_actions_app/blob/main/models/action.js"
    click RequestModel "https://github.com/macalistair1/sex_actions_app/blob/main/models/request.js"
    click BlockModel "https://github.com/macalistair1/sex_actions_app/blob/main/models/block.js"
    click ComplaintModel "https://github.com/macalistair1/sex_actions_app/blob/main/models/complaint.js"
    click ModelsIndex "https://github.com/macalistair1/sex_actions_app/blob/main/models/index.js"
    click RealTime "https://github.com/macalistair1/sex_actions_app/blob/main/socket.js"
    click EmailService "https://github.com/macalistair1/sex_actions_app/blob/main/services/emailService.js"
    click Validation "https://github.com/macalistair1/sex_actions_app/blob/main/utils/validation.js"
    click Static "https://github.com/macalistair1/sex_actions_app/blob/main/index.html"
    click Uploads "https://github.com/macalistair1/sex_actions_app/tree/main/uploads/"

    %% Styles
    classDef client fill:#E3F2FD,stroke:#90CAF9,color:#0D47A1
    classDef backend fill:#BBDEFB,stroke:#1E88E5,color:#0D47A1
    classDef db fill:#C8E6C9,stroke:#43A047,color:#1B5E20
    classDef external fill:#E0E0E0,stroke:#9E9E9E,color:#424242
```
