AmoakoJoseph/Taxflow

A tax filling automation systems for smaill businesses in Ghana # Taxflow Taxflow is a final year project prototype for tax filing automation for small businesses in Ghana. It helps a business owner record income, expenses, and payroll, then estimates VAT/NHIL/GETFund, PAYE, withholding tax, and basic filing reports. The project is intentionally scoped as an academic MVP: it demonstrates the core workflow and tax-rule engine, while documenting the production limitations that would need to be addressed before real commercial use. ## Problem Statement Many small businesses in Ghana keep financial records manually and may miss tax deadlines or misunderstand VAT, PAYE, and withholding tax rules. Taxflow provides a simple mobile-first interface for recording business transactions and generating tax summaries that can assist monthly filing preparation. ## Objectives - Capture business profile information such as business name, TIN, industry, and VAT registration status. - Record income, expense, and payroll transactions. - Automatically estimate VAT, PAYE, and withholding tax from transaction data. - Generate a monthly tax summary and simple reporting view. - Notify users about relevant PAYE/WHT and VAT/NHIL filing timelines. - Demonstrate a clear architecture suitable for further expansion into a production system. ## Features - Business registration and login flow for the prototype. - Mobile-first dashboard for Ghanaian SMEs. - Transaction ledger with income, expense, and payroll categories. - Tax calculators for VAT, PAYE, and withholding tax. - GRA-style summary reports for review and printing. - Notification reminders for filing deadlines. - Offline demo mode when the backend is not running. ## Tech Stack - Frontend: Next.js, React, CSS - Backend: NestJS, TypeScript - Prototype persistence: JSON file storage - Testing: Jest ## Project Structure ```text Taxflow/ backend/ NestJS API, tax engine, reports, prototype JSON database frontend/ Next.js mobile-first user interface docs/ Final year project docum …