{"id":19846005,"url":"https://github.com/ibra-kdbra/finance-dashboard","last_synced_at":"2026-04-29T22:42:08.514Z","repository":{"id":172709732,"uuid":"649679634","full_name":"ibra-kdbra/Finance-DashBoard","owner":"ibra-kdbra","description":"Dashboard MERN Stack","archived":false,"fork":false,"pushed_at":"2023-06-10T09:27:03.000Z","size":227,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-11T12:35:29.250Z","etag":null,"topics":["chartjs","dashboard","flexbox-css","flexbox-grid","mern-stack","mongodb","mongoose","react","regressionjs","schema"],"latest_commit_sha":null,"homepage":"https://finance-mongo.netlify.app","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/ibra-kdbra.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}},"created_at":"2023-06-05T12:01:55.000Z","updated_at":"2023-06-09T22:00:48.000Z","dependencies_parsed_at":null,"dependency_job_id":"ec9dcbf4-8b7d-47f0-a693-2f3c0e44a821","html_url":"https://github.com/ibra-kdbra/Finance-DashBoard","commit_stats":null,"previous_names":["ibra-kdbra/finance-dashboard"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ibra-kdbra%2FFinance-DashBoard","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ibra-kdbra%2FFinance-DashBoard/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ibra-kdbra%2FFinance-DashBoard/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ibra-kdbra%2FFinance-DashBoard/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ibra-kdbra","download_url":"https://codeload.github.com/ibra-kdbra/Finance-DashBoard/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241224964,"owners_count":19930060,"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":["chartjs","dashboard","flexbox-css","flexbox-grid","mern-stack","mongodb","mongoose","react","regressionjs","schema"],"created_at":"2024-11-12T13:10:02.873Z","updated_at":"2026-04-29T22:42:08.507Z","avatar_url":"https://github.com/ibra-kdbra.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Enterprise Finance Performance \u0026 Projection Dashboard\n\nA professional-grade financial analytics platform utilizing a decoupled architecture to provide real-time KPI tracking and deep-learning-based revenue forecasting.\n\n## Architecture Overview\n\nThe system is composed of two primary services:\n\n1. **Frontend (Client)**: A high-performance React application built with TypeScript and Vite. It utilizes Redux Toolkit (RTK Query) for state management and Nivo for advanced data visualization.\n2. **Primary Backend (API)**: A Node.js and Express.js server managing authentication, the data persistence layer via Prisma ORM, and integration with the Hugging Face Inference API for strategic AI forecasting (Llama-3).\n\n## Technology Stack\n\n### Frontend\n\n- **Framework**: React 19, TypeScript, Vite\n- **Styling**: Material UI (MUI 5), Framer Motion (Animations)\n- **State/API**: Redux Toolkit, RTK Query\n- **Charts**: Nivo, D3-based visualizations\n\n### Backend (Node.js)\n\n- **Runtime**: Node.js v19+\n- **Framework**: Express.js\n- **ORM**: Prisma\n- **Database**: PostgreSQL (Neon.tech)\n- **Security**: JWT Authentication, Helmet, CORS\n- **AI Engine**: Hugging Face (Llama-3.3-70B for both numerical forecasting and strategic analysis)\n\n## Database Schema (ERD)\n\nThe following diagram illustrates the PostgreSQL relational structure managed by Prisma:\n\n![Database ERD](server/ERD/ERD_Tables.png)\n\n## Getting Started\n\n### 1. Repository Setup\n\n```bash\ngit clone \u003crepository-url\u003e\ncd Finance-DashBoard\n```\n\n### 2. Node.js API Setup\n\n```bash\ncd server\nnpm install\n```\n\nConfigure `.env` with the following variables:\n\n- `DATABASE_URL`: PostgreSQL connection string\n- `JWT_SECRET`: Secure signing key\n- `HF_API_KEY`: Hugging Face API token\n\nStart the server:\n\n```bash\nnpm run dev\n```\n\n### 4. Frontend Client Setup\n\n```bash\ncd ../client\nnpm install\n```\n\nConfigure `.env` with:\n\n- `VITE_BASE_URL`: URL of the Node.js API\n\nStart the development server:\n\n```bash\nnpm run dev\n```\n\n## Deployment\n\n### Render Configuration\n\n- **Node.js API**: Deploy `server` folder as a Web Service.\n- **Frontend**: Deploy `client` folder to Netlify or Render Static Site.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fibra-kdbra%2Ffinance-dashboard","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fibra-kdbra%2Ffinance-dashboard","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fibra-kdbra%2Ffinance-dashboard/lists"}