# visris-19/to-do-app architecture

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

- Interactive diagram: https://gitdiagram.com/visris-19/to-do-app
- Repository: https://github.com/visris-19/to-do-app

## Overview

##### Project Type & Purpose
- This is a full-stack “Modern Todo” web application built on the MERN stack.
- Frontend: a React SPA (Vite + Tailwind CSS) for task management, authentication, user profiles, settings, dark mode, responsive UI, animations, toast notifications.
- Backend: Node.js + Express.js API server with JWT/session authentication, email verification, file uploads (avatars), Mongoose models for users, profiles, lists, tasks, settings, and rate limiting. Data stored in MongoDB.

##### File Structure Analysis
Top-level:
– backend/ – Express API
- config/ – passport, multer, session, JWT secrets
- dbmodel/ – Mongoose schemas (User, Profile, TaskHistory, List, Settings)
- middleware/ – auth, validation, rate-limiting, error handling
- routes/ – auth, tasks (list), profile, settings endpoints
- scripts/ – secret generator
- tests/ – Jest/Supertest for list routes
– frontend/ – React project scaffolded with Vite
- src/components, pages, hooks, context, services, utils
- assets & public for static files
- configuration: vite.config.js, eslint.config.js

##### README Insights
- Tech stack called out clearly: React, Tailwind, Framer Motion, React Router, React Hot Toast on the front; Node, Express, MongoDB/Mongoose, JWT, Nodemailer, Multer, Express-session, Passport on the back.
- API versioning (v1, v2) for auth, tasks, profile, settings.
- Environment variables outline external dependencies (MongoDB URI, email SMTP, JWT/session secrets).

a. Main Components
1. Client (Browser)
– React SPA running under Vite (development) or served as static assets (production CDN).
2. API Gateway / Server
– Express.js application with route handlers and middleware pipeline.
3. Authentication Layer
– Passport strategies (social + local), JWT issuance/verification, Express-session management.
4. Business Logic
– Controllers for auth, tasks, profiles, settings.
5. Data Access Layer
– Mongoose ODM mapping to MongoDB collections (users, tasks, lists, profiles, settings, taskHistory).
6. Data Store
– MongoDB cluster/atlas.
7. File Store
– Local filesystem or cloud bucket used by Multer for avatar/image uploads.
8. External Services
– Email service (SMTP via Nodemailer), OAuth providers (Google/Facebook etc.).
b. Relationships & Data-Flows
- Client ↔ API: HTTP(S) requests to /api/v1/auth, /api/v2/tasks, profiles, settings.
- API → DB: Mongoose queries/updates.
- API → File Store: Multer middleware for file upload paths.
- API → Email Service: Nodemailer to send verification emails.
- API ↔ OAuth Providers: Passport exchanging tokens.
c. Architectural Patterns
- Layered (Presentation → API Gateway → Services/Controllers → Data Access → Database).
- Middleware pipeline for cross-cutting concerns (auth, validation, error handling, rate limiting).
- Client-side hooks/context for state and side-effects (AuthContext, form validation).
d. Key Technologies
- React, React Router, Context API, Framer Motion, Tailwind CSS.
- Node.js, Express.js, Passport.js, JSON Web Tokens, Express-session, Multer, Nodemailer.
- MongoDB with Mongoose ODM.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Frontend Layer
    subgraph "Frontend (React SPA)" 
        direction TB
        Client["React SPA"]:::frontend
        AuthContext["AuthContext"]:::frontend
        SocialAuth["SocialAuth"]:::frontend
        TaskForm["TaskForm"]:::frontend
        TaskDetails["TaskDetails"]:::frontend
        ProtectedRoute["ProtectedRoute"]:::frontend
        Navbar["Navbar"]:::frontend
        ErrorAlert["ErrorAlert"]:::frontend
        ConfirmDialog["ConfirmDialog"]:::frontend
        useForm["useFormValidation Hook"]:::frontend
        AuthService["auth.js Service"]:::frontend
        ProfileService["profileService.js"]:::frontend
        DateUtils["dateUtils.js"]:::frontend
        StringUtils["stringUtils.js"]:::frontend
    end

    %% Backend Layer
    subgraph "Backend (Express API)" 
        direction TB
        API["Express API"]:::backend
        subgraph "Middleware Pipeline"
            direction TB
            AuthMW["authMiddleware.js"]:::middleware
            RateLimit["rateLimit.js"]:::middleware
            TaskVal["taskValidation.js"]:::middleware
            ProfileVal["profileMiddleware.js"]:::middleware
            EmailVal["emailValidation.js"]:::middleware
            ErrorHandler["errorHandler.js"]:::middleware
        end
        subgraph "Controllers & Routes"
            direction TB
            AuthCtrl["auth.js"]:::service
            TaskCtrl["list.js"]:::service
            ProfileCtrl["profileRoutes.js"]:::service
            SettingsCtrl["settings.js"]:::service
        end
        subgraph "Data Access Layer"
            direction TB
            UserModel["User.js"]:::model
            ProfileModel["Profile.js"]:::model
            ListModel["list.js"]:::model
            HistoryModel["taskHistory.js"]:::model
            SettingsModel["Settings.js"]:::model
        end
        subgraph "Config"
            direction TB
            PassportConfig["passport.js"]:::config
            MulterConfig["multerConfig.js"]:::config
        end
    end

    %% Persistence & External
    DB[(MongoDB Atlas)]:::database
    FileStore[(Avatar File Store)]:::storage
    EmailSvc["Email SMTP"]:::external
    OAuth["OAuth Providers"]:::external
    SecretsScript["generateSecret.js"]:::script
    Tests["list.test.js"]:::test

    %% Connections
    Client -->|"HTTPS/JSON"| API
    API --> AuthMW
    API --> RateLimit
    API --> TaskVal
    API --> ProfileVal
    API --> EmailVal
    API --> ErrorHandler
    AuthMW --> AuthCtrl
    TaskVal --> TaskCtrl
    ProfileVal --> ProfileCtrl
    ErrorHandler --> SettingsCtrl
    AuthCtrl --> UserModel
    AuthCtrl --> ProfileModel
    TaskCtrl --> ListModel
    TaskCtrl --> HistoryModel
    ProfileCtrl --> ProfileModel
    SettingsCtrl --> SettingsModel
    UserModel --> DB
    ProfileModel --> DB
    ListModel --> DB
    HistoryModel --> DB
    SettingsModel --> DB
    API --> FileStore
    API --> EmailSvc
    API --> OAuth
    API --> SecretsScript
    API --> Tests

    %% Click Events
    click Client "https://github.com/visris-19/to-do-app/tree/main/frontend/src"
    click AuthContext "https://github.com/visris-19/to-do-app/blob/main/frontend/src/context/AuthContext.jsx"
    click SocialAuth "https://github.com/visris-19/to-do-app/blob/main/frontend/src/components/SocialAuth.jsx"
    click TaskForm "https://github.com/visris-19/to-do-app/blob/main/frontend/src/components/TaskForm.jsx"
    click TaskDetails "https://github.com/visris-19/to-do-app/blob/main/frontend/src/components/TaskDetails.jsx"
    click ProtectedRoute "https://github.com/visris-19/to-do-app/blob/main/frontend/src/components/ProtectedRoute.jsx"
    click Navbar "https://github.com/visris-19/to-do-app/blob/main/frontend/src/components/Navbar.jsx"
    click ErrorAlert "https://github.com/visris-19/to-do-app/blob/main/frontend/src/components/ErrorAlert.jsx"
    click ConfirmDialog "https://github.com/visris-19/to-do-app/blob/main/frontend/src/components/ConfirmDialog.jsx"
    click useForm "https://github.com/visris-19/to-do-app/blob/main/frontend/src/hooks/useFormValidation.jsx"
    click AuthService "https://github.com/visris-19/to-do-app/blob/main/frontend/src/services/auth.js"
    click ProfileService "https://github.com/visris-19/to-do-app/blob/main/frontend/src/services/profileService.js"
    click DateUtils "https://github.com/visris-19/to-do-app/blob/main/frontend/src/utils/dateUtils.js"
    click StringUtils "https://github.com/visris-19/to-do-app/blob/main/frontend/src/utils/stringUtils.js"
    click API "https://github.com/visris-19/to-do-app/blob/main/backend/index.js"
    click AuthCtrl "https://github.com/visris-19/to-do-app/blob/main/backend/routes/auth.js"
    click TaskCtrl "https://github.com/visris-19/to-do-app/blob/main/backend/routes/list.js"
    click ProfileCtrl "https://github.com/visris-19/to-do-app/blob/main/backend/routes/profileRoutes.js"
    click SettingsCtrl "https://github.com/visris-19/to-do-app/blob/main/backend/routes/settings.js"
    click AuthMW "https://github.com/visris-19/to-do-app/blob/main/backend/middleware/authMiddleware.js"
    click RateLimit "https://github.com/visris-19/to-do-app/blob/main/backend/middleware/rateLimit.js"
    click TaskVal "https://github.com/visris-19/to-do-app/blob/main/backend/middleware/taskValidation.js"
    click ProfileVal "https://github.com/visris-19/to-do-app/blob/main/backend/middleware/profileMiddleware.js"
    click EmailVal "https://github.com/visris-19/to-do-app/blob/main/backend/middleware/emailValidation.js"
    click ErrorHandler "https://github.com/visris-19/to-do-app/blob/main/backend/middleware/errorHandler.js"
    click UserModel "https://github.com/visris-19/to-do-app/blob/main/backend/dbmodel/User.js"
    click ProfileModel "https://github.com/visris-19/to-do-app/blob/main/backend/dbmodel/Profile.js"
    click ListModel "https://github.com/visris-19/to-do-app/blob/main/backend/dbmodel/list.js"
    click HistoryModel "https://github.com/visris-19/to-do-app/blob/main/backend/dbmodel/taskHistory.js"
    click SettingsModel "https://github.com/visris-19/to-do-app/blob/main/backend/dbmodel/Settings.js"
    click PassportConfig "https://github.com/visris-19/to-do-app/blob/main/backend/config/passport.js"
    click MulterConfig "https://github.com/visris-19/to-do-app/blob/main/backend/config/multerConfig.js"
    click SecretsScript "https://github.com/visris-19/to-do-app/blob/main/backend/scripts/generateSecret.js"
    click Tests "https://github.com/visris-19/to-do-app/blob/main/backend/tests/list.test.js"

    %% Styles
    classDef frontend fill:#E0F7FA,stroke:#006064,color:#006064;
    classDef backend fill:#E8F5E9,stroke:#2E7D32,color:#2E7D32;
    classDef middleware fill:#FFF3E0,stroke:#EF6C00,color:#EF6C00;
    classDef service fill:#E3F2FD,stroke:#1E88E5,color:#1E88E5;
    classDef model fill:#F3E5F5,stroke:#8E24AA,color:#8E24AA;
    classDef config fill:#ECEFF1,stroke:#607D8B,color:#607D8B;
    classDef database fill:#D1C4E9,stroke:#512DA8,color:#512DA8,stroke-dasharray: 4 2;
    classDef storage fill:#B2DFDB,stroke:#004D40,color:#004D40,stroke-dasharray: 4 2;
    classDef external fill:#FFEBEE,stroke:#C62828,color:#C62828,stroke-dasharray: 4 2;
    classDef script fill:#FFF9C4,stroke:#F9A825,color:#F9A825,stroke-dasharray: 4 2;
    classDef test fill:#FCE4EC,stroke:#AD1457,color:#AD1457,stroke-dasharray: 4 2;
```
