# kashisharora9462/confirmo architecture

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

- Interactive diagram: https://gitdiagram.com/kashisharora9462/confirmo
- Repository: https://github.com/kashisharora9462/confirmo

## Overview

##### Project type and purpose
- This is a full-stack web application (“Confirmo”) for one-click document verification using image steganography.
- Backend: Node.js + Express API that digitizes documents, embeds validity bits in image pixels, stores metadata, and exposes verification endpoints.
- Frontend: React (Vite + Tailwind) single-page app for users and organizations to upload, verify, register, log in, and view reports.

##### File structure
- Top-level split into two folders:
– server/ : Express app
– web-app/ : React client
- server/src: layered MVC-like organization
– app.js, index.js: Express setup & server bootstrap
– controllers/: document.controller.js, email.controller.js, organization.controller.js
– routes/: document.router.js, organization.router.js
– middlewares/: auth (JWT), multer (file uploads)
– db/: connect.js (Mongoose/MongoDB), *.model.js (schema definitions)
– utils/: EncryptData, DecryptData (steganography logic)
- web-app/src:
– main.jsx, App.jsx: React entry & root
– components/: Login, Register, Digitize, Verify, About, Spinner
– assets/: static media
– index.html & public/: static hosting
- Config/build files: package.json, vite.config.js, tailwind.config.js

##### README for architecture hints
- Describes core feature: embedding validity in RGB bits (“image steganography”)
- Mentions digitization, verification, reporting, portability

##### Detail
- Every layer: from HTTP listener to middleware to controllers to models
- Steganography utilities as a distinct service within the API tier
- Email/SMS provider integration if used

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Presentation Tier
    subgraph "Presentation Tier" 
        direction TB
        Browser["Browser (User)"]:::external
        SPA["React SPA"]:::frontend
        EntryMain["main.jsx"]:::frontend
        EntryApp["App.jsx"]:::frontend
        subgraph "UI Components"
            direction TB
            Login["Login.jsx"]:::frontend
            Register["Register.jsx"]:::frontend
            Digitize["Digitize.jsx"]:::frontend
            Verify["Verify.jsx"]:::frontend
            About["About.jsx"]:::frontend
            Spinner["Spinner.jsx"]:::frontend
        end
        Assets["assets/"]:::frontend
        Styles["index.css"]:::frontend
    end

    %% Application Tier
    subgraph "Application Tier"
        direction TB
        ExpressApp["Express API"]:::backend
        AppJS["app.js"]:::backend
        IndexJS["index.js"]:::backend
        subgraph "Routes"
            direction TB
            DocRoute["document.router.js"]:::backend
            OrgRoute["organization.router.js"]:::backend
        end
        subgraph "Controllers"
            direction TB
            DocCtrl["document.controller.js"]:::backend
            OrgCtrl["organization.controller.js"]:::backend
            EmailCtrl["email.controller.js"]:::backend
        end
        subgraph "Middlewares"
            direction TB
            AuthMW["auth.middleware.js"]:::backend
            MulterMW["multer.middleware.js"]:::backend
        end
        subgraph "Utilities (Steganography)"
            direction TB
            Encrypt["EncryptData.js"]:::backend
            Decrypt["DecryptData.js"]:::backend
        end
        subgraph "Database Layer"
            direction TB
            DBConnect["connect.js"]:::backend
            DocModel["documents.model.js"]:::backend
            OrgModel["organization.model.js"]:::backend
        end
        FileStorage["server/public/, server/Output/"]:::backend
        SMTP["SMTP Email Service"]:::external
    end

    %% Data Tier
    subgraph "Data Tier"
        direction TB
        MongoDB["MongoDB"]:::database
    end

    %% Connections
    Browser -->|uses| SPA
    SPA -->|HTTP Requests| ExpressApp
    EntryMain -->|imports| SPA
    EntryApp -->|imports| SPA
    SPA -->|renders| Login
    SPA -->|renders| Register
    SPA -->|renders| Digitize
    SPA -->|renders| Verify
    SPA -->|renders| About
    SPA -->|renders| Spinner
    SPA -->|loads assets/styles| Assets
    SPA -->|loads assets/styles| Styles

    ExpressApp -->|bootstraps| AppJS
    ExpressApp -->|bootstraps| IndexJS
    AppJS -->|uses routes| DocRoute
    AppJS -->|uses routes| OrgRoute
    DocRoute -->|calls| DocCtrl
    OrgRoute -->|calls| OrgCtrl
    ExpressApp -->|uses middleware| AuthMW
    ExpressApp -->|uses middleware| MulterMW
    DocCtrl -->|uses| Encrypt
    DocCtrl -->|uses| Decrypt
    DocCtrl -->|interacts| DocModel
    OrgCtrl -->|interacts| OrgModel
    EmailCtrl -->|sends via| SMTP
    DocCtrl -->|may trigger| EmailCtrl
    DocModel -->|connects via| DBConnect
    OrgModel -->|connects via| DBConnect
    DBConnect -->|connects to| MongoDB
    MulterMW -->|stores files to| FileStorage
    Encrypt -->|reads/writes| FileStorage
    Decrypt -->|reads| FileStorage

    %% Click Events
    click EntryMain "https://github.com/kashisharora9462/confirmo/blob/main/web-app/src/main.jsx"
    click EntryApp "https://github.com/kashisharora9462/confirmo/blob/main/web-app/src/App.jsx"
    click Login "https://github.com/kashisharora9462/confirmo/blob/main/web-app/src/components/Login.jsx"
    click Register "https://github.com/kashisharora9462/confirmo/blob/main/web-app/src/components/Register.jsx"
    click Digitize "https://github.com/kashisharora9462/confirmo/blob/main/web-app/src/components/Digitize.jsx"
    click Verify "https://github.com/kashisharora9462/confirmo/blob/main/web-app/src/components/Verify.jsx"
    click About "https://github.com/kashisharora9462/confirmo/blob/main/web-app/src/components/About.jsx"
    click Spinner "https://github.com/kashisharora9462/confirmo/blob/main/web-app/src/components/Spinner.jsx"
    click Assets "https://github.com/kashisharora9462/confirmo/tree/main/web-app/src/assets/"
    click Styles "https://github.com/kashisharora9462/confirmo/blob/main/web-app/src/index.css"
    click AppJS "https://github.com/kashisharora9462/confirmo/blob/main/server/src/app.js"
    click IndexJS "https://github.com/kashisharora9462/confirmo/blob/main/server/src/index.js"
    click DocRoute "https://github.com/kashisharora9462/confirmo/blob/main/server/src/routes/document.router.js"
    click OrgRoute "https://github.com/kashisharora9462/confirmo/blob/main/server/src/routes/organization.router.js"
    click DocCtrl "https://github.com/kashisharora9462/confirmo/blob/main/server/src/controllers/document.controller.js"
    click OrgCtrl "https://github.com/kashisharora9462/confirmo/blob/main/server/src/controllers/organization.controller.js"
    click EmailCtrl "https://github.com/kashisharora9462/confirmo/blob/main/server/src/controllers/email.controller.js"
    click AuthMW "https://github.com/kashisharora9462/confirmo/blob/main/server/src/middlewares/auth.middleware.js"
    click MulterMW "https://github.com/kashisharora9462/confirmo/blob/main/server/src/middlewares/multer.middleware.js"
    click Encrypt "https://github.com/kashisharora9462/confirmo/blob/main/server/src/utils/EncryptData.js"
    click Decrypt "https://github.com/kashisharora9462/confirmo/blob/main/server/src/utils/DecryptData.js"
    click DBConnect "https://github.com/kashisharora9462/confirmo/blob/main/server/src/db/connect.js"
    click DocModel "https://github.com/kashisharora9462/confirmo/blob/main/server/src/db/documents.model.js"
    click OrgModel "https://github.com/kashisharora9462/confirmo/blob/main/server/src/db/organization.model.js"

    %% Styles
    classDef frontend fill:#D0E8FF,stroke:#0366D6,color:#0366D6
    classDef backend fill:#E0FFE0,stroke:#028A0F,color:#028A0F
    classDef database fill:#FFE4B3,stroke:#E68400,color:#E68400
    classDef external fill:#F0E0FF,stroke:#9B31FF,color:#9B31FF
```
