# thesiddcode/legal-compass architecture

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

- Interactive diagram: https://gitdiagram.com/thesiddcode/legal-compass
- Repository: https://github.com/thesiddcode/legal-compass

## Overview

##### Project type and purpose
- This is a full-stack web application called “Legal Compass AI” with a focus on secure payment via Razorpay.
- Frontend: React + TypeScript (Vite)
- Backend: Node.js + Express + TypeScript
- Data store: MongoDB for persisting users and payment records
- External service: Razorpay for payment processing

##### File structure
Top-level:
- backend/ – Express service
– src/controllers (auth.controller.ts, payment.controller.ts)
– src/routes (auth.routes.ts, payment.routes.ts)
– src/services (auth.service.ts, razorpay.service.ts)
– src/models (user.model.ts, Payment.ts)
– src/middleware (auth.middleware.ts)
– src/index.ts (server bootstrap)
- src/ – Frontend app
– components/ (UI components + payment page/button)
– contexts/AuthContext.tsx (React context for auth)
– hooks/ (custom hooks)
– integrations/supabase (optional user‐auth integration)
– lib/mongodb.ts (client for direct DB access if any)
– pages/ (React Router pages: Index, PaymentPage, Lawyers, etc.)
– server/api.ts (Vite-based proxy or server routes?)
- Configuration files: tsconfig.json, vite.config.ts, postcss.config.js, tailwind.config.ts
- Public assets: index.html, public/robots.txt

##### README for additional insights
- Describes two primary API endpoints: create-order and verify-payment
- Emphasizes environment variables for Razorpay keys and MongoDB URI
- Outlines the frontend flow: payment button → Razorpay checkout → success/failure callbacks
- Security best practices: secret keys on backend, input validation, error handling

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Frontend Layer
    subgraph "Frontend (Browser)" 
        direction TB
        React["React SPA"]:::frontend
        PaymentPage["PaymentPage"]:::frontend
        PaymentButton["PaymentButton"]:::frontend
        AuthContext["AuthContext"]:::frontend
        SupabaseClient["Supabase Auth Client"]:::external
        ViteAPI["Vite API Proxy"]:::frontend
    end

    %% Backend Layer
    subgraph "Backend (Server)" 
        direction TB
        ExpressAPI["Express API"]:::backend
        subgraph "Controllers"
            direction TB
            AuthController["AuthController"]:::backend
            PaymentController["PaymentController"]:::backend
        end
        subgraph "Services"
            direction TB
            AuthService["AuthService"]:::backend
            RazorpayService["RazorpayService"]:::backend
        end
        AuthMiddleware["AuthMiddleware"]:::backend
    end

    %% Data & External Services
    MongoDB["MongoDB"]:::database
    RazorpayAPI["Razorpay API"]:::external
    SupabaseAuth["Supabase Auth API"]:::external
    ConfigBackend["Env & Config (.env)"]:::config
    ConfigRoot["Root Env & Config"]:::config
    Assets["Public Assets"]:::config

    %% Data Models
    UserModel["User Model"]:::backend
    PaymentModel["Payment Model"]:::backend

    %% Connections - Frontend to Backend
    React -->|"User Interaction"| PaymentPage
    PaymentPage -->|"renders"| PaymentButton
    PaymentButton -->|"POST /api/payments/create-order"| ViteAPI
    AuthContext -->|"attaches JWT"| React
    SupabaseClient -->|"Auth requests"| SupabaseAuth
    ViteAPI -->|"proxy HTTP"| ExpressAPI

    %% Backend internal flows
    ExpressAPI -->|"route /auth"| AuthController
    ExpressAPI -->|"route /payments"| PaymentController
    AuthController -->|"uses"| AuthService
    PaymentController -->|"uses"| RazorpayService
    ExpressAPI -->|"apply"| AuthMiddleware
    AuthService -->|"reads/writes"| UserModel
    RazorpayService -->|"reads/writes"| PaymentModel

    %% Backend to Data & External
    ExpressAPI -->|"connect"| MongoDB
    RazorpayService -->|"HTTPS API calls"| RazorpayAPI
    AuthService -->|"HTTPS API calls"| SupabaseAuth
    ExpressAPI -->|"load"| ConfigBackend

    %% Root Config & Assets
    React -->|"build config"| ConfigRoot
    React -->|"serve"| Assets

    %% Click Events
    click React "https://github.com/thesiddcode/legal-compass/blob/main/src/main.tsx"
    click PaymentPage "https://github.com/thesiddcode/legal-compass/blob/main/src/components/PaymentPage.tsx"
    click PaymentButton "https://github.com/thesiddcode/legal-compass/blob/main/src/components/PaymentButton.tsx"
    click AuthContext "https://github.com/thesiddcode/legal-compass/blob/main/src/contexts/AuthContext.tsx"
    click SupabaseClient "https://github.com/thesiddcode/legal-compass/blob/main/src/integrations/supabase/client.ts"
    click ViteAPI "https://github.com/thesiddcode/legal-compass/blob/main/src/server/api.ts"
    click ExpressAPI "https://github.com/thesiddcode/legal-compass/blob/main/backend/src/index.ts"
    click AuthController "https://github.com/thesiddcode/legal-compass/blob/main/backend/src/controllers/auth.controller.ts"
    click PaymentController "https://github.com/thesiddcode/legal-compass/blob/main/backend/src/controllers/payment.controller.ts"
    click AuthService "https://github.com/thesiddcode/legal-compass/blob/main/backend/src/services/auth.service.ts"
    click RazorpayService "https://github.com/thesiddcode/legal-compass/blob/main/backend/src/services/razorpay.service.ts"
    click AuthMiddleware "https://github.com/thesiddcode/legal-compass/blob/main/backend/src/middleware/auth.middleware.ts"
    click UserModel "https://github.com/thesiddcode/legal-compass/blob/main/backend/src/models/user.model.ts"
    click PaymentModel "https://github.com/thesiddcode/legal-compass/blob/main/backend/src/models/Payment.ts"
    click ConfigBackend "https://github.com/thesiddcode/legal-compass/blob/main/backend/.env"
    click ConfigRoot "https://github.com/thesiddcode/legal-compass/blob/main/.env"
    click ConfigRoot "https://github.com/thesiddcode/legal-compass/blob/main/tsconfig.json"
    click ConfigRoot "https://github.com/thesiddcode/legal-compass/blob/main/vite.config.ts"
    click Assets "https://github.com/thesiddcode/legal-compass/blob/main/index.html"
    click Assets "https://github.com/thesiddcode/legal-compass/blob/main/public/robots.txt"

    %% Styles
    classDef frontend fill:#E0F7FA,stroke:#006064,stroke-width:1px;
    classDef backend fill:#E8F5E9,stroke:#1B5E20,stroke-width:1px;
    classDef external fill:#FFF3E0,stroke:#E65100,stroke-width:1px;
    classDef database fill:#ECEFF1,stroke:#37474F,stroke-width:1px,stroke-dasharray: 5 5;
    classDef config fill:#F3E5F5,stroke:#4A148C,stroke-width:1px;
```
