indigo-gst System Requirements Document

1. Introduction

The "indigo-gst" project aims to develop a GST reconciliation tool specifically tailored for niche industries such as textiles, construction materials, pharma distributors, or auto-parts wholesalers. The tool is designed to assist CA firms managing 50–500 clients by providing efficient GST reconciliation services.

2. System Overview

The indigo-gst tool will focus on automating the GST reconciliation process by matching purchase invoices with GSTR-2B, detecting missing or duplicate invoices, mapping HSN codes and tax rates, and exporting exception reports. Additionally, it will facilitate communication with suppliers through WhatsApp for follow-up messages.

3. Functional Requirements as Story Points

• As a CA firm user, I should be able to match purchase invoices with GSTR-2B to ensure accurate reconciliation.
• As a CA firm user, I should be able to detect missing invoices to prevent discrepancies in GST filings.
• As a CA firm user, I should be able to detect duplicate invoices to avoid redundancy and errors.
• As a CA firm user, I should be able to map HSN codes and tax rates to ensure compliance with GST regulations.
• As a CA firm user, I should be able to export exception reports for further analysis and reporting to clients.
• As a CA firm user, I should be able to send supplier follow-up messages through WhatsApp to streamline communication.

4. User Personas

• CA Firm User: A chartered accountant or accounting professional managing GST reconciliation for 50–500 clients in niche industries.

5. Core User Flows

1. Invoice Matching Flow:

   • User uploads purchase invoices.
   • System matches invoices with GSTR-2B.
   • User reviews matched results and identifies discrepancies.

2. Exception Reporting Flow:

   • System detects missing or duplicate invoices.
   • User generates and exports exception reports.
   • User reviews reports and takes corrective actions.

3. Supplier Communication Flow:

   • User selects suppliers with discrepancies.
   • System sends follow-up messages via WhatsApp.
   • User monitors responses and updates records accordingly.

6. Visuals Colors and Theme

• primary: #0047AB (Indigo Blue)
• primary_light: #5A8DEE (Light Indigo)
• secondary: #F5A623 (Orange)
• accent: #FF4081 (Pink)
• highlight: #FFC107 (Amber)
• bg: #FFFFFF (White)
• surface: #F4F6F8 (Light Grey)
• text: #212121 (Dark Grey)
• text_muted: #757575 (Muted Grey)
• border: #E0E0E0 (Light Border Grey)

7. Signature Design Concept

The indigo-gst landing page will feature an interactive "Invoice Journey" animation. Users will see invoices traveling through a digital pipeline, transforming as they match with GSTR-2B data, highlighting discrepancies, and finally reaching a resolved state. This animation will be built using motion/react for smooth transitions and interactions. Users can hover over different stages to see detailed information pop-ups, providing an engaging and informative experience.

LANDING HERO MOTION BRIEF

The hero section will depict invoices entering a digital conveyor belt. As they move, they will transform through stages: matching, discrepancy detection, and resolution. The final stage will show a "thumbs-up" icon indicating successful reconciliation. This 10-second loop will use motion/react for animations, ensuring a seamless experience across devices. The animation will pause on hover, allowing users to explore each stage in detail.

8. Interaction Model & Motion Direction

• Intended Interaction Model: Animated
  • The landing page will feature moderate scroll-triggered reveals and hover transitions.
  • Interactive elements will have spring physics for a polished user experience.

9. Non-Functional Requirements

• The system must handle up to 500 clients per CA firm efficiently.
• The tool should ensure data security and compliance with GST regulations.
• The application must be responsive and accessible on various devices.

10. Tech Stack

• Frontend: React for Web
• Backend: Python with FastAPI
• Database: MySQL or MariaDB, using Alembic for migrations
• AI Tools: Not applicable
• Local Orchestration: Docker, docker-compose
• Server-side Orchestration: Kubernetes

11. Assumptions and Constraints

• The tool will not compete with all-in-one accounting products like Tally or Vyapar.
• Pricing will range from ₹1,999 to ₹9,999 per month per CA firm, based on client count.
• The system will focus on one sector initially, with potential expansion to others.

12. Glossary

• GSTR-2B: A static auto-drafted statement for taxpayers, providing details of input tax credit.
• HSN Code: Harmonized System of Nomenclature, used for classifying goods under GST.
• CA Firm: Chartered Accountant firm responsible for managing financial records and compliance for clients.