​

Introduction to Your Finance App

​

What is Your Finance App?

• Track Income and Expenses - Record all financial transactions with detailed information
• Categorize Transactions - Organize your finances with flexible categorization
• Multi-Currency Support - Handle transactions in ARS, USD, and EUR
• Automatic Balance Calculation - View your financial status in real-time
• Advanced Filtering - Filter transactions by date, type, category, and more
• Secure Authentication - JWT-based authentication system
• Data History - Soft delete pattern maintains complete transaction history

​

Who is This For?

​

Ideal for You If:

• You’re learning web development and want to see real-world patterns
• You know JavaScript/TypeScript basics and want to level up
• You want to understand how modern backend applications are structured
• You’re looking for well-documented, production-ready code examples
• You’re interested in learning NestJS, Prisma, or PostgreSQL

​

No Prior Experience Needed With:

• NestJS - You’ll learn it through this project
• Prisma - Everything is explained step by step
• PostgreSQL - We start from the basics
• Design Patterns - They’re demonstrated in the codebase

​

Key Features

​

Financial Management

• Complete CRUD operations for transactions
• Real-time balance calculation across multiple currencies
• Soft delete for maintaining audit trails
• Date-based filtering and reporting
• Category-based transaction organization

​

Authentication & Security

• JWT-based authentication
• Password hashing with bcrypt
• Protected routes with guards
• User-specific data isolation
• Input validation with DTOs

​

Developer Experience

• Type-safe database queries with Prisma
• Automatic API documentation with Swagger
• Hot reload in development mode
• ESLint and Prettier for code quality
• Modular architecture for scalability

​

Technology Stack

​

Backend Framework

• NestJS - Progressive Node.js framework with TypeScript
• TypeScript - Type safety throughout the application
• Node.js - JavaScript runtime (v18+)

​

Database & ORM

• PostgreSQL - Robust relational database
• Prisma - Modern ORM with excellent TypeScript support
• Supabase - Hosted PostgreSQL with free tier

​

Authentication

• Passport JWT - JWT authentication strategy
• bcrypt - Password hashing
• class-validator - DTO validation

​

Development Tools

• pnpm - Fast, disk space efficient package manager
• ESLint - Code linting
• Prettier - Code formatting

​

What You’ll Learn

​

Project Structure

your-finance-app/
├── apps/
│   └── backend/              # NestJS application
│       ├── prisma/           # Database schema and migrations
│       ├── src/
│       │   ├── auth/         # Authentication module
│       │   ├── transactions/ # Transactions module
│       │   └── prisma/       # Prisma service module
│       └── test/             # Test files
├── docs/                     # Complete documentation
├── pnpm-workspace.yaml       # Monorepo configuration
└── package.json              # Root scripts

​

API Capabilities

​

Authentication Endpoints

POST   /auth/register      # Create new user account
POST   /auth/login         # Authenticate and get JWT token
GET    /auth/profile       # Get current user profile (protected)

​

Transaction Endpoints

POST   /transactions           # Create new transaction
GET    /transactions           # List transactions with filters
GET    /transactions/balance   # Get current balance
GET    /transactions/:id       # Get transaction details
PATCH  /transactions/:id       # Update transaction
DELETE /transactions/:id       # Soft delete transaction

​

Educational Goals

​

Next Steps

​

Getting Help

• Check the detailed documentation in the /docs folder
• Review the source code comments and examples
• Open an issue on GitHub
• Experiment with the code - that’s the best way to learn!