# mwasobaddy/invoice_app architecture

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

- Interactive diagram: https://gitdiagram.com/mwasobaddy/invoice_app
- Repository: https://github.com/mwasobaddy/invoice_app

## Overview

Invoice Atlas is a workspace-based invoice and budget management application. A user signs in, manages clients and invoices, records expenses against budgets, and reviews dashboard analytics; the API routes persist those records and expose exports and document generation. Authentication, validation, audit logging, and Prisma form the internal service layer. The README documents major product capabilities and endpoints; source excerpts confirm selected route-to-service and service-to-store calls, while several listed subsystems were not sampled in source.

Main entry points: [`src/lib/prisma.ts`](https://github.com/mwasobaddy/invoice_app/blob/main/src/lib/prisma.ts) (Prisma data access), [`src/app/api/expenses/route.ts`](https://github.com/mwasobaddy/invoice_app/blob/main/src/app/api/expenses/route.ts) (Expense API), [`src/app/api/invoices/route.ts`](https://github.com/mwasobaddy/invoice_app/blob/main/src/app/api/invoices/route.ts) (Invoice API), [`src/lib/auth-utils.ts`](https://github.com/mwasobaddy/invoice_app/blob/main/src/lib/auth-utils.ts) (Auth helpers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and workspaces"]
  node_authui["Sign-in and signup<br/>[page.tsx]"]
  node_authapi["Authentication API<br/>[route.ts]"]
  node_auth["Auth provider<br/>[auth.ts]"]
  node_orgapi["Workspace management<br/>[route.ts]"]
end

subgraph group_finance["Invoices and spending"]
  node_clients["Client management<br/>[route.ts]"]
  node_invoiceui["Invoice workspace<br/>[page.tsx]"]
  node_invoices["Invoice API<br/>[route.ts]"]
  node_invoiceextras["Invoice documents and export"]
  node_budgetui["Budget workspace<br/>[page.tsx]"]
  node_budgets["Budget API<br/>[route.ts]"]
  node_expenseui["Expense workspace<br/>[page.tsx]"]
  node_expenses["Expense API<br/>[route.ts]"]
end

subgraph group_insights["Dashboard and analytics"]
  node_dashboard["Dashboard pages<br/>[page.tsx]"]
  node_analytics["Dashboard analytics<br/>[route.ts]"]
  node_chart["Chart client<br/>[ChartClient.tsx]"]
end

subgraph group_services["Application services"]
  node_authutils["Auth helpers<br/>[auth-utils.ts]"]
  node_validation["Request validation<br/>[schemas.ts]"]
  node_audit["Audit logging<br/>[audit.ts]"]
  node_prisma["Prisma data access<br/>[prisma.ts]"]
  node_database[("PostgreSQL")]
end

subgraph group_integrations["Automation and integrations"]
  node_receiptai["Receipt parsing<br/>[route.ts]"]
  node_receiptupload["Receipt upload<br/>[route.ts]"]
  node_crons["Scheduled tasks"]
  node_webhooks["Webhook endpoint<br/>[route.ts]"]
end

node_user(("User"))

node_user -->|"signs in"| node_authui
node_authui -.->|"registers"| node_authapi
node_authapi -->|"uses auth helpers"| node_authutils
node_auth -->|"reads users"| node_prisma
node_auth -->|"provides sessions"| node_authutils
node_user -->|"manages workspaces"| node_orgapi
node_orgapi -->|"reads and writes"| node_prisma
node_orgapi -->|"logs changes"| node_audit
node_user -->|"manages clients"| node_clients
node_user -->|"creates invoices"| node_invoiceui
node_invoiceui -.->|"uses endpoints"| node_invoices
node_invoices -->|"requires authentication"| node_authutils
node_invoices -->|"validates input"| node_validation
node_invoices -->|"reads and writes"| node_prisma
node_invoices -->|"logs changes"| node_audit
node_invoiceui -->|"exports and renders"| node_invoiceextras
node_user -->|"sets budgets"| node_budgetui
node_budgetui -.->|"uses endpoints"| node_budgets
node_budgets -->|"validates input"| node_validation
node_budgets -->|"reads and writes"| node_prisma
node_user -->|"records expenses"| node_expenseui
node_expenseui -.->|"uses endpoints"| node_expenses
node_expenses -->|"validates input"| node_validation
node_expenses -->|"records spending"| node_prisma
node_expenses -->|"logs changes"| node_audit
node_expenses -->|"updates budget totals"| node_budgets
node_user -->|"reviews metrics"| node_dashboard
node_dashboard -.->|"loads chart data"| node_analytics
node_chart -.->|"requests chart data"| node_analytics
node_analytics -->|"requires authentication"| node_authutils
node_analytics -->|"queries analytics"| node_prisma
node_receiptai -->|"checks access"| node_authutils
node_receiptai -->|"uses stored settings"| node_prisma
node_receiptupload -.->|"attaches receipts"| node_expenses
node_crons -.->|"updates records"| node_prisma
node_webhooks -->|"records events"| node_prisma
node_prisma -->|"queries"| node_database

click node_authui "https://github.com/mwasobaddy/invoice_app/blob/main/src/app/auth/signin/page.tsx"
click node_authapi "https://github.com/mwasobaddy/invoice_app/blob/main/src/app/api/auth/register/route.ts"
click node_auth "https://github.com/mwasobaddy/invoice_app/blob/main/src/lib/auth.ts"
click node_authutils "https://github.com/mwasobaddy/invoice_app/blob/main/src/lib/auth-utils.ts"
click node_orgapi "https://github.com/mwasobaddy/invoice_app/blob/main/src/app/api/orgs/route.ts"
click node_clients "https://github.com/mwasobaddy/invoice_app/blob/main/src/app/api/clients/route.ts"
click node_invoiceui "https://github.com/mwasobaddy/invoice_app/blob/main/src/app/dashboard/invoices/page.tsx"
click node_invoices "https://github.com/mwasobaddy/invoice_app/blob/main/src/app/api/invoices/route.ts"
click node_invoiceextras "https://github.com/mwasobaddy/invoice_app/tree/main/src/app/api/invoices"
click node_budgetui "https://github.com/mwasobaddy/invoice_app/blob/main/src/app/dashboard/budgets/page.tsx"
click node_budgets "https://github.com/mwasobaddy/invoice_app/blob/main/src/app/api/budgets/route.ts"
click node_expenseui "https://github.com/mwasobaddy/invoice_app/blob/main/src/app/dashboard/expenses/page.tsx"
click node_expenses "https://github.com/mwasobaddy/invoice_app/blob/main/src/app/api/expenses/route.ts"
click node_dashboard "https://github.com/mwasobaddy/invoice_app/blob/main/src/app/dashboard/page.tsx"
click node_analytics "https://github.com/mwasobaddy/invoice_app/blob/main/src/app/api/dashboard/chart-data/route.ts"
click node_chart "https://github.com/mwasobaddy/invoice_app/blob/main/src/components/ChartClient.tsx"
click node_validation "https://github.com/mwasobaddy/invoice_app/blob/main/src/lib/schemas.ts"
click node_audit "https://github.com/mwasobaddy/invoice_app/blob/main/src/lib/audit.ts"
click node_prisma "https://github.com/mwasobaddy/invoice_app/blob/main/src/lib/prisma.ts"
click node_receiptai "https://github.com/mwasobaddy/invoice_app/blob/main/src/app/api/ai/parse-receipt/route.ts"
click node_receiptupload "https://github.com/mwasobaddy/invoice_app/blob/main/src/app/api/expenses/upload/route.ts"
click node_crons "https://github.com/mwasobaddy/invoice_app/tree/main/src/app/api/crons"
click node_webhooks "https://github.com/mwasobaddy/invoice_app/blob/main/src/app/api/webhooks/route.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_authui,node_authapi,node_auth,node_orgapi,node_user toneBlue
class node_clients,node_invoiceui,node_invoices,node_invoiceextras,node_budgetui,node_budgets,node_expenseui,node_expenses toneAmber
class node_dashboard,node_analytics,node_chart toneMint
class node_authutils,node_validation,node_audit,node_prisma,node_database toneRose
class node_receiptai,node_receiptupload,node_crons,node_webhooks toneIndigo
```

## Components

### Identity and workspaces

- [Sign-in and signup](https://github.com/mwasobaddy/invoice_app/blob/main/src/app/auth/signin/page.tsx): `src/app/auth/signin/page.tsx`
- [Authentication API](https://github.com/mwasobaddy/invoice_app/blob/main/src/app/api/auth/register/route.ts): `src/app/api/auth/register/route.ts`
- [Auth provider](https://github.com/mwasobaddy/invoice_app/blob/main/src/lib/auth.ts): `src/lib/auth.ts`
- [Workspace management](https://github.com/mwasobaddy/invoice_app/blob/main/src/app/api/orgs/route.ts): `src/app/api/orgs/route.ts`

### Invoices and spending

- [Client management](https://github.com/mwasobaddy/invoice_app/blob/main/src/app/api/clients/route.ts): `src/app/api/clients/route.ts`
- [Invoice workspace](https://github.com/mwasobaddy/invoice_app/blob/main/src/app/dashboard/invoices/page.tsx): `src/app/dashboard/invoices/page.tsx`
- [Invoice API](https://github.com/mwasobaddy/invoice_app/blob/main/src/app/api/invoices/route.ts): `src/app/api/invoices/route.ts`
- [Invoice documents and export](https://github.com/mwasobaddy/invoice_app/tree/main/src/app/api/invoices): `src/app/api/invoices`
- [Budget workspace](https://github.com/mwasobaddy/invoice_app/blob/main/src/app/dashboard/budgets/page.tsx): `src/app/dashboard/budgets/page.tsx`
- [Budget API](https://github.com/mwasobaddy/invoice_app/blob/main/src/app/api/budgets/route.ts): `src/app/api/budgets/route.ts`
- [Expense workspace](https://github.com/mwasobaddy/invoice_app/blob/main/src/app/dashboard/expenses/page.tsx): `src/app/dashboard/expenses/page.tsx`
- [Expense API](https://github.com/mwasobaddy/invoice_app/blob/main/src/app/api/expenses/route.ts): `src/app/api/expenses/route.ts`

### Dashboard and analytics

- [Dashboard pages](https://github.com/mwasobaddy/invoice_app/blob/main/src/app/dashboard/page.tsx): `src/app/dashboard/page.tsx`
- [Dashboard analytics](https://github.com/mwasobaddy/invoice_app/blob/main/src/app/api/dashboard/chart-data/route.ts): `src/app/api/dashboard/chart-data/route.ts`
- [Chart client](https://github.com/mwasobaddy/invoice_app/blob/main/src/components/ChartClient.tsx): `src/components/ChartClient.tsx`

### Application services

- [Auth helpers](https://github.com/mwasobaddy/invoice_app/blob/main/src/lib/auth-utils.ts): `src/lib/auth-utils.ts`
- [Request validation](https://github.com/mwasobaddy/invoice_app/blob/main/src/lib/schemas.ts): `src/lib/schemas.ts`
- [Audit logging](https://github.com/mwasobaddy/invoice_app/blob/main/src/lib/audit.ts): `src/lib/audit.ts`
- [Prisma data access](https://github.com/mwasobaddy/invoice_app/blob/main/src/lib/prisma.ts): `src/lib/prisma.ts`
- **PostgreSQL**

### Automation and integrations

- [Receipt parsing](https://github.com/mwasobaddy/invoice_app/blob/main/src/app/api/ai/parse-receipt/route.ts): `src/app/api/ai/parse-receipt/route.ts`
- [Receipt upload](https://github.com/mwasobaddy/invoice_app/blob/main/src/app/api/expenses/upload/route.ts): `src/app/api/expenses/upload/route.ts`
- [Scheduled tasks](https://github.com/mwasobaddy/invoice_app/tree/main/src/app/api/crons): `src/app/api/crons`
- [Webhook endpoint](https://github.com/mwasobaddy/invoice_app/blob/main/src/app/api/webhooks/route.ts): `src/app/api/webhooks/route.ts`

### Other components

- **User**

## Connections

- User → Sign-in and signup: signs in
- Sign-in and signup → Authentication API: registers
- Authentication API → Auth helpers: uses auth helpers (evidence: `src/app/api/auth/register/route.ts`)
- Auth provider → Prisma data access: reads users (evidence: `src/lib/auth.ts`)
- Auth provider → Auth helpers: provides sessions (evidence: `src/lib/auth-utils.ts`)
- User → Workspace management: manages workspaces
- Workspace management → Prisma data access: reads and writes (evidence: `src/app/api/orgs/route.ts`)
- Workspace management → Audit logging: logs changes (evidence: `src/app/api/orgs/route.ts`)
- User → Client management: manages clients
- User → Invoice workspace: creates invoices
- Invoice workspace → Invoice API: uses endpoints
- Invoice API → Auth helpers: requires authentication (evidence: `src/app/api/invoices/route.ts`)
- Invoice API → Request validation: validates input (evidence: `src/app/api/invoices/route.ts`)
- Invoice API → Prisma data access: reads and writes (evidence: `src/app/api/invoices/route.ts`)
- Invoice API → Audit logging: logs changes (evidence: `src/app/api/invoices/route.ts`)
- Invoice workspace → Invoice documents and export: exports and renders
- User → Budget workspace: sets budgets
- Budget workspace → Budget API: uses endpoints
- Budget API → Request validation: validates input (evidence: `src/app/api/budgets/route.ts`)
- Budget API → Prisma data access: reads and writes (evidence: `src/app/api/budgets/route.ts`)
- User → Expense workspace: records expenses
- Expense workspace → Expense API: uses endpoints
- Expense API → Request validation: validates input (evidence: `src/app/api/expenses/route.ts`)
- Expense API → Prisma data access: records spending (evidence: `src/app/api/expenses/route.ts`)
- Expense API → Audit logging: logs changes (evidence: `src/app/api/expenses/route.ts`)
- Expense API → Budget API: updates budget totals (evidence: `src/app/api/expenses/route.ts`)
- User → Dashboard pages: reviews metrics
- Dashboard pages → Dashboard analytics: loads chart data
- Chart client → Dashboard analytics: requests chart data
- Dashboard analytics → Auth helpers: requires authentication (evidence: `src/app/api/dashboard/chart-data/route.ts`)
- Dashboard analytics → Prisma data access: queries analytics (evidence: `src/app/api/dashboard/chart-data/route.ts`)
- Receipt parsing → Auth helpers: checks access (evidence: `src/app/api/ai/parse-receipt/route.ts`)
- Receipt parsing → Prisma data access: uses stored settings (evidence: `src/app/api/ai/parse-receipt/route.ts`)
- Receipt upload → Expense API: attaches receipts
- Scheduled tasks → Prisma data access: updates records (evidence: `src/app/api/crons/recurring/route.ts`)
- Webhook endpoint → Prisma data access: records events (evidence: `src/app/api/webhooks/route.ts`)
- Prisma data access → PostgreSQL: queries (evidence: `src/lib/prisma.ts`)
