# conquera99/vms architecture

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

- Interactive diagram: https://gitdiagram.com/conquera99/vms
- Repository: https://github.com/conquera99/vms

## Overview

##### Main Architecture Components

A. Frontend Layer (Client-Side):
- Pages (Public Routes)
- Home
- Campaign
- Gallery
- Post
- Profile
- Admin Dashboard
- User Management
- Content Management
- Campaign Management
- Shared Components
- Components
- Entry Components
- Navigation Components

B. API Layer (Server-Side):
- Authentication API (/api/auth)
- Admin API (/api/admin)
- Public API (/api/gallery, /api/campaign, /api/post)

C. Database Layer:
- A container labeled "Database" showing:
- Prisma ORM
- Database Tables (based on migrations):
- Users
- Permissions
- Items
- Campaigns
- Posts
- Images
- Deceased Records
- Locations

D. External Services:
- Containers for:
- Cloudinary (Image Storage)
- NextAuth.js (Authentication)
- Google Analytics

##### Connection Flows

- Server-to-Database: Show Prisma ORM interactions
- External Service Interactions: Indicate authentication flows and media storage

##### Technical Details

Annotations for:
- Next.js
- Prisma ORM
- TypeScript
- TailwindCSS
- Custom hooks and utilities

##### Additional Notes

Notes about:
- Authentication flow
- Image upload process
- Campaign management workflow
- Content management process
- API security measures

- Custom styling
- Export to high-resolution formats

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Frontend
        PublicRoutes["Public Routes"]
        AdminDash["Admin Dashboard"]
        SharedComp["Shared Components"]
        
        subgraph PublicRoutes
            Home["Home"]:::frontend
            Campaign["Campaign"]:::frontend
            Gallery["Gallery"]:::frontend
            Post["Post"]:::frontend
            Profile["Profile"]:::frontend
        end
        
        subgraph AdminDash
            UserMgmt["User Management"]:::frontend
            ContentMgmt["Content Management"]:::frontend
            CampaignMgmt["Campaign Management"]:::frontend
        end
        
        subgraph SharedComp
            DisplayComp["Display Components"]:::frontend
            EntryComp["Entry Components"]:::frontend
            NavComp["Navigation Components"]:::frontend
        end
    end
    
    subgraph APILayer
        AuthAPI["Authentication API"]:::api
        AdminAPI["Admin API"]:::api
        PublicAPI["Public API"]:::api
        
        subgraph PublicAPI
            GalleryAPI["Gallery API"]:::api
            CampaignAPI["Campaign API"]:::api
            PostAPI["Post API"]:::api
        end
    end
    
    subgraph Database
        PrismaORM["Prisma ORM"]:::db
        
        subgraph Tables
            Users[(Users)]:::db
            Permissions[(Permissions)]:::db
            Items[(Items)]:::db
            Campaigns[(Campaigns)]:::db
            Posts[(Posts)]:::db
            Images[(Images)]:::db
            DeceasedRecords[(Deceased Records)]:::db
            Locations[(Locations)]:::db
        end
    end
    
    subgraph ExternalServices
        Cloudinary["Cloudinary"]:::external
        NextAuth["NextAuth.js"]:::external
        GA["Google Analytics"]:::external
    end
    
    %% Connections
    PublicRoutes --> PublicAPI
    AdminDash --> AdminAPI
    PublicAPI --> PrismaORM
    AdminAPI --> PrismaORM
    AuthAPI --> NextAuth
    PrismaORM --> Tables
    SharedComp --> PublicAPI
    SharedComp --> AdminAPI
    
    %% External Service Connections
    PublicAPI --> Cloudinary
    AdminAPI --> Cloudinary
    Frontend --> GA
    
    %% Styling
    classDef frontend fill:#3b82f6,color:#fff
    classDef api fill:#22c55e,color:#fff
    classDef db fill:#eab308,color:#fff
    classDef external fill:#a855f7,color:#fff
    
    %% Click Events
    click Home "https://github.com/conquera99/vms/blob/main/src/pages/index.tsx"
    click Campaign "https://github.com/conquera99/vms/tree/main/src/pages/campaign"
    click Gallery "https://github.com/conquera99/vms/tree/main/src/pages/gallery"
    click Post "https://github.com/conquera99/vms/tree/main/src/pages/post"
    click Profile "https://github.com/conquera99/vms/tree/main/src/pages/profile"
    click AdminDash "https://github.com/conquera99/vms/tree/main/src/pages/admin/"
    click DisplayComp "https://github.com/conquera99/vms/tree/main/src/components/display/"
    click EntryComp "https://github.com/conquera99/vms/tree/main/src/components/entry/"
    click NavComp "https://github.com/conquera99/vms/tree/main/src/components/navigation/"
    click AuthAPI "https://github.com/conquera99/vms/blob/main/src/pages/api/auth/[...nextauth].ts"
    click AdminAPI "https://github.com/conquera99/vms/tree/main/src/pages/api/admin/"
    click CampaignAPI "https://github.com/conquera99/vms/tree/main/src/pages/api/campaign/"
    click GalleryAPI "https://github.com/conquera99/vms/tree/main/src/pages/api/gallery/"
    click PostAPI "https://github.com/conquera99/vms/blob/main/src/pages/api/post.ts"
    click PrismaORM "https://github.com/conquera99/vms/blob/main/src/db/schema.prisma"
    click Cloudinary "https://github.com/conquera99/vms/blob/main/src/utils/cloudinary.ts"
    click NextAuth "https://github.com/conquera99/vms/blob/main/src/pages/api/auth/[...nextauth].ts"
    click GA "https://github.com/conquera99/vms/blob/main/src/utils/ga.ts"
```
