Starry-You System Requirements Document

1. Introduction

The "Starry-You" project aims to develop a production-ready Micro SaaS platform designed to streamline the process of checking eligibility for government tenders. This platform targets MSMEs, contractors, and consultants, providing AI-driven features to save time and prevent missed opportunities.

2. System Overview

Starry-You will offer a comprehensive solution for businesses to efficiently determine their eligibility for government tenders. The platform will leverage AI technologies to provide tender summarization, eligibility scoring, and compliance checklists. The system will be designed with a modern aesthetic similar to Linear, Notion, or Vercel, ensuring a seamless user experience across devices.

3. Functional Requirements as Story Points

• As a User, I should be able to upload tender documents for analysis.
• As a User, I should receive an AI-generated summary of the tender.
• As a User, I should receive a qualification score indicating my eligibility.
• As a User, I should receive compliance checklists for tenders.
• As a User, I should receive deadline reminders for tenders.
• As a User, I should be able to authenticate using Google or Email.
• As a User, I should be able to manage my subscription through Stripe.
• As a User, I should be able to view and update my user settings.
• As an Admin, I should be able to access an admin dashboard for managing users and tenders.
• As a User, I should be able to view a pricing page with subscription options.
• As a User, I should be able to access a responsive design that supports dark mode.
• As a User, I should be able to view analytics related to my tender activities.
• As a User, I should experience error handling and loading states for a smooth experience.

4. User Personas

• MSME Owner: Needs to quickly determine eligibility for tenders to save time and resources.
• Contractor: Requires detailed compliance checklists to ensure tender requirements are met.
• Consultant: Seeks to provide clients with accurate tender eligibility assessments.
• Admin: Manages platform users and oversees tender processing.

5. Core User Flows

• MSME Owner uploads tender -> AI generates summary -> Receives qualification score -> Views compliance checklist -> Sets deadline reminders.
• Contractor accesses dashboard -> Uploads tender -> Receives compliance checklist -> Updates user settings.
• Consultant logs in via Google -> Uploads tender -> Receives AI summary and qualification score -> Manages subscriptions.
• Admin logs into admin dashboard -> Manages users -> Reviews tender processing.

6. Visuals Colors and Theme

• primary: #1F2937 (Dark Blue)
• primary_light: #3B4A6B (Light Blue)
• secondary: #F3F4F6 (Light Gray)
• accent: #10B981 (Green)
• highlight: #F59E0B (Amber)
• bg: #FFFFFF (White)
• surface: #F9FAFB (Off White)
• text: #111827 (Dark Gray)
• text_muted: #6B7280 (Muted Gray)
• border: #D1D5DB (Light Gray)

7. Signature Design Concept

Interactive Galaxy Map

The landing page will feature an interactive galaxy map where each star represents a feature or section of the platform. Users can click on stars to explore different functionalities such as tender uploads, AI summaries, and compliance checklists. The map will rotate and zoom as users interact, providing a dynamic and engaging experience. This concept will be implemented using @react-three/fiber and @react-three/drei for 3D interactions.

LANDING HERO MOTION BRIEF

The hero section will feature a continuously moving 2D composition built with motion/react. The animation will depict a tender document transforming into a digital summary, highlighting the platform's AI capabilities. Layers will include a document, digital transformation effects, and a final summary display. The loop will last 10 seconds, with interactive elements allowing users to pause and explore details.

8. Interaction Model & Motion Direction

• Interaction Model: Parallax
• Description: The landing page will utilize a parallax effect to create depth, with layered backgrounds moving at different speeds. This will enhance the storytelling aspect of the platform, making it visually appealing and engaging.

9. Non-Functional Requirements

• The system must be highly available and scalable to handle thousands of tenders daily.
• The platform must ensure data security and privacy, adhering to relevant regulations.
• The application should be optimized for SEO to improve visibility and reach.

10. Tech Stack

• Frontend: React for Web
• Backend: FastAPI
• Database: MySQL or MariaDB, with alembic for migrations
• AI Models: GPT 5.4 for user-friendly responses, Google Nano banana for image generation
• AI Tools: Litellm for LLM Routing, Langchain
• Local Orchestration: Docker, docker-compose
• Server-side Orchestration: Kubernetes

11. Assumptions and Constraints

• The platform will primarily target the Indian market, considering local regulations and business practices.
• Pricing will be set in USD, with plans ranging from $29 to $99 per month.
• The system should support both desktop and mobile devices with a responsive design.

12. Glossary

• MSME: Micro, Small, and Medium Enterprises
• AI: Artificial Intelligence
• SEO: Search Engine Optimization
• REST API: Representational State Transfer Application Programming Interface
• MVP: Minimum Viable Product