Winter-Business System Requirements Document

Introduction

The "Winter-Business" project aims to develop a comprehensive mobile application called Udyam AI. This app serves as an AI-powered business companion tailored for Indian small business owners, including electricians, carpenters, plumbers, mechanics, tailors, kirana store owners, and other skilled professionals. The primary mission of Udyam AI is to help users increase their earnings, find customers, manage finances, discover government schemes, connect with suppliers, learn new skills, and grow their businesses.

System Overview

Udyam AI is designed to provide a modern, premium mobile experience with an Android-first approach. It supports multiple languages and offers a voice-first experience, integrating an AI chat assistant on every screen. The app's architecture is production-ready, featuring Firebase Authentication and Firestore as the database. It includes functionalities such as user onboarding, a dashboard, a supplier marketplace, a government schemes matching engine, a community discussion platform, a learning academy, a digital ledger, and payment tracking. The app is designed to be responsive, with both dark and light themes available.

Functional Requirements

• As a Business Owner, I should be able to manage customers, jobs, ledger, suppliers, AI assistant, learning, and schemes.
• As an Admin, I should be able to manage users, suppliers, reported content, government schemes, learning content, categories, and platform analytics.
• As a Supplier, I should be able to create a profile, list products/services, update prices, receive inquiries, and respond to business owners.
• As an Expert/Mentor, I should be able to answer community questions, publish tips, and offer guidance.
• As a User, I should be able to select my profession during onboarding.
• As a User, I should be able to view a dashboard showing revenue, opportunities, pending work, and recommendations.
• As a User, I should be able to access a supplier marketplace.
• As a User, I should be able to use a government schemes matching engine.
• As a User, I should be able to participate in a community discussion platform.
• As a User, I should be able to access a learning academy.
• As a User, I should be able to track payments and manage a digital ledger.
• As a User, I should be able to receive push notifications.
• As a User, I should be able to switch between dark and light themes.
• As a User, I should be able to interact with a context-aware floating AI chat assistant on every screen.

User Personas

1. Business Owner: The primary user of the app, such as electricians, carpenters, plumbers, tailors, mechanics, and kirana store owners. They manage customers, jobs, ledger, suppliers, AI assistant, learning, and schemes.

2. Supplier: Users who create profiles, list products/services, update prices, receive inquiries, and respond to business owners.

3. Admin: Users who manage other users, suppliers, reported content, government schemes, learning content, categories, and platform analytics.

4. Expert/Mentor: Verified professionals who can answer community questions, publish tips, and offer guidance.

Core User Flows

• Business Owner logs in -> selects profession -> views dashboard -> manages customers/jobs/ledger -> interacts with AI assistant.
• Admin logs in -> manages users/suppliers/content -> reviews platform analytics.
• Supplier logs in -> creates profile -> lists products/services -> updates prices -> responds to inquiries.
• Expert/Mentor logs in -> answers community questions -> publishes tips -> offers guidance.

Visuals Colors and Theme

• primary: #1A73E8 (deep blue)
• primary_light: #E8F0FE (light blue)
• secondary: #FF6F61 (coral)
• accent: #FFD700 (gold)
• highlight: #FFA500 (orange)
• bg: #FFFFFF (white)
• surface: rgba(250, 250, 250, 0.8)
• text: #202124 (dark gray)
• text_muted: #5F6368 (light gray)
• border: rgba(218, 220, 224, 0.2)

Signature Design Concept

The homepage of Udyam AI will feature an interactive "Business Growth Journey" map. Users can navigate through a 3D landscape representing different aspects of their business journey, such as customer acquisition, financial management, and skill development. Each section of the map will be a clickable 3D model (e.g., a marketplace, a classroom, a ledger book) that expands into detailed views. The map will be built using @react-three/fiber for 3D rendering and gsap for smooth animations and transitions. Users can click, drag, and hover to explore different areas, with the AI assistant providing contextual advice based on the section being viewed.

Interaction Model & Motion Direction

The landing page will use a "parallax" interaction model, with layered depth via scroll. Decorative layers will translate at different speeds, while real content scrolls naturally. This model will create a visually rich first impression, ideal for storytelling and engaging users. Internal pages will maintain a "static" interaction model for clarity and ease of use.

Non-Functional Requirements

• The app must support Android devices primarily, with a responsive design for various screen sizes.
• It should offer a seamless multi-language experience, supporting English, Hindi, Telugu, Tamil, Kannada, and Marathi.
• The AI assistant must be context-aware and provide practical, money-focused recommendations.
• The system should ensure secure access control and data privacy.

Tech Stack

• Frontend: React Native for mobile app
• Backend: FastAPI
• Database: Firestore
• Authentication: Firebase Authentication
• AI Models: GPT 5.4 for user-friendly responses
• AI Tools: Litellm for LLM Routing
• Local Orchestration: Docker
• Server-side Orchestration: Kubernetes

Assumptions and Constraints

• The app will initially focus on Android devices, with potential expansion to other platforms.
• The AI assistant will require integration with user data from Firestore to provide context-aware advice.
• The app must comply with data protection regulations applicable in India.

Glossary

• AI Assistant: A virtual assistant integrated into the app to provide business advice.
• Firestore: A NoSQL cloud database used for storing app data.
• Firebase Authentication: A service that provides secure user authentication.
• React Native: A framework for building native mobile apps using React.
• FastAPI: A modern web framework for building APIs with Python.