# manishjadhav9/vikasini architecture

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

- Interactive diagram: https://gitdiagram.com/manishjadhav9/vikasini
- Repository: https://github.com/manishjadhav9/vikasini

## Overview

##### Project Type & Purpose
- This is a full-stack web application (“AI Upskilling Platform for Underprivileged Women”) that combines a Next.js frontend (User + Admin), a Node-based backend with SQLite/Prisma, and multiple AI/third-party integrations.
- Its goal is to provide multilingual, voice-enabled learning, AI-driven personalized paths, gamification, job matching, and an admin dashboard for content/stats.

##### File‐Structure Analysis
Top Level
- README.md, package.json
- vikasini-backend/ – REST API service
– src/controllers, src/routes, src/models, src/db
– SQLite database file (data/vikasini.db)
– Scripts (create-controller.js, fix-models.js, show-users.js)
- vikasini-frontend/ – Next.js 13 “app” directory
– app/ (public pages + API routes under app/api)
– components/ (UI elements, layout, theme)
– hooks/, lib/ (contexts, utilities, API client)
– data/ (simulated JSON learning-paths & progress)
– config (next.config.js, tailwind, postcss)
Patterns
- Frontend: Next.js App Router, ISR/SSR, built-in API routes for mock/proxy
- Backend: MVC structure (controllers ↔ models via Prisma ORM), Express-style routing
- Shared: SQLite for persistence, Prisma for schema & queries

##### README Insights
- Frontend: Next.js + Tailwind + Framer Motion
- Backend: SQLite + Prisma ORM
- Auth: NextAuth.js or Clerk
- AI/ML: OpenAI GPT, TinyLLaMA/Ollama, FAISS, VADER/TextBlob
- Speech/Translation: Sarvam API (STT/TTS)
- File storage: Cloudinary/Firebase/Supabase
- Visualization: Chart.js/ECharts

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Frontend Layer
    subgraph "Frontend Layer"
        direction TB
        UI["Next.js UI"]:::frontend
        Admin["Admin Panel"]:::frontend
        APILayer["Next.js API Routes"]:::frontend
        Components["UI Components & Library"]:::frontend
        StateUtils["State & Utilities"]:::frontend
    end

    %% Backend Layer
    subgraph "Backend Service (vikasini-backend)" 
        direction TB
        BackendEntry["Service Entry Point (index.js)"]:::backend
        Routes["Routing Layer"]:::backend
        Controllers["Business Logic Controllers"]:::backend
        Models["Prisma Models"]:::backend
        DBInit["DB Init & Connection"]:::backend
        Scripts["Utility Scripts"]:::backend
    end

    %% Data Stores
    subgraph "Data Stores"
        direction TB
        DBFile["SQLite Database File"]:::datastore
    end

    %% External Services
    subgraph "External Services"
        direction TB
        AuthService["Auth Service"]:::external
        GPT["OpenAI GPT & Local LLM"]:::external
        Sarvam["Sarvam STT/TTS/Translation"]:::external
        FAISS["FAISS Index Engine"]:::external
        Sentiment["VADER/TextBlob"]:::external
        Storage["Cloud Storage (Cloudinary/Firebase)"]:::external
    end

    %% Frontend to Backend Connections
    UI -->|"API calls"| APILayer
    Admin -->|"Admin APIs"| APILayer
    APILayer -->|"Proxies requests"| BackendEntry
    UI -->|"renders UI with components"| Components
    UI -->|"uses hooks & utils"| StateUtils
    Admin -->|"uses hooks & utils"| StateUtils

    %% Backend Internal Flow
    BackendEntry -->|"routes to"| Routes
    Routes -->|"calls"| Controllers
    Controllers -->|"queries/updates"| Models
    Models -->|"executes via"| DBInit
    DBInit -->|"reads/writes"| DBFile
    Controllers -->|"runs"| Scripts

    %% External Integrations
    Controllers -->|"auth requests"| AuthService
    Controllers -->|"AI personalization"| GPT
    Controllers -->|"speech/translation"| Sarvam
    Controllers -->|"search/index"| FAISS
    Controllers -->|"sentiment analysis"| Sentiment
    Controllers -->|"media upload/download"| Storage
    UI -->|"uploads media"| Storage

    %% Classes
    classDef frontend fill:#bbdefb,stroke:#333,stroke-width:1px
    classDef backend fill:#c8e6c9,stroke:#333,stroke-width:1px
    classDef datastore fill:#ffe0b2,stroke:#333,stroke-width:1px
    classDef external fill:#e0e0e0,stroke:#333,stroke-width:1px

    %% Click Events
    click UI "https://github.com/manishjadhav9/vikasini/blob/main/vikasini-frontend/app/layout.tsx"
    click Admin "https://github.com/manishjadhav9/vikasini/blob/main/vikasini-frontend/app/admin/layout.tsx"
    click APILayer "https://github.com/manishjadhav9/vikasini/tree/main/vikasini-frontend/app/api"
    click Components "https://github.com/manishjadhav9/vikasini/tree/main/vikasini-frontend/components"
    click StateUtils "https://github.com/manishjadhav9/vikasini/tree/main/vikasini-frontend/hooks"
    click BackendEntry "https://github.com/manishjadhav9/vikasini/blob/main/vikasini-backend/src/index.js"
    click Routes "https://github.com/manishjadhav9/vikasini/blob/main/vikasini-backend/src/routes/authRoutes.js"
    click Controllers "https://github.com/manishjadhav9/vikasini/blob/main/vikasini-backend/src/controllers/authController.js"
    click Models "https://github.com/manishjadhav9/vikasini/blob/main/vikasini-backend/src/models/courseModel.js"
    click DBInit "https://github.com/manishjadhav9/vikasini/blob/main/vikasini-backend/src/db/index.js"
    click DBFile "https://github.com/manishjadhav9/vikasini/blob/main/vikasini-backend/data/vikasini.db"
    click Scripts "https://github.com/manishjadhav9/vikasini/blob/main/vikasini-backend/create-controller.js"
```
