# mushfiqbh/life-insight architecture

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

- Interactive diagram: https://gitdiagram.com/mushfiqbh/life-insight
- Repository: https://github.com/mushfiqbh/life-insight

## Overview

##### Project type and purpose
- LifeInsight is a full-stack web application for personal and organizational growth analytics.
- Frontend built with Next.js/React, TypeScript, Redux, Tailwind CSS.
- Backend built with Node.js, Express, MongoDB.
- Key features: user authentication, data visualization, goal tracking, file uploads via Cloudinary.

##### File structure
- Top-level “backend” folder contains controllers, routes, models, middleware, utility functions, uploads directory, and server entry point.
– Follows MVC pattern:
· Models under backend/models
· Controllers under backend/controllers
· Routes under backend/routes
– Middleware for authentication in backend/middleware
– Utils for Cloudinary integration under backend/utils
- Top-level “frontend” folder: Next.js app directory under frontend/app plus a large components folder, hooks, context, Redux slices, public assets, Tailwind config.
– app folder uses Next.js file-based routing for pages and layouts (public pages, admin pages, search, login, etc.)
– components folder split into admin, auth, home, shared, showcase, ui components
– state management via Redux (frontend/redux) and a SearchContext
– i18n, theme-provider, and language detection utilities
- CI/CD: .github/workflows/main_lifeinsight.yml
- API documentation file: API-DOCS.md
- Environment config is in .env files for both frontend and backend.

##### README for additional insights
- Confirms tech stack, authentication via JWT/OAuth
- Deployment on Vercel (frontend) and Azure App Service (backend)
- Uses Multer (file uploads) and Cloudinary
- API responses in JSON

## Diagram (Mermaid)

```mermaid
graph TD
    subgraph "Frontend Tier"
        Browser["User Browser"]:::external
        NextAppRouter["Next.js App Router"]:::frontend
        PublicPages["Public Pages"]:::frontend
        AdminPages["Admin Pages"]:::frontend
        LoginPage["Login Page"]:::frontend
        SharedUI["Shared/UI Components"]:::frontend
        HomeShowcase["Home & Showcase Components"]:::frontend
        ReduxStore["Redux Store"]:::frontend
        SearchContext["SearchContext"]:::frontend
        Hooks["Hooks"]:::frontend
        I18n["i18n & Language Detection"]:::frontend
        Styling["Styling & Config"]:::frontend
    end

    subgraph "Backend Tier"
        Express["Express Server"]:::backend
        subgraph "API Routes"
            ConditionRoute["ConditionRoute"]:::backend
            PostRoute["PostRoute"]:::backend
            SearchRoute["SearchRoute"]:::backend
            UserRoute["UserRoute"]:::backend
        end
        subgraph "Controllers"
            ConditionCtrl["ConditionController"]:::backend
            PostCtrl["PostController"]:::backend
            SearchCtrl["SearchController"]:::backend
            UserCtrl["UserController"]:::backend
        end
        subgraph "Models"
            ConditionModel["ConditionModel"]:::backend
            PostModel["PostModel"]:::backend
            UserModel["UserModel"]:::backend
        end
        AuthMiddleware["Auth Middleware"]:::backend
        subgraph "File Uploads"
            UploadsDir["Uploads Directory"]:::backend
            CloudinaryUtils["Cloudinary Utils"]:::backend
        end
    end

    subgraph "External Services"
        MongoDB["MongoDB"]:::database
        Cloudinary["Cloudinary"]:::service
        OAuthProvider["OAuth Provider"]:::external
    end

    subgraph "CI/CD Pipeline"
        GitHubActions["GitHub Actions"]:::pipeline
        Vercel["Vercel Deploy"]:::service
        Azure["Azure App Service"]:::service
    end

    Browser --> NextAppRouter
    NextAppRouter --> PublicPages
    NextAppRouter --> AdminPages
    NextAppRouter --> LoginPage
    NextAppRouter --> ReduxStore
    NextAppRouter --> SearchContext
    NextAppRouter --> Hooks
    NextAppRouter --> I18n
    NextAppRouter --> Styling

    PublicPages -->|SSR/CSR| Express
    LoginPage -->|Auth Request| Express
    AdminPages -->|Protected| Express
    ReduxStore -->|Data Flow| NextAppRouter

    Express --> ConditionRoute
    Express --> PostRoute
    Express --> SearchRoute
    Express --> UserRoute
    Express --> AuthMiddleware

    ConditionRoute --> ConditionCtrl
    PostRoute --> PostCtrl
    SearchRoute --> SearchCtrl
    UserRoute --> UserCtrl

    ConditionCtrl --> ConditionModel
    PostCtrl --> PostModel
    UserCtrl --> UserModel
    SearchCtrl --> ConditionModel
    SearchCtrl --> PostModel
    SearchCtrl --> UserModel

    PostCtrl --> UploadsDir
    UploadsDir --> CloudinaryUtils
    CloudinaryUtils --> Cloudinary

    ConditionModel --> MongoDB
    PostModel --> MongoDB
    UserModel --> MongoDB

    GitHubActions --> Vercel
    GitHubActions --> Azure

    click NextAppRouter "https://github.com/mushfiqbh/life-insight/tree/main/frontend/app/"
    click PublicPages "https://github.com/mushfiqbh/life-insight/blob/main/frontend/app/page.tsx"
    click PublicPages "https://github.com/mushfiqbh/life-insight/blob/main/frontend/app/about/page.tsx"
    click PublicPages "https://github.com/mushfiqbh/life-insight/blob/main/frontend/app/not-found.tsx"
    click AdminPages "https://github.com/mushfiqbh/life-insight/blob/main/frontend/app/admin/layout.tsx"
    click AdminPages "https://github.com/mushfiqbh/life-insight/blob/main/frontend/app/admin/page.tsx"
    click AdminPages "https://github.com/mushfiqbh/life-insight/blob/main/frontend/app/admin/condition/page.tsx"
    click AdminPages "https://github.com/mushfiqbh/life-insight/blob/main/frontend/app/admin/condition/[conditionId]/page.tsx"
    click AdminPages "https://github.com/mushfiqbh/life-insight/blob/main/frontend/app/admin/post/page.tsx"
    click AdminPages "https://github.com/mushfiqbh/life-insight/blob/main/frontend/app/admin/post/[postId]/page.tsx"
    click LoginPage "https://github.com/mushfiqbh/life-insight/blob/main/frontend/app/login/page.tsx"
    click LoginPage "https://github.com/mushfiqbh/life-insight/blob/main/frontend/components/auth/authForm.tsx"
    click LoginPage "https://github.com/mushfiqbh/life-insight/blob/main/frontend/components/auth/permissionForm.tsx"
    click LoginPage "https://github.com/mushfiqbh/life-insight/blob/main/frontend/components/auth/userSidebar.tsx"
    click SharedUI "https://github.com/mushfiqbh/life-insight/tree/main/frontend/components/shared/"
    click SharedUI "https://github.com/mushfiqbh/life-insight/tree/main/frontend/components/ui/"
    click HomeShowcase "https://github.com/mushfiqbh/life-insight/tree/main/frontend/components/home/"
    click HomeShowcase "https://github.com/mushfiqbh/life-insight/tree/main/frontend/components/showcase/"
    click ReduxStore "https://github.com/mushfiqbh/life-insight/blob/main/frontend/redux/store.ts"
    click ReduxStore "https://github.com/mushfiqbh/life-insight/blob/main/frontend/redux/conditionsSlice.ts"
    click ReduxStore "https://github.com/mushfiqbh/life-insight/blob/main/frontend/redux/postsSlice.ts"
    click ReduxStore "https://github.com/mushfiqbh/life-insight/blob/main/frontend/redux/usersSlice.ts"
    click SearchContext "https://github.com/mushfiqbh/life-insight/blob/main/frontend/context/SearchContext.tsx"
    click Hooks "https://github.com/mushfiqbh/life-insight/blob/main/frontend/hooks/useAuth.ts"
    click Hooks "https://github.com/mushfiqbh/life-insight/blob/main/frontend/hooks/useInfiniteCategories.ts"
    click Hooks "https://github.com/mushfiqbh/life-insight/blob/main/frontend/hooks/useInfinitePosts.ts"
    click Hooks "https://github.com/mushfiqbh/life-insight/blob/main/frontend/hooks/useInfiniteRelatedPosts.ts"
    click I18n "https://github.com/mushfiqbh/life-insight/blob/main/frontend/i18n/request.ts"
    click I18n "https://github.com/mushfiqbh/life-insight/blob/main/frontend/messages/en.json"
    click I18n "https://github.com/mushfiqbh/life-insight/blob/main/frontend/messages/bn.json"
    click I18n "https://github.com/mushfiqbh/life-insight/blob/main/frontend/components/shared/theme-provider.tsx"
    click I18n "https://github.com/mushfiqbh/life-insight/blob/main/frontend/lib/detectLanguage.ts"
    click Styling "https://github.com/mushfiqbh/life-insight/blob/main/frontend/tailwind.config.ts"
    click Styling "https://github.com/mushfiqbh/life-insight/blob/main/frontend/app/globals.css"
    click Styling "https://github.com/mushfiqbh/life-insight/blob/main/frontend/postcss.config.mjs"
    click Styling "https://github.com/mushfiqbh/life-insight/blob/main/frontend/next.config.ts"
    click Express "https://github.com/mushfiqbh/life-insight/blob/main/backend/server.js"
    click ConditionCtrl "https://github.com/mushfiqbh/life-insight/blob/main/backend/controllers/conditionController.js"
    click PostCtrl "https://github.com/mushfiqbh/life-insight/blob/main/backend/controllers/postController.js"
    click SearchCtrl "https://github.com/mushfiqbh/life-insight/blob/main/backend/controllers/searchController.js"
    click UserCtrl "https://github.com/mushfiqbh/life-insight/blob/main/backend/controllers/userController.js"
    click ConditionRoute "https://github.com/mushfiqbh/life-insight/blob/main/backend/routes/conditionRoute.js"
    click PostRoute "https://github.com/mushfiqbh/life-insight/blob/main/backend/routes/postRoute.js"
    click SearchRoute "https://github.com/mushfiqbh/life-insight/blob/main/backend/routes/searchRoute.js"
    click UserRoute "https://github.com/mushfiqbh/life-insight/blob/main/backend/routes/userRoute.js"
    click ConditionModel "https://github.com/mushfiqbh/life-insight/blob/main/backend/models/conditionModel.js"
    click PostModel "https://github.com/mushfiqbh/life-insight/blob/main/backend/models/postModel.js"
    click UserModel "https://github.com/mushfiqbh/life-insight/blob/main/backend/models/userModel.js"
    click AuthMiddleware "https://github.com/mushfiqbh/life-insight/blob/main/backend/middleware/authMiddleware.js"
    click UploadsDir "https://github.com/mushfiqbh/life-insight/tree/main/backend/uploads/"
    click CloudinaryUtils "https://github.com/mushfiqbh/life-insight/blob/main/backend/utils/cloudinary.js"
    click CloudinaryUtils "https://github.com/mushfiqbh/life-insight/blob/main/backend/utils/cloudinaryUpload.js"
    click GitHubActions "https://github.com/mushfiqbh/life-insight/blob/main/.github/workflows/main_lifeinsight.yml"
    click Vercel "https://github.com/mushfiqbh/life-insight/blob/main/API-DOCS.md"
    click Azure "https://github.com/mushfiqbh/life-insight/blob/main/CONTRIBUTION.md"
    click Browser "https://github.com/mushfiqbh/life-insight/blob/main/README.md"

    classDef frontend fill:#E8F1FF,stroke:#3B82F6,stroke-width:2px
    classDef backend fill:#FFF4E5,stroke:#F59E0B,stroke-width:2px
    classDef database fill:#E8FFF4,stroke:#10B981,stroke-width:2px
    classDef service fill:#F0F5FF,stroke:#6366F1,stroke-width:2px
    classDef external fill:#F5F5F5,stroke:#6B7280,stroke-width:2px
    classDef pipeline fill:#FEF3C7,stroke:#FBBF24,stroke-width:2px
```
