Skip to content
1-4m-5p33dPublic

About

FINOVA Software Development Committee Recruitment Task

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

15 Commits

Folders and files

Repository files navigation

FlowCap - Track your expenses

FlowCap is my first full-stack development project, built for the Finova recruitment challenge. It is a personal-finance app for students and young professionals who want a clearer answer than “how much money is left this month?”

Instead, FlowCap calculates a Safe Daily Allowance (SDA): the amount that is safe to spend today while staying on track for the rest of the budget cycle.

Features

  • Dynamic Safe Daily Allowance that updates after every transaction
  • Budget onboarding for income, fixed expenses, savings target, emergency buffer, and cycle start date
  • Manual transaction creation, editing, deletion, search, and filters
  • BHIM UPI transaction-statement PDF import with an editable preview
  • Automatic debit/credit detection, categorisation, and duplicate detection for imported UPI transactions
  • Upcoming-expense reservations so planned bills reduce available spending
  • Category spending caps with progress indicators
  • Dashboard metrics, spending charts, budget health, and rule-based insights
  • Under-budget streak calendar
  • What-if purchase simulator and end-of-cycle forecast
  • JWT-based authentication and per-user data

Tech stack

Layer Technology
Frontend React 19, Vite, Tailwind CSS
Visuals Recharts, Lucide React
Backend Python, FastAPI, Uvicorn
Database SQLite
Authentication JSON Web Tokens (PyJWT)
PDF parsing pypdf, with a pdftotext fallback
Deployment Docker and Docker Compose

Run with Docker

Prerequisites

Start the application

From the repository root, build the images and start both services:

docker compose up --build -d

Open the app at http://localhost:5173. The FastAPI API is available at http://localhost:8000, with interactive API documentation at http://localhost:8000/docs.

Useful commands

# Follow logs from both services
docker compose logs -f

# Stop the services without removing containers
docker compose stop

# Start stopped services again
docker compose start

# Stop and remove the containers
docker compose down

FlowCap uses SQLite. The current Docker setup keeps the database inside the backend container, so avoid docker compose down if you need to retain local data. For a production deployment, mount the SQLite database on persistent storage or move to a managed database.

Project structure

FlowCap/
├── frontend/          # React/Vite client served by Nginx in Docker
├── backend/           # FastAPI API and SQLite database logic
├── docker-compose.yml # Starts the frontend and backend together
└── features.md        # Product requirements and feature notes

Safe Daily Allowance

SDA = (disposable funds − fixed expenses − total spent
       − reserved upcoming expenses − emergency buffer) / days remaining

This makes the budget adapt as spending changes, so overspending today is reflected in the amount available for the remaining days.

image

About

FINOVA Software Development Committee Recruitment Task

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages