# vanshkapoor07/taskbuddy architecture

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

- Interactive diagram: https://gitdiagram.com/vanshkapoor07/taskbuddy
- Repository: https://github.com/vanshkapoor07/taskbuddy

## Overview

##### Project type and purpose
- This is a full-stack task management application named “TaskBuddy.”
- The frontend is a single-page React application (built with Vite).
- The backend is a Node.js/Express REST API backed by a SQL database (schema.sql / seed.sql).
- Core features: user authentication (JWT), task CRUD operations, team management.

##### File structure
- Top-level separation:
– frontend/ (React/Vite SPA)
– server/ (Express API)
– database/ (schema.sql, seed.sql)
– docs/ (API Endpoints, design notes)
- Frontend uses component-based MVC with pages, context for auth state, assets, and routing.
- Backend follows MVC: models (taskModel.js, userModel.js, teamModel.js), controllers (authController.js, taskController.js, teamController.js), routes (authRoutes.js, taskRoutes.js, teamRoutes.js), middleware (auth, validation, rate limiting, error handling), utils (encrypt, generateToken), and config/db.js to connect to the SQL database.
- Build/deploy scripts: package.json in both frontend and server; .env files for configuration.

##### README (empty here) and docs/API Endpoints.md
- The docs folder defines the REST endpoints for auth, tasks, and teams.

##### Detailed capture of essential architecture
- Call out the three core domains: Authentication, Task Management, Team Management.
- SQL database as a single relational store with schema/seed annotations.
- An annotation for environment/config (e.g., .env) feeding into both frontend (public config) and backend (DB URL, JWT secret).
- Error handling and rate limiting as cross-cutting middleware.

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph "Client Layer"
        direction TB
        Browser["User Browser"]:::external
        SPA["Frontend SPA (React/Vite)"]:::frontend
        main["main.jsx"]:::frontend
        App["App.jsx"]:::frontend
        AuthPage["Auth Page"]:::frontend
        HomePage["Home Page"]:::frontend
        DashboardPage["Dashboard Page"]:::frontend
        TeamDashboardPage["Team Dashboard Page"]:::frontend
        AuthContext["AuthContext.jsx"]:::frontend
        Components["UI & Feature Components"]:::frontend
        ViteConfig["vite.config.js"]:::frontend
        ESLintConfig["eslint.config.js"]:::frontend
    end

    subgraph "Server Layer"
        direction TB
        ServerFolder["Backend REST API"]:::backend
        ServerEntry["server.js"]:::backend
        DBConfig["config/db.js"]:::backend
        Env["env.example"]:::backend
        subgraph "Routes"
            AuthRoutes["authRoutes.js"]:::backend
            TaskRoutes["taskRoutes.js"]:::backend
            TeamRoutes["teamRoutes.js"]:::backend
        end
        subgraph "Controllers"
            AuthController["authController.js"]:::backend
            TaskController["taskController.js"]:::backend
            TeamController["teamController.js"]:::backend
        end
        subgraph "Middleware"
            AuthMiddleware["authMiddleware.js"]:::backend
            ValidationMiddleware["validationMiddleware.js"]:::backend
            RateLimitMiddleware["rateLimitMiddleware.js"]:::backend
            ErrorMiddleware["errorHandler.js"]:::backend
        end
        subgraph "Models"
            UserModel["userModel.js"]:::backend
            TaskModel["taskModel.js"]:::backend
            TeamModel["teamModel.js"]:::backend
        end
        subgraph "Utils"
            Encrypt["encrypt.js"]:::backend
            Token["generateToken.js"]:::backend
        end
        API["REST API (Express)"]:::backend
        DB["SQL Database"]:::datastore
    end

    subgraph "Database Scripts"
        direction TB
        SchemaSQL["schema.sql"]:::datastore
        SeedSQL["seed.sql"]:::datastore
    end

    Docs["API Documentation"]:::external

    %% Client to Server
    Browser --> SPA
    SPA --> main
    main --> App
    App --> AuthPage
    App --> HomePage
    App --> DashboardPage
    App --> TeamDashboardPage
    App --> AuthContext
    App --> Components
    SPA --> ViteConfig
    SPA --> ESLintConfig
    SPA --> API

    %% Server structure
    ServerFolder --> ServerEntry
    ServerFolder --> DBConfig
    ServerFolder --> Env
    ServerEntry --> AuthRoutes
    ServerEntry --> TaskRoutes
    ServerEntry --> TeamRoutes
    API --> AuthRoutes
    API --> TaskRoutes
    API --> TeamRoutes

    AuthRoutes --> AuthController
    TaskRoutes --> TaskController
    TeamRoutes --> TeamController

    AuthRoutes --> AuthMiddleware
    TaskRoutes --> AuthMiddleware
    TeamRoutes --> AuthMiddleware

    AuthController --> UserModel
    TaskController --> TaskModel
    TeamController --> TeamModel

    AuthController --> Encrypt
    AuthController --> Token

    UserModel --> DB
    TaskModel --> DB
    TeamModel --> DB

    SchemaSQL --> DB
    SeedSQL --> DB

    Docs --> API

    %% Click Events
    click SPA "https://github.com/vanshkapoor07/taskbuddy/tree/main/TaskBuddy-main/TaskBuddy-main/frontend"
    click main "https://github.com/vanshkapoor07/taskbuddy/blob/main/TaskBuddy-main/TaskBuddy-main/frontend/src/main.jsx"
    click App "https://github.com/vanshkapoor07/taskbuddy/blob/main/TaskBuddy-main/TaskBuddy-main/frontend/src/App.jsx"
    click AuthPage "https://github.com/vanshkapoor07/taskbuddy/blob/main/TaskBuddy-main/TaskBuddy-main/frontend/src/pages/Auth.jsx"
    click HomePage "https://github.com/vanshkapoor07/taskbuddy/blob/main/TaskBuddy-main/TaskBuddy-main/frontend/src/pages/Home.jsx"
    click DashboardPage "https://github.com/vanshkapoor07/taskbuddy/blob/main/TaskBuddy-main/TaskBuddy-main/frontend/src/pages/Dashboard.jsx"
    click TeamDashboardPage "https://github.com/vanshkapoor07/taskbuddy/blob/main/TaskBuddy-main/TaskBuddy-main/frontend/src/pages/TeamDashboard.jsx"
    click Components "https://github.com/vanshkapoor07/taskbuddy/tree/main/TaskBuddy-main/TaskBuddy-main/frontend/src/components"
    click AuthContext "https://github.com/vanshkapoor07/taskbuddy/blob/main/TaskBuddy-main/TaskBuddy-main/frontend/src/context/AuthContext.jsx"
    click ViteConfig "https://github.com/vanshkapoor07/taskbuddy/blob/main/TaskBuddy-main/TaskBuddy-main/frontend/vite.config.js"
    click ESLintConfig "https://github.com/vanshkapoor07/taskbuddy/blob/main/TaskBuddy-main/TaskBuddy-main/frontend/eslint.config.js"
    click ServerFolder "https://github.com/vanshkapoor07/taskbuddy/tree/main/TaskBuddy-main/TaskBuddy-main/server"
    click ServerEntry "https://github.com/vanshkapoor07/taskbuddy/blob/main/TaskBuddy-main/TaskBuddy-main/server/server.js"
    click DBConfig "https://github.com/vanshkapoor07/taskbuddy/blob/main/TaskBuddy-main/TaskBuddy-main/server/config/db.js"
    click Env "https://github.com/vanshkapoor07/taskbuddy/blob/main/TaskBuddy-main/TaskBuddy-main/server/config/env.example"
    click AuthController "https://github.com/vanshkapoor07/taskbuddy/blob/main/TaskBuddy-main/TaskBuddy-main/server/controllers/authController.js"
    click TaskController "https://github.com/vanshkapoor07/taskbuddy/blob/main/TaskBuddy-main/TaskBuddy-main/server/controllers/taskController.js"
    click TeamController "https://github.com/vanshkapoor07/taskbuddy/blob/main/TaskBuddy-main/TaskBuddy-main/server/controllers/teamController.js"
    click AuthRoutes "https://github.com/vanshkapoor07/taskbuddy/blob/main/TaskBuddy-main/TaskBuddy-main/server/routes/authRoutes.js"
    click TaskRoutes "https://github.com/vanshkapoor07/taskbuddy/blob/main/TaskBuddy-main/TaskBuddy-main/server/routes/taskRoutes.js"
    click TeamRoutes "https://github.com/vanshkapoor07/taskbuddy/blob/main/TaskBuddy-main/TaskBuddy-main/server/routes/teamRoutes.js"
    click UserModel "https://github.com/vanshkapoor07/taskbuddy/blob/main/TaskBuddy-main/TaskBuddy-main/server/models/userModel.js"
    click TaskModel "https://github.com/vanshkapoor07/taskbuddy/blob/main/TaskBuddy-main/TaskBuddy-main/server/models/taskModel.js"
    click TeamModel "https://github.com/vanshkapoor07/taskbuddy/blob/main/TaskBuddy-main/TaskBuddy-main/server/models/teamModel.js"
    click AuthMiddleware "https://github.com/vanshkapoor07/taskbuddy/blob/main/TaskBuddy-main/TaskBuddy-main/server/middleware/authMiddleware.js"
    click ValidationMiddleware "https://github.com/vanshkapoor07/taskbuddy/blob/main/TaskBuddy-main/TaskBuddy-main/server/middleware/validationMiddleware.js"
    click RateLimitMiddleware "https://github.com/vanshkapoor07/taskbuddy/blob/main/TaskBuddy-main/TaskBuddy-main/server/middleware/rateLimitMiddleware.js"
    click ErrorMiddleware "https://github.com/vanshkapoor07/taskbuddy/blob/main/TaskBuddy-main/TaskBuddy-main/server/middleware/errorHandler.js"
    click Encrypt "https://github.com/vanshkapoor07/taskbuddy/blob/main/TaskBuddy-main/TaskBuddy-main/server/utils/encrypt.js"
    click Token "https://github.com/vanshkapoor07/taskbuddy/blob/main/TaskBuddy-main/TaskBuddy-main/server/utils/generateToken.js"
    click SchemaSQL "https://github.com/vanshkapoor07/taskbuddy/blob/main/TaskBuddy-main/TaskBuddy-main/database/schema.sql"
    click SeedSQL "https://github.com/vanshkapoor07/taskbuddy/blob/main/TaskBuddy-main/TaskBuddy-main/database/seed.sql"
    click Docs "https://github.com/vanshkapoor07/taskbuddy/blob/main/TaskBuddy-main/TaskBuddy-main/docs/API Endpoints.md"

    classDef frontend fill:#cfe2f3,stroke:#0b5394,color:#000
    classDef backend fill:#d9ead3,stroke:#38761d,color:#000
    classDef datastore fill:#fce5cd,stroke:#b45f06,color:#000
    classDef external fill:#eeeeee,stroke:#888888,color:#000
```
