# purvaagine/campus-connect architecture

> Architecture diagram of the GitHub repository purvaagine/campus-connect, 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/purvaagine/campus-connect
- Repository: https://github.com/purvaagine/campus-connect

## Overview

##### Project type and purpose
- This is a full-stack auction/bidding web application.
- Frontend: a React single-page app (in /client) for browsing products, placing bids, managing your profile, and viewing notifications.
- Backend: an Express/Node API server (in /server) that handles authentication, product and bid management, notifications, and image uploads via Cloudinary.
- Database: likely MongoDB (inferred from model folder naming conventions).

##### File structure
- Top-level folders:
- /client – React UI and state management (Redux)
- /server – API, middleware, data models, configuration
- Key patterns:
- Frontend follows a “pages” + “components” + “apicalls” + “redux” slice structure.
- Backend follows an MVC-style separation: models, routes (controllers), middleware, config.
- Config & tooling:
- nodemon.json – dev hot-reload for the server
- Tailwind CSS config in the client
- Cloudinary config in server/config/cloudinaryConfig.js
- DB config in server/config/dbConfig.js
- Authentication middleware in server/middlewares/authMiddleware.js

##### (empty) README for hints
- No extra constraints; follow best practices for full-stack web apps.

a. Main components
1. React Frontend
- Pages: Home, Login, Register, ProductInfo, Admin, Profile (with nested sub-pages)
- State: Redux store with usersSlice (handles user auth/session)
- API Layer: Axios instances and modules for users, products, bids, notifications
2. Express Backend
- Routes/Controllers: usersRoute, productsRoute, bidsRoute, notificationsRoute
- Models: userModel, productModel, bidModel, notificationsModel
- Middleware: authMiddleware (JWT-based auth guard)
- Config: dbConfig (connect to MongoDB), cloudinaryConfig (upload images)
3. Database
- MongoDB collections: users, products, bids, notifications
4. External Services
- Cloudinary (image storage & CDN)
- Optional: Email/SMS for notifications (if integrated)
b. Relationships & interactions
- Frontend → Backend: HTTP(S) REST calls via Axios
- Login/Register → POST /api/users
- Fetch products → GET /api/products
- Bid → POST /api/bids
- Get notifications → GET /api/notifications
- Backend → Database: CRUD operations on collections via Mongoose models
- Backend → Cloudinary: upload/download product images
c. Architectural patterns & design principles
- Separation of concerns: UI vs. application logic vs. data access
- MVC (on the server): models, controllers (routes), middleware
- Client-side state management: Redux slices
- API-first design: clear REST endpoints
- Layered architecture: presentation (React), business (Express routes & middleware), data (MongoDB)
d. Key technologies/frameworks
- Frontend: React, Redux, Axios, Tailwind CSS
- Backend: Node.js, Express, Mongoose (implied), Cloudinary SDK, JSON Web Tokens
- Dev tooling: nodemon, jest/react-testing (App.test.js), create-react-app base

##### Diagramming conventions
- Blue for frontend,
- Green for backend,
- Orange for data/external services.

##### Detail checklist
- User roles if needed (admin vs. regular user flows).
- Middleware responsibilities (e.g., JWT validation).

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Presentation Layer
    subgraph "Presentation Layer"
        direction TB
        ReactApp["React Frontend"]:::frontend
        Index["Index.js"]:::frontend
        AppComp["App.js"]:::frontend
        APIGroup["API Layer"]:::frontend
        AxiosInst["axiosInstance.js"]:::frontend
        UsersAPI["users.js"]:::frontend
        ProductsAPI["products.js"]:::frontend
        NotificationsAPI["notifications.js"]:::frontend
        ReduxStore["Redux Store"]:::frontend
        UsersSlice["usersSlice.js"]:::frontend

        subgraph "Pages" 
            direction TB
            HomePage["Home/index.js"]:::frontend
            HomeFilter["Home/filters.js"]:::frontend
            LoginPage["Login/index.js"]:::frontend
            RegisterPage["Register/index.js"]:::frontend
            ProductInfo["ProductInfo/index.js"]:::frontend
            BidModal["BidModal.js"]:::frontend
            AdminPage["Admin/index.js"]:::frontend
            AdminProducts["Admin/products.js"]:::frontend
            AdminUsers["Admin/users.js"]:::frontend
            ProfilePage["Profile/index.js"]:::frontend
            ProfileProducts["Profile/Products/index.js"]:::frontend
            ProfileBids["Profile/Products/Bids.js"]:::frontend
            ProfileImages["Profile/Products/Images.js"]:::frontend
            ProfileForm["Profile/Products/ProductsForm.js"]:::frontend
            UserBids["Profile/UserBids/index.js"]:::frontend
        end

        subgraph "Shared Components"
            Protected["ProtectedPage.js"]:::frontend
            NotificationsComp["Notifications.js"]:::frontend
            Divider["Divider.js"]:::frontend
        end

        Tailwind["tailwind.config.js"]:::frontend

        ReactApp --> Index
        ReactApp --> AppComp
        ReactApp --> ReduxStore
        ReduxStore --> UsersSlice
        ReactApp --> APIGroup
        APIGroup --> AxiosInst
        AxiosInst --> UsersAPI
        AxiosInst --> ProductsAPI
        AxiosInst --> NotificationsAPI
        ReactApp --> HomePage
        ReactApp --> LoginPage
        ReactApp --> RegisterPage
        ReactApp --> ProductInfo
        ReactApp --> AdminPage
        ReactApp --> ProfilePage
        ReactApp --> Protected
        ReactApp --> NotificationsComp
        ReactApp --> Divider
    end

    %% Application Layer
    subgraph "Application Layer"
        direction TB
        ExpressServer["Express Server (server.js)"]:::backend
        AuthMW["authMiddleware.js"]:::backend
        DBConfig["dbConfig.js"]:::backend
        CloudConfig["cloudinaryConfig.js"]:::backend

        subgraph "Routes/Controllers"
            direction TB
            UsersRoute["usersRoute.js"]:::backend
            ProductsRoute["productsRoute.js"]:::backend
            BidsRoute["bidsRoute.js"]:::backend
            NotificationsRoute["notificationsRoute.js"]:::backend
        end

        subgraph "Models"
            direction TB
            UserModel["userModel.js"]:::backend
            ProductModel["productModel.js"]:::backend
            BidModel["bidModel.js"]:::backend
            NotificationsModel["notificationsModel.js"]:::backend
        end

        ExpressServer --> AuthMW
        ExpressServer --> DBConfig
        ExpressServer --> CloudConfig
        ExpressServer --> UsersRoute
        ExpressServer --> ProductsRoute
        ExpressServer --> BidsRoute
        ExpressServer --> NotificationsRoute
        UsersRoute --> UserModel
        ProductsRoute --> ProductModel
        BidsRoute --> BidModel
        NotificationsRoute --> NotificationsModel
    end

    %% Data Layer
    subgraph "Data Layer"
        direction TB
        MongoDB["MongoDB"]:::data
        Cloudinary["Cloudinary"]:::data
    end

    %% Cross-layer Interactions
    ReduxStore -->|dispatch/subscribe| ProductsAPI
    ProductsAPI -->|HTTP REST| ExpressServer
    UsersAPI -->|HTTP REST| ExpressServer
    BidsAPI["bids.js"]:::frontend -->|HTTP REST| ExpressServer
    NotificationsAPI -->|HTTP REST| ExpressServer

    ExpressServer -->|CRUD| MongoDB
    ExpressServer -->|Image Upload| Cloudinary

    %% Click Events - Presentation
    click ReactApp "https://github.com/purvaagine/campus-connect/tree/main/client/"
    click Index "https://github.com/purvaagine/campus-connect/blob/main/client/src/index.js"
    click AppComp "https://github.com/purvaagine/campus-connect/blob/main/client/src/App.js"
    click AxiosInst "https://github.com/purvaagine/campus-connect/blob/main/client/src/apicalls/axiosInstance.js"
    click UsersAPI "https://github.com/purvaagine/campus-connect/blob/main/client/src/apicalls/users.js"
    click ProductsAPI "https://github.com/purvaagine/campus-connect/blob/main/client/src/apicalls/products.js"
    click NotificationsAPI "https://github.com/purvaagine/campus-connect/blob/main/client/src/apicalls/notifications.js"
    click ReduxStore "https://github.com/purvaagine/campus-connect/blob/main/client/src/redux/store.js"
    click UsersSlice "https://github.com/purvaagine/campus-connect/blob/main/client/src/redux/usersSlice.js"
    click HomePage "https://github.com/purvaagine/campus-connect/blob/main/client/src/pages/Home/index.js"
    click HomeFilter "https://github.com/purvaagine/campus-connect/blob/main/client/src/pages/Home/filters.js"
    click LoginPage "https://github.com/purvaagine/campus-connect/blob/main/client/src/pages/Login/index.js"
    click RegisterPage "https://github.com/purvaagine/campus-connect/blob/main/client/src/pages/Register/index.js"
    click ProductInfo "https://github.com/purvaagine/campus-connect/blob/main/client/src/pages/ProductInfo/index.js"
    click BidModal "https://github.com/purvaagine/campus-connect/blob/main/client/src/pages/ProductInfo/BidModal.js"
    click AdminPage "https://github.com/purvaagine/campus-connect/blob/main/client/src/pages/Admin/index.js"
    click AdminProducts "https://github.com/purvaagine/campus-connect/blob/main/client/src/pages/Admin/products.js"
    click AdminUsers "https://github.com/purvaagine/campus-connect/blob/main/client/src/pages/Admin/users.js"
    click ProfilePage "https://github.com/purvaagine/campus-connect/blob/main/client/src/pages/Profile/index.js"
    click ProfileProducts "https://github.com/purvaagine/campus-connect/blob/main/client/src/pages/Profile/Products/index.js"
    click ProfileBids "https://github.com/purvaagine/campus-connect/blob/main/client/src/pages/Profile/Products/Bids.js"
    click ProfileImages "https://github.com/purvaagine/campus-connect/blob/main/client/src/pages/Profile/Products/Images.js"
    click ProfileForm "https://github.com/purvaagine/campus-connect/blob/main/client/src/pages/Profile/Products/ProductsForm.js"
    click UserBids "https://github.com/purvaagine/campus-connect/blob/main/client/src/pages/Profile/UserBids/index.js"
    click Protected "https://github.com/purvaagine/campus-connect/blob/main/client/src/components/ProtectedPage.js"
    click NotificationsComp "https://github.com/purvaagine/campus-connect/blob/main/client/src/components/Notifications.js"
    click Divider "https://github.com/purvaagine/campus-connect/blob/main/client/src/components/Divider.js"
    click Tailwind "https://github.com/purvaagine/campus-connect/blob/main/client/tailwind.config.js"

    %% Click Events - Application
    click ExpressServer "https://github.com/purvaagine/campus-connect/blob/main/server/server.js"
    click AuthMW "https://github.com/purvaagine/campus-connect/blob/main/server/middlewares/authMiddleware.js"
    click DBConfig "https://github.com/purvaagine/campus-connect/blob/main/server/config/dbConfig.js"
    click CloudConfig "https://github.com/purvaagine/campus-connect/blob/main/server/config/cloudinaryConfig.js"
    click UsersRoute "https://github.com/purvaagine/campus-connect/blob/main/server/routes/usersRoute.js"
    click ProductsRoute "https://github.com/purvaagine/campus-connect/blob/main/server/routes/productsRoute.js"
    click BidsRoute "https://github.com/purvaagine/campus-connect/blob/main/server/routes/bidsRoute.js"
    click NotificationsRoute "https://github.com/purvaagine/campus-connect/blob/main/server/routes/notificationsRoute.js"
    click UserModel "https://github.com/purvaagine/campus-connect/blob/main/server/models/userModel.js"
    click ProductModel "https://github.com/purvaagine/campus-connect/blob/main/server/models/productModel.js"
    click BidModel "https://github.com/purvaagine/campus-connect/blob/main/server/models/bidModel.js"
    click NotificationsModel "https://github.com/purvaagine/campus-connect/blob/main/server/models/notificationsModel.js"

    classDef frontend fill:#D0E7FF,stroke:#0366d6,color:#000;
    classDef backend fill:#D6F5D6,stroke:#228B22,color:#000;
    classDef data fill:#FFE2B3,stroke:#ff8c00,color:#000;
```
