# 5umitra/claim-management architecture

> Architecture diagram of the GitHub repository 5umitra/claim-management, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-07-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/5umitra/claim-management
- Repository: https://github.com/5umitra/claim-management

## Overview

##### Project type and purpose
- This is a full-stack MERN-style insurance “Claim Management System” currently shipping a React/TypeScript single-page frontend (using Vite + Tailwind + Material-UI) with a backend in active development (Node/Express + MongoDB + JWT + AWS serverless).
- The README clarifies core features (user onboarding, policy purchase, claims submission) and planned extensions (microservices, analytics, CI/CD, event streaming).

##### File structure
- Top-level files: Vite config (`vite.config.ts`), Tailwind config, TS config, `index.html`, `package.json`.
- `/src` holds the React app:
- `main.tsx` & `index.css` bootstrap the app
- `/components` contains shared UI (Header, Sidebar, Layout)
- `/pages` implements each route (Login, Register, Dashboard, Claims, ClaimDetails, NewClaim, Analytics, AdminPanel, Profiles, Policies)
- `/contexts` implements React Contexts (AuthContext, DataContext) for global state
- No server folder yet; backend, Docker, GitHub Actions, and serverless (AWS Lambda/Step Functions/SNS) are “coming soon.”

##### Key README insights
- Frontend currently uses LocalStorage for persistence
- Backend stack: Node.js, Express, MongoDB, JWT
- Cloud & DevOps: AWS Lambda, Step Functions, SNS for serverless; Airflow & Redshift for analytics; Kafka & Spark for streaming; Docker & GitHub Actions for CI/CD

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Frontend Layer
    subgraph "Frontend UI" 
        direction TB
        Browser[/"User Browser"/]:::frontend
        SPA["React SPA"]:::frontend
        LocalStorage(("LocalStorage")):::datastore
        Browser --> SPA
        SPA --> LocalStorage
        SPA --> API
    end

    %% SPA Composition
    subgraph "SPA Bootstrap & Core" 
        direction TB
        Index["index.html"]:::frontend
        Main["main.tsx"]:::frontend
        App["App.tsx"]:::frontend
        Index --> Main --> App
    end

    subgraph "UI Components" 
        direction TB
        Header["Header"]:::frontend
        Sidebar["Sidebar"]:::frontend
        Layout["Layout"]:::frontend
        App --> Layout
        Layout --> Header
        Layout --> Sidebar
    end

    subgraph "React Contexts" 
        direction TB
        AuthCtx["AuthContext"]:::frontend
        DataCtx["DataContext"]:::frontend
        Layout --> AuthCtx
        Layout --> DataCtx
    end

    subgraph "Route Pages" 
        direction TB
        Login["Login"]:::frontend
        Register["Register"]:::frontend
        Dashboard["Dashboard"]:::frontend
        Claims["Claims"]:::frontend
        ClaimDetails["ClaimDetails"]:::frontend
        NewClaim["NewClaim"]:::frontend
        Policies["Policies"]:::frontend
        Profile["Profile"]:::frontend
        AnalyticsPage["Analytics"]:::frontend
        Admin["AdminPanel"]:::frontend
        AuthCtx --> Login
        AuthCtx --> Register
        DataCtx --> Dashboard
        DataCtx --> Claims
        DataCtx --> ClaimDetails
        DataCtx --> NewClaim
        DataCtx --> Policies
        DataCtx --> Profile
        DataCtx --> AnalyticsPage
        DataCtx --> Admin
    end

    %% Backend Layer
    subgraph "Backend API & Microservices" 
        direction TB
        API["API Gateway / Express API"]:::backend
        AuthSvc["Auth Service"]:::backend
        PolicySvc["Policy Service"]:::backend
        ClaimsSvc["Claims Service"]:::backend
        API --> AuthSvc
        API --> PolicySvc
        API --> ClaimsSvc
        AuthSvc --> MongoDB
        PolicySvc --> MongoDB
        ClaimsSvc --> MongoDB
    end

    MongoDB[(MongoDB Atlas)]:::datastore

    %% Serverless Layer
    subgraph "Serverless Workflows" 
        direction TB
        Lambda["AWS Lambda Functions"]:::serverless
        StepFns["Step Functions"]:::serverless
        SNS["SNS Topics"]:::serverless
        ClaimsSvc --> Lambda
        Lambda --> SNS
        SNS --> StepFns
    end

    %% Analytics & Streaming
    subgraph "Analytics & Streaming" 
        direction TB
        Airflow["Airflow ETL"]:::analytics
        Redshift[(Redshift)]:::datastore
        Kafka["Kafka Streams"]:::analytics
        Spark["Spark Processing"]:::analytics
        MongoDB --> Airflow --> Redshift
        SNS --> Kafka --> Spark
    end

    %% CI/CD Pipeline
    subgraph "CI/CD & Containerization" 
        direction TB
        GHActions["GitHub Actions"]:::cicd
        DockerImg["Docker Images"]:::cicd
        GHActions --> DockerImg
        DockerImg --> Kubernetes["(Future) Kubernetes / ECS"]:::cicd
    end

    %% Connections
    SPA --> API
    ClaimsSvc --> Lambda
    API -->|"JWT Auth"| AuthSvc

    %% Click Events
    click Index "https://github.com/5umitra/claim-management/blob/main/index.html"
    click Main "https://github.com/5umitra/claim-management/blob/main/src/main.tsx"
    click App "https://github.com/5umitra/claim-management/blob/main/src/App.tsx"
    click Header "https://github.com/5umitra/claim-management/blob/main/src/components/Header.tsx"
    click Sidebar "https://github.com/5umitra/claim-management/blob/main/src/components/Sidebar.tsx"
    click Layout "https://github.com/5umitra/claim-management/blob/main/src/components/Layout.tsx"
    click AuthCtx "https://github.com/5umitra/claim-management/blob/main/src/contexts/AuthContext.tsx"
    click DataCtx "https://github.com/5umitra/claim-management/blob/main/src/contexts/DataContext.tsx"
    click Login "https://github.com/5umitra/claim-management/blob/main/src/pages/Login.tsx"
    click Register "https://github.com/5umitra/claim-management/blob/main/src/pages/Register.tsx"
    click Dashboard "https://github.com/5umitra/claim-management/blob/main/src/pages/Dashboard.tsx"
    click Claims "https://github.com/5umitra/claim-management/blob/main/src/pages/Claims.tsx"
    click ClaimDetails "https://github.com/5umitra/claim-management/blob/main/src/pages/ClaimDetails.tsx"
    click NewClaim "https://github.com/5umitra/claim-management/blob/main/src/pages/NewClaim.tsx"
    click Policies "https://github.com/5umitra/claim-management/blob/main/src/pages/Policies.tsx"
    click Profile "https://github.com/5umitra/claim-management/blob/main/src/pages/Profile.tsx"
    click AnalyticsPage "https://github.com/5umitra/claim-management/blob/main/src/pages/Analytics.tsx"
    click Admin "https://github.com/5umitra/claim-management/blob/main/src/pages/AdminPanel.tsx"
    click vite "https://github.com/5umitra/claim-management/blob/main/vite.config.ts"
    click tailwind "https://github.com/5umitra/claim-management/blob/main/tailwind.config.js"
    click postcss "https://github.com/5umitra/claim-management/blob/main/postcss.config.js"
    click tsconfig "https://github.com/5umitra/claim-management/blob/main/tsconfig.json"
    click tsapp "https://github.com/5umitra/claim-management/blob/main/tsconfig.app.json"
    click tsnode "https://github.com/5umitra/claim-management/blob/main/tsconfig.node.json"

    %% Styles
    classDef frontend fill:#AEDFF7,stroke:#0366d6,color:#000
    classDef backend fill:#B2F5B2,stroke:#228B22,color:#000
    classDef serverless fill:#FFD59E,stroke:#FF8C00,color:#000
    classDef datastore fill:#E0E0E0,stroke:#666,color:#000
    classDef analytics fill:#E1BEE7,stroke:#9C27B0,color:#000
    classDef cicd fill:#FFE082,stroke:#FFA000,color:#000
```
