# sjunqueira/fintrack architecture

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

- Interactive diagram: https://gitdiagram.com/sjunqueira/fintrack
- Repository: https://github.com/sjunqueira/fintrack

## Overview

##### Project Type and Purpose
- This is a full-stack web application built with Next.js (App Router) that provides user authentication (via NextAuth) and basic transaction management backed by a relational database (Prisma + Postgres).
- The README confirms it was bootstrapped with create-next-app and runs on localhost:3000.

##### File Structure Analysis
- Top-level directories/files:
- infra/ — houses development infrastructure (docker-compose.yaml for local Postgres, Prisma migrations, Husky pre-commit hook)
- src/app/ — Next.js App Router directory (pages, components, API routes)
- src/app/_lib/prisma.ts — Prisma client setup
- src/app/api/auth/[...nextauth]/route.ts — NextAuth authentication routes
- public/, globals.css, tailwind.config.js — static assets and styling
- Configuration files: next.config.ts (Next.js config), tsconfig.json, eslint.config.mjs, .prettierrc.json, .lintstagedrc.json, package.json.

##### Key Architectural Notes from README
- Uses Next.js features (server components, API routes, font optimization)
- Local development uses Docker Compose to spin up the database and Prisma migrations

##### Main Components
a. User’s Web Browser (Client)
b. Next.js Application (Server & SSR/SSG)
- App Router Pages (Dashboard, Login, Transactions)
- UI Component Library
- API Routes module (Auth endpoints)
c. Authentication Service (NextAuth)
- Credentials & OAuth with Google
d. Database Layer
- Prisma Client
- PostgreSQL Database (in Docker)
- Migration Scripts (infra/prisma/migrations)
e. Development Infrastructure
- Docker Compose (infra/docker-compose.yaml)
- Husky pre-commit Hook (infra/.husky/pre-commit)

##### Interactions & Data Flows
- Client → Next.js Server: requests for pages and static assets
- Next.js Server → NextAuth: authentication flows (sign-in, sign-out)
- NextAuth → External OAuth Provider (Google)
- Next.js API Routes → Prisma Client → PostgreSQL (CRUD on transactions & user sessions)
- Prisma Migrations → PostgreSQL for schema evolution

##### Architectural Patterns & Design Principles
- App Router (Next.js) for file-system-based routing
- “API routes” stateless functions for server logic
- Prisma ORM for type-safe data access
- Docker Compose for local infra reproducibility
- Separation of concerns: UI components vs. data layer vs. auth

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Presentation Layer
    subgraph "Presentation Layer"
        Browser["User's Web Browser"]:::client
    end

    %% Application Layer
    subgraph "Application Layer"
        subgraph "Next.js App Router"
            subgraph "UI Pages"
                RootLayout["layout.tsx"]:::frontend
                HomePage["page.tsx"]:::frontend
                DashboardPage["dashboard/page.tsx"]:::frontend
                LoginPage["login/page.tsx"]:::frontend
                TransactionsPage["transactions/page.tsx"]:::frontend
            end
            subgraph "UI Component Library"
                Alert["alert-dialog.tsx"]:::frontend
                Avatar["avatar.tsx"]:::frontend
                Button["button.tsx"]:::frontend
                GoogleLogo["google-logo.tsx"]:::frontend
                Input["input.tsx"]:::frontend
                LoadingSpinner["loadingspinner.tsx"]:::frontend
                Separator["separator.tsx"]:::frontend
                Header["header.tsx"]:::frontend
                SignInCmp["signin.tsx"]:::frontend
                SignOutCmp["signout.tsx"]:::frontend
            end
            subgraph "API Routes"
                NextAuthRoute["[...nextauth]/route.ts"]:::backend
                NextAuthOptions["options.ts"]:::backend
                API["CRUD Endpoints"]:::backend
            end
        end
        PrismaClient["Prisma Client\n(prisma.ts)"]:::database
    end

    %% Data Layer
    subgraph "Data Layer"
        Postgres["PostgreSQL DB\n(in Docker)"]:::database
    end

    %% External Services
    subgraph "External Services"
        GoogleOAuth["Google OAuth"]:::external
    end

    %% Development Infra
    subgraph "Development Infra"
        DockerCompose["docker-compose.yaml"]:::infra
        Migrations["Prisma Migrations"]:::infra
        Husky["pre-commit Hook"]:::infra
    end

    %% Connections
    Browser -->|HTTP/HTTPS| HomePage
    Browser -->|HTTP/HTTPS| DashboardPage
    Browser -->|HTTP/HTTPS| LoginPage
    Browser -->|HTTP/HTTPS| TransactionsPage
    Browser -->|HTTP/JSON| NextAuthRoute
    Browser -->|HTTP/JSON| API

    NextAuthRoute -->|uses| NextAuthOptions
    NextAuthRoute -.->|OAuth flow| GoogleOAuth
    API -->|Prisma Query| PrismaClient
    PrismaClient -->|SQL Queries| Postgres
    DockerCompose -->|provisions| Postgres
    Migrations -->|schemas| Postgres

    %% Click Events
    click RootLayout "https://github.com/sjunqueira/fintrack/blob/main/src/app/layout.tsx"
    click HomePage "https://github.com/sjunqueira/fintrack/blob/main/src/app/page.tsx"
    click DashboardPage "https://github.com/sjunqueira/fintrack/blob/main/src/app/(pages)/dashboard/page.tsx"
    click LoginPage "https://github.com/sjunqueira/fintrack/blob/main/src/app/(pages)/login/page.tsx"
    click TransactionsPage "https://github.com/sjunqueira/fintrack/blob/main/src/app/(pages)/transactions/page.tsx"
    click Alert "https://github.com/sjunqueira/fintrack/blob/main/src/app/_components/ui/alert-dialog.tsx"
    click Avatar "https://github.com/sjunqueira/fintrack/blob/main/src/app/_components/ui/avatar.tsx"
    click Button "https://github.com/sjunqueira/fintrack/blob/main/src/app/_components/ui/button.tsx"
    click GoogleLogo "https://github.com/sjunqueira/fintrack/blob/main/src/app/_components/ui/google-logo.tsx"
    click Input "https://github.com/sjunqueira/fintrack/blob/main/src/app/_components/ui/input.tsx"
    click LoadingSpinner "https://github.com/sjunqueira/fintrack/blob/main/src/app/_components/ui/loadingspinner.tsx"
    click Separator "https://github.com/sjunqueira/fintrack/blob/main/src/app/_components/ui/separator.tsx"
    click Header "https://github.com/sjunqueira/fintrack/blob/main/src/app/_components/header.tsx"
    click SignInCmp "https://github.com/sjunqueira/fintrack/blob/main/src/app/_components/signin.tsx"
    click SignOutCmp "https://github.com/sjunqueira/fintrack/blob/main/src/app/_components/signout.tsx"
    click NextAuthRoute "https://github.com/sjunqueira/fintrack/blob/main/src/app/api/auth/[...nextauth]/route.ts"
    click NextAuthOptions "https://github.com/sjunqueira/fintrack/blob/main/src/app/api/auth/options.ts"
    click PrismaClient "https://github.com/sjunqueira/fintrack/blob/main/src/app/_lib/prisma.ts"
    click DockerCompose "https://github.com/sjunqueira/fintrack/blob/main/infra/docker-compose.yaml"
    click Migrations "https://github.com/sjunqueira/fintrack/tree/main/infra/prisma/migrations/"
    click Husky "https://github.com/sjunqueira/fintrack/tree/main/infra/.husky/pre-commit"

    %% Styles
    classDef frontend fill:#E3F2FD,stroke:#90CAF9,stroke-width:1px
    classDef backend fill:#E8F5E9,stroke:#66BB6A,stroke-width:1px
    classDef database fill:#FFF3E0,stroke:#FFB74D,stroke-width:1px
    classDef external fill:#F3E5F5,stroke:#AB47BC,stroke-width:1px
    classDef infra fill:#ECEFF1,stroke:#78909C,stroke-width:1px
    classDef client fill:#E1F5FE,stroke:#29B6F6,stroke-width:1px
```
