EmmanuelAgbanyo/AES-JAC

The Just-A-Call Initiative Empowering MSMEs in Ghana and across Africa to master their financial records. We provide the tools to simplify bookkeeping, gain actionable insights, and drive sustainable growth. # AES-JAC Admin Portal Welcome to the **AES-JAC Admin Portal** repository. This is a comprehensive, full-stack management and reporting dashboard designed to track, support, and analyze entrepreneur growth, financial transactions, and client engagements. Built with modern web technologies, it features role-based access control, AI-powered insights, and a seamless user experience. ## 🌟 Key Features - **Role-Based Access Control (RBAC):** Distinct dashboards for Super Admins, Admins, Staff, and Entrepreneurs. - **Entrepreneur Management:** Track entrepreneur details, business metrics, and goals. - **Transaction & Expense Tracking:** Log and monitor income, expenses, and invoices. - **AI-Powered Insights (Gemini):** Upload transaction receipts (PDFs) to automatically parse expenses using Google Gemini API. Chat widget for querying financial data. - **Automated Reporting & Export:** Generate professional HTML/PDF financial reports, and export all data seamlessly to Excel (XLSX). - **Client & Goal Management:** Track clients for each business and set/monitor business growth goals. - **Growth Hub:** Analytics and resource library specifically tailored for business growth. - **Beautiful & Responsive UI:** Fully responsive design with Dark Mode support, Framer Motion animations, and Recharts charts. ## 🛠️ Technology Stack - **Frontend:** React 19, TypeScript, Vite - **Styling:** Tailwind CSS, Framer Motion (Animations), Lucide React (Icons) - **Backend & Database:** Firebase (Authentication, Firestore Database, Storage) - **AI Integration:** Google Gemini API (`@google/genai`) - **Data Processing & Export:** `xlsx`, `docx`, `file-saver` - **Charting:** Recharts ## 🚀 Getting Started Follow these steps to run the application locally. ### Prerequisites - Node.js (v16+ recommended) - A Firebase project setup with Firestore and Authentication enabled. - Google Gemini API Key. ### Installation 1. **Clone the repository:** ```bash git clone github.com …