# gautam23145032/streamoid_project architecture

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

- Interactive diagram: https://gitdiagram.com/gautam23145032/streamoid_project
- Repository: https://github.com/gautam23145032/streamoid_project

## Overview

##### Project Type and Purpose
- This is a full-stack, server-rendered web application (“Streamoid Product Catalog”) built with Node.js/Express for the backend, EJS/CSS for the frontend, and MongoDB for persistence.
- Primary use case: allow users to upload product CSV files, validate rows, store valid products in MongoDB, and search/filter the catalog in a clean UI.

##### File Structure
- Top-level:
- public/ → static CSS assets
- views/ → EJS templates (home.ejs)
- src/
– config/db.js → MongoDB connection
– controllers/viewController.js → handles upload, validation, search, render
– middleware/ → Multer upload config + global error handlers
– models/productModel.js → Mongoose schema + indexes
– routes/viewRoutes.js → defines Express routes
– utils/csvValidator.js → per-row validation logic
– app.js → Express app setup (middleware, view engine, static folders)
– server.js → application entry point
- .env → environment variables for DB URI and port
- uploads/ → temporary storage for CSV files
- Pattern: monolithic MVC-style architecture, single Express service.

##### README for Additional Insights
- Confirms the MVC separation: routes → controllers → models
- Details key tech: Multer for file upload, csv-parser for streaming CSV rows, Morgan for logging, dotenv for config.
- Describes error-handling flow (404 and global handlers).

a. Main Components
1. Client Browser (UI):
– EJS-rendered HTML + CSS → CSV upload form, filter/search form, product table
2. Express Server:
– Routes layer (viewRoutes.js)
– Middleware: Multer (upload.js), error handlers (errorMiddleware.js)
– Controllers (viewController.js)
– Utility (csvValidator.js)
3. File Storage:
– Local “uploads/” directory (temporary CSV storage)
4. Database:
5. External Libraries & Services:
– csv-parser, Mongoose, Morgan, dotenv
b. Relationships and Data Flow
- uploads/ → csv-parser → csvValidator → Controller → Mongoose insert → MongoDB
- Controller → delete CSV file → render results back to Browser
- Browser → GET /?filters → Controller builds MongoDB query → Browser receives filtered list
- Global errorMiddleware intercepts failures → returns JSON or error view
c. Architectural Patterns and Principles
- MVC: clear separation of concerns (Views, Controllers, Models)
- Single-process monolith: all modules run in one Node.js instance
- Streaming and backpressure: csv-parser processes row-by-row to avoid memory bloat
- Indexing in DB for query performance
d. Key Technologies & Frameworks
- Node.js + Express.js (server framework)
- EJS (view engine)
- Multer (multipart handling)
- csv-parser (stream CSV)
- Mongoose + MongoDB (ORM + database)
- Morgan (HTTP logging)
- dotenv (environment config)

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Frontend Layer
    subgraph "Frontend Layer"
        Browser["Client Browser\n(EJS HTML + CSS)"]:::frontend
        viewTemplate["home.ejs"]:::view
        css["style.css"]:::static
    end
    Browser -->|renders| viewTemplate
    Browser -->|loads CSS| css
    click viewTemplate "https://github.com/gautam23145032/streamoid_project/blob/main/views/home.ejs"
    click css "https://github.com/gautam23145032/streamoid_project/blob/main/public/style.css"

    %% Backend Layer
    subgraph "Backend Layer"
        app["app.js\nExpress Setup"]:::server
        serverFile["server.js\nEntry Point"]:::server
        dbConfig["db.js\nMongoDB Connection"]:::config
        envFile[".env"]:::config
        routes["viewRoutes.js"]:::routes
        uploadMW["Multer Middleware\n(upload.js)"]:::middleware
        errorMW["Error Middleware\n(errorMiddleware.js)"]:::middleware
        controller["viewController.js"]:::controller
        validator["csvValidator.js"]:::utils
    end
    click app "https://github.com/gautam23145032/streamoid_project/blob/main/src/app.js"
    click serverFile "https://github.com/gautam23145032/streamoid_project/blob/main/src/server.js"
    click dbConfig "https://github.com/gautam23145032/streamoid_project/blob/main/src/config/db.js"
    click envFile "https://github.com/gautam23145032/streamoid_project/blob/main/.env"
    click routes "https://github.com/gautam23145032/streamoid_project/blob/main/src/routes/viewRoutes.js"
    click uploadMW "https://github.com/gautam23145032/streamoid_project/blob/main/src/middleware/upload.js"
    click errorMW "https://github.com/gautam23145032/streamoid_project/blob/main/src/middleware/errorMiddleware.js"
    click controller "https://github.com/gautam23145032/streamoid_project/blob/main/src/controllers/viewController.js"
    click validator "https://github.com/gautam23145032/streamoid_project/blob/main/src/utils/csvValidator.js"

    Browser -->|GET /, POST /upload| routes
    routes -->|apply upload| uploadMW
    routes -->|error handling| errorMW
    uploadMW -->|store file| uploads
    uploads -->|stream| csvParser
    csvParser -->|validate rows| validator
    validator -->|valid rows| controller
    controller -->|insertMany| model
    controller -->|query| model
    model -->|queries| db
    db -->|results| controller
    controller -->|render EJS| Browser
    controller -->|render JSON/error view| errorMW
    errorMW -->|response| Browser

    %% Storage
    subgraph "File Storage"
        uploads["uploads/\n(temp CSV storage)"]:::storage
    end

    %% Database
    subgraph "Database"
        db["MongoDB\n(Product Collection)"]:::database
        model["productModel.js"]:::model
    end
    click model "https://github.com/gautam23145032/streamoid_project/blob/main/src/models/productModel.js"

    %% External Libraries
    subgraph "External Libraries"
        csvParser["csv-parser"]:::external
        mongoose["Mongoose"]:::external
        morgan["Morgan"]:::external
        dotenvLib["dotenv"]:::external
    end
    csvParser -.-> uploads
    mongoose -.-> model
    mongoose -.-> dbConfig
    morgan -.-> app
    dotenvLib -.-> envFile
    dotenvLib -.-> serverFile

    classDef frontend fill:#D4C2FC,stroke:#5B2C6F,color:#1C2833;
    classDef view fill:#A3E4D7,stroke:#117864;
    classDef static fill:#F9E79F,stroke:#B7950B;
    classDef server fill:#AED6F1,stroke:#1B4F72;
    classDef config fill:#F5CBA7,stroke:#B9770E;
    classDef routes fill:#D5F5E3,stroke:#148F77;
    classDef middleware fill:#FADBD8,stroke:#C0392B;
    classDef controller fill:#EBDEF0,stroke:#6C3483;
    classDef utils fill:#E8DAEF,stroke:#7D3C98;
    classDef model fill:#FCF3CF,stroke:#B7950B;
    classDef storage fill:#FDEBD0,stroke:#B9770E;
    classDef database fill:#D6EAF8,stroke:#1F618D;
    classDef external fill:#E5E8E8,stroke:#566573;
```
