{"id":27946017,"url":"https://github.com/freya135/personal-finance-manager","last_synced_at":"2026-04-13T22:31:22.663Z","repository":{"id":291620759,"uuid":"978218583","full_name":"Freya135/Personal-Finance-Manager","owner":"Freya135","description":"This project is a web-based personal finance manager dashboard built using Next.js and Vercel PostgreSQL. The dashboard aggregates essential financial data to help users track metrics like profits, sales, and customer activity, and it provides easy-to-read visualizations to support data-driven decision-making.","archived":false,"fork":false,"pushed_at":"2025-05-05T16:46:43.000Z","size":351,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-05T17:59:08.553Z","etag":null,"topics":["data-visualization","nextjs","personal-finance-manager","postgresql","vercel","webdashboard"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Freya135.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-05T16:44:35.000Z","updated_at":"2025-05-05T16:48:00.000Z","dependencies_parsed_at":"2025-05-05T18:10:36.680Z","dependency_job_id":null,"html_url":"https://github.com/Freya135/Personal-Finance-Manager","commit_stats":null,"previous_names":["freya135/personal-finance-manager"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Freya135%2FPersonal-Finance-Manager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Freya135%2FPersonal-Finance-Manager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Freya135%2FPersonal-Finance-Manager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Freya135%2FPersonal-Finance-Manager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Freya135","download_url":"https://codeload.github.com/Freya135/Personal-Finance-Manager/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252890235,"owners_count":21820346,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["data-visualization","nextjs","personal-finance-manager","postgresql","vercel","webdashboard"],"created_at":"2025-05-07T13:47:35.036Z","updated_at":"2026-04-13T22:31:22.628Z","avatar_url":"https://github.com/Freya135.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Personal Finance Manager Dashboard\n\nThis project is a web-based personal finance manager dashboard built using Next.js and Vercel PostgreSQL. The dashboard aggregates essential financial data to help users track metrics like profits, sales, and customer activity, and it provides easy-to-read visualizations to support data-driven decision-making.\n\n## Table of Contents\n\n- [Features](#features)\n- [Database Schema](#database-schema)\n- [Getting Started](#getting-started)\n- [Installation](#installation)\n- [Usage](#usage)\n- [Technologies Used](#technologies-used)\n- [Contributing](#contributing)\n\n## Features\n\n**Total Profit \u0026 Sales:** View cumulative financial data, including total profits and sales.\n**Monthly Sales Breakdown:** See month-wise sales trends in a bar graph.\n**Customer Insights:** Track total customer count and view recent customer transactions.\n**Recent Sales:** A list of the latest transactions for quick reference.\n\n## Database Schema\n\nThe project uses four main tables in the Vercel PostgreSQL database:\n\n    Customers\n        CustomerID (Primary Key): Unique identifier for each customer.\n        CustomerName, Segment, Country, City, State, PostalCode.\n\n    Orders\n        Order_ID (Primary Key): Unique identifier for each order.\n        Order_Date, Ship_Date, Ship_Mode, Customer_ID (Foreign Key referencing Customers).\n\n    Products\n        Product_ID (Primary Key): Unique identifier for each product.\n        Category, Sub_Category, Product_Name.\n\n    Sales\n        Composite primary key: Order_ID, Product_ID.\n        Sales, Quantity, Discount, Profit.\n        Foreign keys: Order_ID (references Orders), Product_ID (references Products).\n\n## Getting Started\n\nThese instructions will help you set up and run the project locally.\n### Prerequisites\n\nNode.js: Version 14 or higher\nPostgreSQL: Version compatible with Vercel PostgreSQL\n\n### Installation\n\nClone the Repository\n\n```bash\ngit clone https://github.com/Freya135/Personal-Finance-Manager.git\ncd finance-manager-dashboard\n```\n\n### Install Dependencies\n```bash\nnpm install\n```\n\n### Set Up the Database\n\nCreate a PostgreSQL database and add the four tables using the provided schema.\nUpdate the database connection information in your environment file .env.local.\n\n### Run the Development Server\n```bash\n    npm run dev\n```\nOpen http://localhost:3000 to view the dashboard in your browser.\n\n## Usage\n\n**Dashboard Overview:** The main dashboard displays total profits, sales, and customers.\n**Visualizations:** Monthly sales are shown in a bar graph for easy trend analysis.\n**Recent Sales:** Access a list of recent transactions, providing quick insights into recent customer activity.\n\n## Technologies Used\n\nFrontend: Next.js, React, Tailwind CSS\nBackend: Vercel PostgreSQL\nDatabase: PostgreSQL\n\n## Contributing\n\nContributions are welcome! Please open an issue or submit a pull request.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffreya135%2Fpersonal-finance-manager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffreya135%2Fpersonal-finance-manager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffreya135%2Fpersonal-finance-manager/lists"}