Kirna Store System Requirements Document

Introduction

The Kirna Store project aims to develop a comprehensive SaaS platform called SMART KIRANA ERP. This cloud-based, multi-tenant ERP platform is designed specifically for Kirana stores, providing them with the tools needed to efficiently manage various aspects of their business operations. The platform will compete with existing solutions such as Vyapar, Marg ERP, Zoho Inventory, Shopify POS, GoFrugal, and RetailGraph.

System Overview

SMART KIRANA ERP will be a robust, enterprise-grade platform that supports Kirana stores in managing inventory, billing, POS, customer relationships, supplier interactions, GST compliance, purchases, sales, reporting, employee management, and more. The platform will include advanced AI features for demand forecasting, inventory prediction, and product recommendations, among others.

Source Content Inventory

• Vyapar: Competing ERP solution for small businesses.
• Marg ERP: Comprehensive ERP software for various business needs.
• Zoho Inventory: Inventory management software.
• Shopify POS: Point of Sale system for retail.
• GoFrugal: Retail, restaurant, and distribution software.
• RetailGraph: Retail management software.

Functional Requirements as Story Points

• As a Super Admin, I should be able to manage all aspects of the platform, including user roles and permissions.
• As a Company Admin, I should be able to configure company-specific settings and manage store branches.
• As a Store Owner, I should be able to oversee store operations and access detailed reports.
• As a Store Manager, I should be able to manage inventory, sales, and staff.
• As a Cashier, I should be able to process sales transactions efficiently.
• As an Accountant, I should be able to manage financial records and generate GST reports.
• As a Purchase Manager, I should be able to manage supplier relationships and purchase orders.
• As an Inventory Manager, I should be able to track stock levels and receive low-stock alerts.
• As Delivery Staff, I should be able to manage delivery schedules and track orders.
• As a Customer, I should be able to view products, make purchases, and track orders.

User Personas

• Super Admin: Oversees the entire platform, manages user roles and permissions.
• Company Admin: Configures company settings and manages multiple store branches.
• Store Owner: Manages store operations and accesses reports.
• Store Manager: Handles inventory, sales, and staff management.
• Cashier: Processes sales transactions.
• Accountant: Manages financial records and GST reporting.
• Purchase Manager: Manages suppliers and purchase orders.
• Inventory Manager: Tracks stock levels and manages inventory.
• Delivery Staff: Manages delivery schedules and order tracking.
• Customer: Interacts with the store for purchases and order tracking.

Core User Flows

• Super Admin configures platform settings -> assigns roles -> monitors platform usage.
• Company Admin sets up company details -> manages branches -> configures store settings.
• Store Owner reviews sales and inventory reports -> makes strategic decisions.
• Store Manager updates inventory -> processes sales -> manages staff schedules.
• Cashier processes customer transactions -> issues receipts.
• Accountant generates financial reports -> files GST returns.
• Purchase Manager creates purchase orders -> manages supplier relationships.
• Inventory Manager checks stock levels -> receives low-stock alerts -> orders new stock.
• Delivery Staff schedules deliveries -> updates order status.
• Customer browses products -> makes a purchase -> tracks order delivery.

Visuals Colors and Theme

• primary: #1E3A8A (Deep Blue)
• primary_light: #3B82F6 (Light Blue)
• secondary: #F59E0B (Amber)
• accent: #EF4444 (Red)
• highlight: #FBBF24 (Gold)
• bg: #F3F4F6 (Light Gray)
• surface: rgba(255, 255, 255, 0.8)
• text: #111827 (Dark Gray)
• text_muted: #6B7280 (Muted Gray)
• border: rgba(209, 213, 219, 0.2)

Signature Design Concept

Interactive Product Showcase

The homepage will feature an interactive product showcase where users can explore different modules of the ERP system. Each module will be represented as a card that flips and expands to reveal detailed information when hovered over. The cards will be arranged in a dynamic grid that responds to user interactions, creating an engaging and informative experience.

Landing Hero Motion Brief

The landing hero will feature a continuous animation loop where various inputs (e.g., inventory data, sales figures) gather around a central dashboard. The dashboard will transform these inputs into visual analytics, showcasing the platform's ability to provide actionable insights. This animation will be created using motion/react for smooth transitions and interactions.

Interaction Model & Motion Direction

• Intended Interaction Model: Animated
• Description: The landing page will feature moderate scroll-triggered reveals, hover transitions, and spring physics on interactive elements. This approach will provide a polished and engaging experience for users exploring the platform's features.

Non-Functional Requirements

• Scalability: The platform must support a growing number of users and transactions without performance degradation.
• Security: Implement OWASP Top 10 security practices, including input validation, SQL injection prevention, and encryption.
• Performance: The platform should load quickly and handle high volumes of data efficiently.
• Usability: The UI must be intuitive, responsive, and accessible, supporting both dark and light modes.
• Reliability: Ensure high availability and disaster recovery capabilities.

Tech Stack

• Frontend: React for Web
• Backend: Python, FastAPI
• Database RDBMS: PostgreSQL
• AI Models: GPT 5.4, Claude Sonnet 5, Gemini 3.1 pro
• AI Tools: Litellm, Langchain
• Local Orchestration: Docker, docker-compose
• Server-side Orchestration: Kubernetes

Assumptions and Constraints

• The platform will primarily serve Kirana stores in India, considering local business practices and regulations.
• The system must integrate with existing accounting and inventory systems used by Kirana stores.
• The platform should support multiple languages to cater to a diverse user base.

Glossary

• ERP: Enterprise Resource Planning
• POS: Point of Sale
• GST: Goods and Services Tax
• AI: Artificial Intelligence
• JWT: JSON Web Token
• OWASP: Open Web Application Security Project

This document outlines the comprehensive requirements for the Kirna Store project, ensuring a robust and scalable ERP solution for Kirana stores.