# chirag19bca/farm2store architecture

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

- Interactive diagram: https://gitdiagram.com/chirag19bca/farm2store
- Repository: https://github.com/chirag19bca/farm2store

## Overview

##### Project type and purpose
- This is a full-stack web marketplace (“Farm2Store”) that connects farmers (sellers) and retailers (buyers) via a React frontend and an Express/MySQL backend.
- Key features: farmer dashboard, retailer dashboard, admin panel, sales reports (with Chart.js + jsPDF), email notifications (via Nodemailer).

##### File structure
- Top-level folders:
– backend/ : Node.js + Express REST API, MySQL integration, route handlers, database dump
– frontend/ : Vite-powered React application, component hierarchy, pages, styling, Axios client
– README.md, documentation under Farm2Store Doc/
- backend details:
– api/ folder holds route modules (Admin.js, authRoutes.js, productRoutes.js, etc.).
– config/db.js contains MySQL connection logic.
– server.js sets up Express app, middleware (cors, sessions, multer, cookie-parser), and mounts routes.
– farm2storeXampp.sql is the database schema + seed.
- frontend details:
– src/components/ separated by feature (Admin, FarmerDashboard, RetailerDashboard, shared components).
– src/pages/ routed views (Login, Register, Products, CategoryPage, etc.).
– src/context/AuthContext.jsx provides authentication state via React Context.
– src/utils/axios.js centralizes HTTP client configuration.
– CSS Modules for scoped styling.

##### README for additional insights
- Confirms tech stack: React.js, Vite, React Router, Axios, Chart.js, jsPDF/html2canvas, Node/Express, MySQL.
- Describes system roles (Farmer, Retailer, Admin) and user flows (register, login, CRUD on products/orders, reporting).

##### Elements
– Client-side (blue rectangles)
– Server-side modules (green rectangles)
– External services (orange ovals)
- Important middleware and utilities (e.g., “AuthContext,” “axios.js,” “multer,” “express-session”).

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Frontend Layer
    subgraph "Frontend (Client-side)"
        direction TB
        ReactSPA["React SPA"]:::frontend
        AuthContext["AuthContext"]:::frontend
        AxiosUtil["HTTP Client (axios.js)"]:::frontend

        subgraph "Admin Module"
            direction TB
            AdminComp["Admin Components"]:::frontend
        end

        subgraph "Farmer Dashboard Module"
            direction TB
            FarmerDash["FarmerDashboard Components"]:::frontend
        end

        subgraph "Retailer Dashboard Module"
            direction TB
            RetailerDash["RetailerDashboard Components"]:::frontend
        end

        subgraph "Reporting UI"
            direction TB
            ReportUI["Report Components (Chart.js, jsPDF)"]:::frontend
        end

        subgraph "Feedback UI"
            direction TB
            FeedbackUI["FeedbackForm.jsx"]:::frontend
        end

        subgraph "Category UI"
            direction TB
            CategoryUI["CategoryPage.jsx"]:::frontend
        end

        subgraph "Products UI"
            direction TB
            ProductsUI["Products & ProductDetails.jsx"]:::frontend
        end

        ReactSPA -->|uses| AuthContext
        ReactSPA -->|uses| AxiosUtil
        ReactSPA -->|navigates to| AdminComp
        ReactSPA -->|navigates to| FarmerDash
        ReactSPA -->|navigates to| RetailerDash
        ReactSPA -->|navigates to| ReportUI
        ReactSPA -->|navigates to| FeedbackUI
        ReactSPA -->|navigates to| CategoryUI
        ReactSPA -->|navigates to| ProductsUI
        ReactSPA -->|HTTP requests| ExpressAPI
    end

    %% Backend Layer
    subgraph "Backend (Server-side)"
        direction TB
        ExpressAPI["Express API Server"]:::backend

        subgraph "Middleware & Config"
            direction TB
            CORS["cors"]:::backend
            Sessions["express-session\n(express-mysql-session)"]:::backend
            Multer["multer"]:::backend
            CookieParser["cookie-parser"]:::backend
            DBConfig["DB Config (db.js)"]:::backend
        end

        subgraph "Route Handlers"
            direction TB
            AuthRoutes["authRoutes.js"]:::backend
            ProductRoutes["productRoutes.js"]:::backend
            CartRoutes["cartRoutes.js"]:::backend
            OrdersRoutes["ordersRoutes.js"]:::backend
            CategoryRoutes["categoryRoutes.js"]:::backend
            FeedbackRoutes["feedbackRoutes.js"]:::backend
            EmailRoutes["emailRoutes.js"]:::backend
            ReportRoutes["reportRoutes.js"]:::backend
            AdminRoutes["Admin.js"]:::backend
        end

        ExpressAPI -->|uses| CORS
        ExpressAPI -->|uses| Sessions
        ExpressAPI -->|uses| Multer
        ExpressAPI -->|uses| CookieParser
        ExpressAPI -->|loads| DBConfig

        ExpressAPI -->|handles| AuthRoutes
        ExpressAPI -->|handles| ProductRoutes
        ExpressAPI -->|handles| CartRoutes
        ExpressAPI -->|handles| OrdersRoutes
        ExpressAPI -->|handles| CategoryRoutes
        ExpressAPI -->|handles| FeedbackRoutes
        ExpressAPI -->|handles| EmailRoutes
        ExpressAPI -->|handles| ReportRoutes
        ExpressAPI -->|handles| AdminRoutes

        ExpressAPI -->|queries| MySQLDB
        ExpressAPI -->|serves images| ImageStorage
        ExpressAPI -->|sends emails via| SMTPService
    end

    %% Database & External Services
    MySQLDB["MySQL Database"]:::db
    ImageStorage["Image Storage"]:::db
    SMTPService["SMTP Email Service"]:::external
    SessionStore["Session Store\n(express-mysql-session)"]:::external

    Sessions --> SessionStore

    %% Click Events
    click ReactSPA "https://github.com/chirag19bca/farm2store/tree/main/frontend/src"
    click AuthContext "https://github.com/chirag19bca/farm2store/blob/main/frontend/src/context/AuthContext.jsx"
    click AxiosUtil "https://github.com/chirag19bca/farm2store/blob/main/frontend/src/utils/axios.js"
    click AdminComp "https://github.com/chirag19bca/farm2store/tree/main/frontend/src/components/Admin/"
    click FarmerDash "https://github.com/chirag19bca/farm2store/tree/main/frontend/src/components/FarmerDashboard/"
    click RetailerDash "https://github.com/chirag19bca/farm2store/tree/main/frontend/src/components/RetailerDashboard/"
    click ReportUI "https://github.com/chirag19bca/farm2store/blob/main/frontend/src/components/Admin/manageReport.jsx"
    click FeedbackUI "https://github.com/chirag19bca/farm2store/blob/main/frontend/src/pages/FeedbackForm.jsx"
    click CategoryUI "https://github.com/chirag19bca/farm2store/blob/main/frontend/src/pages/CategoryPage.jsx"
    click ProductsUI "https://github.com/chirag19bca/farm2store/blob/main/frontend/src/pages/Products.jsx"
    click ExpressAPI "https://github.com/chirag19bca/farm2store/blob/main/backend/server.js"
    click AuthRoutes "https://github.com/chirag19bca/farm2store/blob/main/backend/api/authRoutes.js"
    click ProductRoutes "https://github.com/chirag19bca/farm2store/blob/main/backend/api/productRoutes.js"
    click CartRoutes "https://github.com/chirag19bca/farm2store/blob/main/backend/api/cartRoutes.js"
    click OrdersRoutes "https://github.com/chirag19bca/farm2store/blob/main/backend/api/ordersRoutes.js"
    click CategoryRoutes "https://github.com/chirag19bca/farm2store/blob/main/backend/api/categoryRoutes.js"
    click FeedbackRoutes "https://github.com/chirag19bca/farm2store/blob/main/backend/api/feedbackRoutes.js"
    click EmailRoutes "https://github.com/chirag19bca/farm2store/blob/main/backend/api/emailRoutes.js"
    click ReportRoutes "https://github.com/chirag19bca/farm2store/blob/main/backend/api/reportRoutes.js"
    click AdminRoutes "https://github.com/chirag19bca/farm2store/blob/main/backend/api/Admin.js"
    click DBConfig "https://github.com/chirag19bca/farm2store/blob/main/backend/config/db.js"
    click MySQLDB "https://github.com/chirag19bca/farm2store/blob/main/backend/farm2storeXampp.sql"
    click ImageStorage "https://github.com/chirag19bca/farm2store/tree/main/backend/images"

    %% Styles
    classDef frontend fill:#cce5ff,stroke:#004085,color:#004085
    classDef backend fill:#d4edda,stroke:#155724,color:#155724
    classDef external fill:#fff3cd,stroke:#856404,color:#856404
    classDef db fill:#ffeeba,stroke:#856404,color:#856404
```
