{"id":50577363,"url":"https://github.com/muuhesham/finance-tracker","last_synced_at":"2026-06-04T23:02:35.226Z","repository":{"id":356257917,"uuid":"1231714226","full_name":"muuhesham/finance-tracker","owner":"muuhesham","description":"Finance Tracker Web Application with MERN Stack","archived":false,"fork":false,"pushed_at":"2026-05-07T08:22:08.000Z","size":73,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-07T10:28:36.375Z","etag":null,"topics":["expressjs","mongodb","nodejs","react","vibe-coding"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/muuhesham.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-07T08:06:28.000Z","updated_at":"2026-05-07T08:30:31.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/muuhesham/finance-tracker","commit_stats":null,"previous_names":["muuhesham/finance-tracker"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/muuhesham/finance-tracker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muuhesham%2Ffinance-tracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muuhesham%2Ffinance-tracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muuhesham%2Ffinance-tracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muuhesham%2Ffinance-tracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/muuhesham","download_url":"https://codeload.github.com/muuhesham/finance-tracker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muuhesham%2Ffinance-tracker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33923190,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-04T02:00:06.755Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["expressjs","mongodb","nodejs","react","vibe-coding"],"created_at":"2026-06-04T23:02:34.801Z","updated_at":"2026-06-04T23:02:35.219Z","avatar_url":"https://github.com/muuhesham.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# FinanceFlow Personal Finance Management System\n\nFinanceFlow is a production-ready personal finance management system built with `Node.js + Express.js`, `React`, and `MongoDB`. It helps users track income and expenses, monitor monthly behavior through charts, and receive automated end-of-month financial tips generated by a rule-based insights engine.\n\n## Highlights\n\n- JWT-based registration and login\n- Expense and income CRUD with categories, notes, and timestamps\n- Dashboard with monthly summary, category chart, trend chart, and recent transactions\n- Rule-based monthly insights powered by Strategy Pattern\n- Clean architecture with Repository, Strategy, and Factory patterns\n- Unit-tested backend services\n- Full documentation set including SRS, UML, architecture notes, Agile sprint simulation, API guide, and implementation explanation\n\n## Stack\n\n- Backend: `Node.js`, `Express.js`, `Mongoose`\n- Frontend: `React`, `Vite`, `Recharts`, `Framer Motion`\n- Database: `MongoDB`\n- Testing: `Vitest`\n\n# Project Setup \u0026 Running Instructions\n\n## Table of Contents\n1. [Prerequisites](#prerequisites)\n2. [Project Structure](#project-structure)\n3. [Backend Setup](#backend-setup)\n4. [Frontend Setup](#frontend-setup)\n5. [Running the Application](#running-the-application)\n6. [Testing](#testing)\n7. [Building for Production](#building-for-production)\n8. [Troubleshooting](#troubleshooting)\n\n---\n\n## Prerequisites\n\nBefore starting, ensure you have the following installed on your system:\n\n### Required Software\n- **Node.js** (v16 or higher) - [Download](https://nodejs.org/)\n- **npm** (comes with Node.js)\n- **MongoDB** (running locally) - [Download](https://www.mongodb.com/try/download/community)\n- **MongoDB Compass** (optional, for database GUI) - [Download](https://www.mongodb.com/products/compass)\n- **Git** - [Download](https://git-scm.com/)\n\n### Verify Installation\n```powershell\nnode --version\nnpm --version\nmongod --version\n\n## Project Structure\n\n```text\nfinance-flow-system/\n├─ backend/      # Express API, controllers, routes, services, models, validators\n├─ frontend/     # React dashboard and auth UI\n├─ docs/         # SRS, UML, architecture, Agile, API, tests, explanation\n├─ package.json\n```\n\n## Prerequisites\n\n- MongoDB running locally and accessible from MongoDB Compass on `mongodb://127.0.0.1:27017`\n- MongoDB Compass installed for local database inspection and connection testing\n- Node.js and npm installed\n\n## Environment Setup\n\n### API\n\nCopy `backend/.env.example` to `backend/.env` and set:\n\n```env\nPORT=8000\nMONGODB_URI=mongodb://127.0.0.1:27017/finance-flow\nJWT_SECRET=hsgA+uKMxv6T1EhbJAjSwDX+mzTap63gGqVwaiFbayg=\nCLIENT_URL=http://localhost:5173\n```\n\n### Web\n\nCopy `frontend/.env.example` to `frontend/.env`:\n\n```env\nVITE_API_URL=http://localhost:8000/api\n```\n\n## Install\n\nFrom the repository root, install dependencies for the backend and frontend apps:\n\n```powershell\ncd backend \u0026\u0026 npm install\ncd ..\\frontend \u0026\u0026 npm install\n```\n\n## MongoDB Compass Setup\n\n1. Start your local MongoDB server.\n2. Open MongoDB Compass.\n3. Connect using `mongodb://127.0.0.1:27017`.\n4. Create or use the `finance-flow` database.\n5. Keep the API env value aligned with that connection:\n\n```env\nMONGODB_URI=mongodb://127.0.0.1:27017/finance-flow\n```\n\n## Run the Backend\n\nFrom the project root, start the API:\n\n```powershell\nnpm run dev:api\n```\n\nThe backend will run at [http://localhost:8000](http://localhost:8000).\n\n## Run the Frontend\n\nIn a second terminal from the project root:\n\n```powershell\nnpm run dev:web\n```\n\nThe frontend will run at [http://localhost:5173](http://localhost:5173).\n\n## Run Both Together\n\nIf you want to run both apps manually, start each in a separate terminal:\n\n```powershell\nnpm run dev:api\nnpm run dev:web\n```\n\n## Test and Build\n\n```powershell\nnpm run test:api\nnpm run build:web\n```\n\n## Documentation Index\n\n- SRS: [docs/SRS.md](docs/SRS.md)\n- Architecture: [docs/architecture.md](docs/architecture.md)\n- API reference: [docs/api.md](docs/api.md)\n- Test cases: [docs/test-cases.md](docs/test-cases.md)\n- Git workflow: [docs/version-control.md](docs/version-control.md)\n- Agile simulation: [docs/agile/scrum-plan.md](docs/agile/scrum-plan.md)\n- Detailed implementation explanation: [docs/explanation.md](docs/explanation.md)\n- UML diagrams:\n  - [docs/uml/use-case.md](docs/uml/use-case.md)\n  - [docs/uml/class-diagram.md](docs/uml/class-diagram.md)\n  - [docs/uml/sequence-diagram.md](docs/uml/sequence-diagram.md)\n  - [docs/uml/activity-diagram.md](docs/uml/activity-diagram.md)\n\n## Delivered Features\n\n- Authentication with secure password hashing and JWT sessions\n- Transaction management with add, edit, and delete\n- Monthly dashboard with category and trend visualization\n- End-of-month smart tips generated from spending rules\n- Responsive desktop-first interface with subtle motion and clean visual hierarchy\n\n## Notes\n\n- Insights are cached per user and month after generation.\n- MongoDB is used through a local connection that you can verify in MongoDB Compass.\n- The project uses npm for package management and local app startup.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmuuhesham%2Ffinance-tracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmuuhesham%2Ffinance-tracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmuuhesham%2Ffinance-tracker/lists"}