# msaadg/mvmnt-financial-tracker architecture

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

- Interactive diagram: https://gitdiagram.com/msaadg/mvmnt-financial-tracker
- Repository: https://github.com/msaadg/mvmnt-financial-tracker

## Overview

##### Project type and purpose
- This is a full-stack Next.js (App Router) application that provides:
- A React-based frontend (pages under `app/` and reusable components under `app/components/`)
- A set of RESTful API endpoints (under `app/api/…`)
- A Prisma ORM layer for database access (`prisma/`, `app/lib/db.ts`)
- Authentication via NextAuth (`app/api/auth/[...nextauth]`, `middleware.ts`)
- PDF generation for receipts/reports (`app/lib/pdfGenerator.ts`, `app/api/generate-pdf/route.ts`)
- Domain-specific modules: donors/collectors, vendors, projects, dashboard, analytics, payments, etc.

##### File structure
- Top-level “app” directory houses both UI pages (`app/page.tsx`, `app/admin/page.tsx`, etc.) and API routes (`app/api/…/route.ts`).
- `app/components` and `app/components/ui` contain shared React components and a UI primitives library.
- `app/lib` holds cross-cutting libraries (DB connector, auth helpers, PDF generator, utilities).
- `prisma/` defines the data model (`schema.prisma`), migrations, seed data and cleanup scripts.
- `scripts/` contains custom Node scripts for seeding via CSV.
- Config files: `next.config.ts`, `middleware.ts`, `prisma.config.ts`, ESLint, Tailwind, TypeScript.

##### README
- Confirms Next.js, how to start dev server, uses next/font for font optimization.

## Diagram (Mermaid)

```mermaid
graph TB
  Client["Client (Browser/Mobile)"]:::external

  subgraph "Frontend (Browser/SSR/CSR)"
    subgraph "Pages"
      MainPage["app/page.tsx"]:::frontend
      Layout["app/layout.tsx"]:::frontend
      AdminPage["app/admin/page.tsx"]:::frontend
      AdminUsersPage["app/admin/users/page.tsx"]:::frontend
      DashboardPage["app/dashboard/page.tsx"]:::frontend
      AnalyticsPage["app/analytics/page.tsx"]:::frontend
      DonationsPage["app/donations/page.tsx"]:::frontend
      ExpensesPage["app/expenses/page.tsx"]:::frontend
      FundsPage["app/funds/page.tsx"]:::frontend
      PaymentsPage["app/payments/page.tsx"]:::frontend
    end
    subgraph "UI Components"
      SharedComponents["app/components/*.tsx"]:::frontend
      UIPrimitives["app/components/ui/*.tsx"]:::frontend
      HooksMobile["app/hooks/use-mobile.tsx"]:::frontend
      HooksToast["app/hooks/use-toast.tsx"]:::frontend
    end
  end

  subgraph "Public Assets"
    Public["public/"]:::frontend
    CDN["Static Assets CDN"]:::external
    Public --> CDN
  end

  subgraph "Backend (Serverless Functions)"
    subgraph "API - Admin"
      AdminCollectors["app/api/admin/collectors/route.ts"]:::backend
      AdminReferrals["app/api/admin/referrals/route.ts"]:::backend
      AdminUsersAPI["app/api/admin/users/route.ts"]:::backend
    end

    AnalyticsAPI["app/api/analytics/route.ts"]:::backend

    subgraph "API - Collectors"
      CollectorsAPI["app/api/collectors/route.ts"]:::backend
      CollectorsBalance["app/api/collectors/balance/route.ts"]:::backend
    end

    subgraph "API - Dashboard"
      DashboardAPI["app/api/dashboard/route.ts"]:::backend
      DashDonations["app/api/dashboard/donations/route.ts"]:::backend
      DashExpenses["app/api/dashboard/expenses/route.ts"]:::backend
      DashLeaderboard["app/api/dashboard/leaderboard/route.ts"]:::backend
      DashTransactions["app/api/dashboard/transactions/route.ts"]:::backend
    end

    DonationsAPI["app/api/donations/route.ts"]:::backend
    ExpensesAPI["app/api/expenses/route.ts"]:::backend
    FundsAPI["app/api/funds/route.ts"]:::backend
    PDFAPI["app/api/generate-pdf/route.ts"]:::backend
    PaymentsAPI["app/api/payments/route.ts"]:::backend
    ProjectsAPI["app/api/projects/route.ts"]:::backend

    subgraph "API - Vendors"
      VendorsAPI["app/api/vendors/route.ts"]:::backend
      VendorsBalance["app/api/vendors/balance/route.ts"]:::backend
      VendorsBalances["app/api/vendors/balances/route.ts"]:::backend
    end
  end

  subgraph "Cross-cutting Libraries"
    DBConnector["app/lib/db.ts"]:::backend
    AuthLib["app/lib/auth.ts"]:::backend
    PDFModule["app/lib/pdfGenerator.ts"]:::backend
    UtilsLib["app/lib/utils.ts"]:::backend
  end

  middleware["middleware.ts"]:::backend
  NextAuth["NextAuth Service"]:::external
  PrismaClient["Prisma Client"]:::persistence
  DB["Relational Database"]:::persistence

  %% Client flows
  Client -->|"HTTP/HTTPS"| MainPage
  Client --> AdminPage
  Client --> DashboardPage
  Client --> AnalyticsPage
  Client --> DonationsPage
  Client --> ExpensesPage
  Client --> FundsPage
  Client --> PaymentsPage

  %% Frontend component dependencies
  MainPage --> SharedComponents
  AdminPage --> SharedComponents
  DashboardPage --> SharedComponents
  AnalyticsPage --> SharedComponents
  DonationsPage --> SharedComponents
  ExpensesPage --> SharedComponents
  FundsPage --> SharedComponents
  PaymentsPage --> SharedComponents

  MainPage --> UIPrimitives
  SharedComponents --> UIPrimitives

  MainPage --> HooksMobile
  MainPage --> HooksToast

  %% API flows
  AdminCollectors --> DBConnector
  AdminReferrals --> DBConnector
  AdminUsersAPI --> DBConnector
  AnalyticsAPI --> DBConnector
  CollectorsAPI --> DBConnector
  CollectorsBalance --> DBConnector
  DashboardAPI --> DBConnector
  DashDonations --> DBConnector
  DashExpenses --> DBConnector
  DashLeaderboard --> DBConnector
  DashTransactions --> DBConnector
  DonationsAPI --> DBConnector
  ExpensesAPI --> DBConnector
  FundsAPI --> DBConnector
  PaymentsAPI --> DBConnector
  ProjectsAPI --> DBConnector
  VendorsAPI --> DBConnector
  VendorsBalance --> DBConnector
  VendorsBalances --> DBConnector

  PDFAPI --> PDFModule

  DBConnector --> PrismaClient
  AuthLib -.-> NextAuth
  middleware --> AuthLib
  AuthLib --> PrismaClient
  PrismaClient --> DB

  %% Styles
  classDef frontend fill:#D0E8FF,stroke:#0366D6,color:#0366D6
  classDef backend fill:#E6FFED,stroke:#28A745,color:#28A745
  classDef persistence fill:#F3E8FF,stroke:#6F42C1,color:#6F42C1
  classDef external fill:#FFF4E5,stroke:#D69E2E,color:#D97706

  %% Click events
  click MainPage "https://github.com/msaadg/mvmnt-financial-tracker/blob/main/app/page.tsx"
  click Layout "https://github.com/msaadg/mvmnt-financial-tracker/blob/main/app/layout.tsx"
  click AdminPage "https://github.com/msaadg/mvmnt-financial-tracker/blob/main/app/admin/page.tsx"
  click AdminUsersPage "https://github.com/msaadg/mvmnt-financial-tracker/blob/main/app/admin/users/page.tsx"
  click DashboardPage "https://github.com/msaadg/mvmnt-financial-tracker/blob/main/app/dashboard/page.tsx"
  click AnalyticsPage "https://github.com/msaadg/mvmnt-financial-tracker/blob/main/app/analytics/page.tsx"
  click DonationsPage "https://github.com/msaadg/mvmnt-financial-tracker/blob/main/app/donations/page.tsx"
  click ExpensesPage "https://github.com/msaadg/mvmnt-financial-tracker/blob/main/app/expenses/page.tsx"
  click FundsPage "https://github.com/msaadg/mvmnt-financial-tracker/blob/main/app/funds/page.tsx"
  click PaymentsPage "https://github.com/msaadg/mvmnt-financial-tracker/blob/main/app/payments/page.tsx"
  click SharedComponents "https://github.com/msaadg/mvmnt-financial-tracker/blob/main/app/components/*.tsx"
  click UIPrimitives "https://github.com/msaadg/mvmnt-financial-tracker/blob/main/app/components/ui/*.tsx"
  click HooksMobile "https://github.com/msaadg/mvmnt-financial-tracker/blob/main/app/hooks/use-mobile.tsx"
  click HooksToast "https://github.com/msaadg/mvmnt-financial-tracker/blob/main/app/hooks/use-toast.tsx"
  click AdminCollectors "https://github.com/msaadg/mvmnt-financial-tracker/blob/main/app/api/admin/collectors/route.ts"
  click AdminReferrals "https://github.com/msaadg/mvmnt-financial-tracker/blob/main/app/api/admin/referrals/route.ts"
  click AdminUsersAPI "https://github.com/msaadg/mvmnt-financial-tracker/blob/main/app/api/admin/users/route.ts"
  click AnalyticsAPI "https://github.com/msaadg/mvmnt-financial-tracker/blob/main/app/api/analytics/route.ts"
  click CollectorsAPI "https://github.com/msaadg/mvmnt-financial-tracker/blob/main/app/api/collectors/route.ts"
  click CollectorsBalance "https://github.com/msaadg/mvmnt-financial-tracker/blob/main/app/api/collectors/balance/route.ts"
  click DashboardAPI "https://github.com/msaadg/mvmnt-financial-tracker/blob/main/app/api/dashboard/route.ts"
  click DashDonations "https://github.com/msaadg/mvmnt-financial-tracker/blob/main/app/api/dashboard/donations/route.ts"
  click DashExpenses "https://github.com/msaadg/mvmnt-financial-tracker/blob/main/app/api/dashboard/expenses/route.ts"
  click DashLeaderboard "https://github.com/msaadg/mvmnt-financial-tracker/blob/main/app/api/dashboard/leaderboard/route.ts"
  click DashTransactions "https://github.com/msaadg/mvmnt-financial-tracker/blob/main/app/api/dashboard/transactions/route.ts"
  click DonationsAPI "https://github.com/msaadg/mvmnt-financial-tracker/blob/main/app/api/donations/route.ts"
  click ExpensesAPI "https://github.com/msaadg/mvmnt-financial-tracker/blob/main/app/api/expenses/route.ts"
  click FundsAPI "https://github.com/msaadg/mvmnt-financial-tracker/blob/main/app/api/funds/route.ts"
  click PDFAPI "https://github.com/msaadg/mvmnt-financial-tracker/blob/main/app/api/generate-pdf/route.ts"
  click PaymentsAPI "https://github.com/msaadg/mvmnt-financial-tracker/blob/main/app/api/payments/route.ts"
  click ProjectsAPI "https://github.com/msaadg/mvmnt-financial-tracker/blob/main/app/api/projects/route.ts"
  click VendorsAPI "https://github.com/msaadg/mvmnt-financial-tracker/blob/main/app/api/vendors/route.ts"
  click VendorsBalance "https://github.com/msaadg/mvmnt-financial-tracker/blob/main/app/api/vendors/balance/route.ts"
  click VendorsBalances "https://github.com/msaadg/mvmnt-financial-tracker/blob/main/app/api/vendors/balances/route.ts"
  click DBConnector "https://github.com/msaadg/mvmnt-financial-tracker/blob/main/app/lib/db.ts"
  click AuthLib "https://github.com/msaadg/mvmnt-financial-tracker/blob/main/app/lib/auth.ts"
  click PDFModule "https://github.com/msaadg/mvmnt-financial-tracker/blob/main/app/lib/pdfGenerator.ts"
  click UtilsLib "https://github.com/msaadg/mvmnt-financial-tracker/blob/main/app/lib/utils.ts"
  click middleware "https://github.com/msaadg/mvmnt-financial-tracker/blob/main/middleware.ts"
```
