# amardeeplakshkar/svcdalauda architecture

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

- Interactive diagram: https://gitdiagram.com/amardeeplakshkar/svcdalauda
- Repository: https://github.com/amardeeplakshkar/svcdalauda

## Overview

##### Project type and purpose
- This is a full-stack web application—SVC Dalauda College Management Portal—built using Next.js 16 (App Router), React 19, and TypeScript.
- Purpose: provide a unified interface for faculty management, content (blogs/announcements/notices) publishing, dynamic form building, user authentication, and file storage.

##### File structure
- Top-level directories:
- app/ – Next.js App Router (client pages under `app/(routes)` and `app/(auth)`, plus API routes under `app/api`).
- components/ – React UI broken into admin-specific, core (public site), UI primitives (Radix wrappers), and context providers.
- hooks/, lib/, shared/ – data-fetching hooks, utility libraries (supabase client, Drizzle ORM setup), and shared schemas/routes.
- public/ – static assets.
- config files – next.config.ts, tailwind.config.js, drizzle.config.ts, pnpm-workspace.yaml.
- Architectural patterns: layered separation (UI components → pages → API routes → service/utils → data layer).
- Key technologies surfaced by file names: Drizzle ORM (db.ts, schema.ts), Supabase (supabase.ts, storage policies), Clerk auth routes, React Hook Form + Zod (validation), Tailwind CSS, Radix UI.

##### README for additional insights
- Client Layer (Next.js pages + React components)
- API Layer (Next.js serverless routes under `/api`)
- Service Layer (Supabase client, file storage, business logic in lib/)
- Data Layer (PostgreSQL via Drizzle ORM + Supabase Storage)
- It specifies core features (Faculty CRUD, Content CRUD, Form Builder, Authentication via Clerk, Real-time data with React Query).

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% UI / Client Layer
    subgraph "Public Website" 
        direction TB
        Landing["Landing & Core Pages"]:::client
        About["About Page"]:::client
        Contact["Contact Page"]:::client
        Directory["Faculty Directory"]:::client
        Profile["Faculty Profile"]:::client
        FormsList["Forms List"]:::client
        FormDetail["Form Detail"]:::client
        PostsList["Posts List"]:::client
        PostDetail["Post Detail"]:::client
    end
    subgraph "Admin Dashboard"
        direction TB
        AdminLayout["Admin Layout"]:::client
        AdminHome["Dashboard Home"]:::client
        Sidebar["Sidebar & Navigation"]:::client
        FacultyPage["Faculty Management UI"]:::client
        FacultyCard["Faculty Card Component"]:::client
        PostsAdmin["Posts Management UI"]:::client
        PostCard["Post Card Component"]:::client
        Builder["Form Builder"]:::client
        FormsAdminList["Forms Admin List"]:::client
        SubmissionsAdmin["Submissions Viewer"]:::client
        BuilderComponents["FormBuilder Components"]:::client
        UserProfile["User Profile Management"]:::client
    end
    subgraph "Auth Modules"
        direction TB
        SignIn["Sign-In Flow"]:::client
        SignUp["Sign-Up Flow"]:::client
        AuthLayout["Auth Layout"]:::client
    end

    %% API / Server Layer
    subgraph "API / Server Layer"
        direction TB
        API_Faculty["/api/faculty"]:::api
        API_Faculty_ID["/api/faculty/[id]"]:::api
        API_Forms["/api/forms"]:::api
        API_Forms_ID["/api/forms/[id]"]:::api
        API_Forms_ID_Sub["/api/forms/[id]/submissions"]:::api
        API_Forms_ID_Submit["/api/forms/[id]/submit"]:::api
        API_Posts["/api/posts"]:::api
        API_Posts_ID["/api/posts/[id]"]:::api
    end

    %% Service Layer
    subgraph "Service Layer"
        direction TB
        SupabaseClient["Supabase Client"]:::service
        StorageSrv["Storage Service"]:::service
        ORMSetup["ORM & DB Setup"]:::service
        UtilsSrv["Server Utilities"]:::service
    end

    %% Data Layer
    subgraph "Data Layer"
        direction TB
        Postgres["PostgreSQL Database"]:::data
        FileStorage["Supabase Storage"]:::data
        Schema["Shared Schema & Types"]:::data
    end

    %% External Services
    subgraph "External Services"
        direction TB
        Clerk["Clerk Auth"]:::external
        Vercel["Vercel Hosting"]:::external
    end

    %% Connections
    Landing -->|"fetch via React Query"| API_Faculty
    About --> API_Faculty
    Contact --> API_Faculty
    Directory --> API_Faculty
    Profile --> API_Faculty_ID
    FormsList --> API_Forms
    FormDetail --> API_Forms_ID
    PostsList --> API_Posts
    PostDetail --> API_Posts_ID

    AdminHome --> API_Faculty
    FacultyPage --> API_Faculty
    PostsAdmin --> API_Posts
    Builder --> API_Forms
    FormsAdminList --> API_Forms_ID
    SubmissionsAdmin --> API_Forms_ID_Sub
    UserProfile --> API_Faculty_ID

    SignIn -->|"JWT"| API_Faculty_ID
    SignUp -->|"JWT"| API_Faculty_ID
    AuthLayout --> SignIn
    AuthLayout --> SignUp

    API_Faculty --> UtilsSrv
    API_Faculty_ID --> UtilsSrv
    API_Forms --> UtilsSrv
    API_Forms_ID --> UtilsSrv
    API_Forms_ID_Sub --> UtilsSrv
    API_Forms_ID_Submit --> UtilsSrv
    API_Posts --> UtilsSrv
    API_Posts_ID --> UtilsSrv

    UtilsSrv --> SupabaseClient
    SupabaseClient --> ORMSetup
    ORMSetup --> Postgres
    SupabaseClient --> FileStorage
    StorageSrv --> FileStorage
    UtilsSrv --> Schema

    Clerk --> SignIn
    Clerk --> API_Faculty_ID
    Vercel --> API_Faculty
    Vercel --> Landing

    %% Click Events
    click Landing "https://github.com/amardeeplakshkar/svcdalauda/blob/main/app/(routes)/(pages)/page.tsx"
    click About "https://github.com/amardeeplakshkar/svcdalauda/blob/main/app/(routes)/(pages)/(pages)/about/page.tsx"
    click Contact "https://github.com/amardeeplakshkar/svcdalauda/blob/main/app/(routes)/(pages)/(pages)/contact/page.tsx"
    click Directory "https://github.com/amardeeplakshkar/svcdalauda/blob/main/app/(routes)/(pages)/(pages)/faculty/page.tsx"
    click Profile "https://github.com/amardeeplakshkar/svcdalauda/blob/main/app/(routes)/(pages)/(pages)/faculty/[id]/page.tsx"
    click FormsList "https://github.com/amardeeplakshkar/svcdalauda/blob/main/app/(routes)/(pages)/(pages)/forms/page.tsx"
    click FormDetail "https://github.com/amardeeplakshkar/svcdalauda/blob/main/app/(routes)/(pages)/(pages)/forms/[id]/page.tsx"
    click PostsList "https://github.com/amardeeplakshkar/svcdalauda/blob/main/app/(routes)/(pages)/(pages)/posts/page.tsx"
    click PostDetail "https://github.com/amardeeplakshkar/svcdalauda/blob/main/app/(routes)/(pages)/(pages)/posts/[id]/page.tsx"
    click AdminLayout "https://github.com/amardeeplakshkar/svcdalauda/blob/main/app/(routes)/admin/layout.tsx"
    click AdminHome "https://github.com/amardeeplakshkar/svcdalauda/blob/main/app/(routes)/admin/page.tsx"
    click Sidebar "https://github.com/amardeeplakshkar/svcdalauda/blob/main/components/admin/app-sidebar.tsx"
    click FacultyPage "https://github.com/amardeeplakshkar/svcdalauda/blob/main/app/(routes)/admin/faculty/page.tsx"
    click FacultyCard "https://github.com/amardeeplakshkar/svcdalauda/blob/main/components/admin/Faculty/FacultyCard.tsx"
    click PostsAdmin "https://github.com/amardeeplakshkar/svcdalauda/blob/main/app/(routes)/admin/posts/page.tsx"
    click PostCard "https://github.com/amardeeplakshkar/svcdalauda/blob/main/components/admin/Faculty/PostCard.tsx"
    click Builder "https://github.com/amardeeplakshkar/svcdalauda/blob/main/app/(routes)/admin/form/builder/[id]/page.tsx"
    click FormsAdminList "https://github.com/amardeeplakshkar/svcdalauda/blob/main/app/(routes)/admin/form/forms/[id]/page.tsx"
    click SubmissionsAdmin "https://github.com/amardeeplakshkar/svcdalauda/blob/main/app/(routes)/admin/form/forms/[id]/submissions/page.tsx"
    click BuilderComponents "https://github.com/amardeeplakshkar/svcdalauda/tree/main/components/admin/FormBuilder"
    click UserProfile "https://github.com/amardeeplakshkar/svcdalauda/blob/main/app/(routes)/admin/user-profile/[[...user-profile]]/page.tsx"
    click SignIn "https://github.com/amardeeplakshkar/svcdalauda/blob/main/app/(auth)/sign-in/[[...sign-in]]/page.tsx"
    click SignUp "https://github.com/amardeeplakshkar/svcdalauda/blob/main/app/(auth)/sign-up/[[...sign-up]]/page.tsx"
    click AuthLayout "https://github.com/amardeeplakshkar/svcdalauda/blob/main/app/(auth)/layout.tsx"
    click API_Faculty "https://github.com/amardeeplakshkar/svcdalauda/blob/main/app/api/faculty/route.ts"
    click API_Faculty_ID "https://github.com/amardeeplakshkar/svcdalauda/blob/main/app/api/faculty/[id]/route.ts"
    click API_Forms "https://github.com/amardeeplakshkar/svcdalauda/blob/main/app/api/forms/route.ts"
    click API_Forms_ID "https://github.com/amardeeplakshkar/svcdalauda/blob/main/app/api/forms/[id]/route.ts"
    click API_Forms_ID_Sub "https://github.com/amardeeplakshkar/svcdalauda/blob/main/app/api/forms/[id]/submissions/route.ts"
    click API_Forms_ID_Submit "https://github.com/amardeeplakshkar/svcdalauda/blob/main/app/api/forms/[id]/submit/route.ts"
    click API_Posts "https://github.com/amardeeplakshkar/svcdalauda/blob/main/app/api/posts/route.ts"
    click API_Posts_ID "https://github.com/amardeeplakshkar/svcdalauda/blob/main/app/api/posts/[id]/route.ts"
    click SupabaseClient "https://github.com/amardeeplakshkar/svcdalauda/blob/main/lib/supabase.ts"
    click StorageSrv "https://github.com/amardeeplakshkar/svcdalauda/blob/main/lib/storage.ts"
    click ORMSetup "https://github.com/amardeeplakshkar/svcdalauda/blob/main/lib/db.ts"
    click UtilsSrv "https://github.com/amardeeplakshkar/svcdalauda/blob/main/lib/utils.ts"
    click Schema "https://github.com/amardeeplakshkar/svcdalauda/blob/main/shared/schema.ts"
    
    %% Styles
    classDef client fill:#ADD8E6,stroke:#000,stroke-width:1px
    classDef api fill:#90EE90,stroke:#000,stroke-width:1px
    classDef service fill:#FFA500,stroke:#000,stroke-width:1px
    classDef data fill:#DDA0DD,stroke:#000,stroke-width:1px
    classDef external fill:#D3D3D3,stroke:#000,stroke-width:1px
```
