How sjunqueira/fintrack works
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