System Requirements Document (SRD) for storm-hi

1. Introduction

The storm-hi project is a cutting-edge Android application designed for users in Pakistan and beyond, aiming to simplify and enhance the process of aligning satellite dishes. By leveraging advanced technologies and user-friendly interfaces, storm-hi will empower users to achieve precise satellite alignment with minimal effort. This document outlines the system requirements for the project, ensuring clarity and alignment with the project's goals.

2. System Overview

The storm-hi system is an Android application designed to assist users in aligning satellite dishes accurately. The system will provide real-time feedback, angle guidance, and signal strength measurements, ensuring optimal alignment. It will utilize APIs, advanced algorithms, and intuitive visual overlays to guide users through the alignment process. The system is tailored to the needs of users in Pakistan, considering local satellite configurations, time zones (PKT), and environmental factors.

3. Functional Requirements

The following are the functional requirements for the storm-hi project, expressed as user stories:

• As a User, I should be able to input my location to identify the nearest satellite coordinates.
• As a User, I should be able to view real-time signal strength feedback while adjusting the dish.
• As a User, I should be able to access angle guidance (azimuth, elevation, and skew) for precise alignment.
• As a User, I should be able to use a visual overlay to align the dish with the satellite.
• As a User, I should be able to save and retrieve alignment settings for future use.
• As an Admin, I should be able to update satellite data and configurations via the API supervisor.
• As a Guest, I should be able to explore a demo mode to understand the app's functionality.
• As a User, I should be able to manually trigger selective re-run capability to regenerate specific SRD sections.

4. User Personas

The storm-hi system will cater to the following user personas:

1. User:

   • Primary user of the system.
   • Needs to align satellite dishes accurately and efficiently.
   • May have limited technical expertise.

2. Admin:

   • Responsible for managing satellite data and configurations.
   • Ensures the system remains up-to-date with the latest satellite information.

3. Guest:

   • Potential user exploring the app's features in demo mode.
   • May convert to a registered user after testing the app.

5. Visuals Colors and Theme

The visual identity of storm-hi will reflect precision, technology, and user-friendliness. Below is the unique color palette for the project:

• Background: #0F172A (Midnight Navy)
• Surface: #1E293B (Charcoal Gray)
• Text: #F8FAFC (Soft White)
• Accent: #22D3EE (Bright Cyan)
• Muted: #64748B (Muted Blue Gray)

This palette ensures a professional and modern look while maintaining high readability and usability.

6. Signature Design Concept

The storm-hi homepage for the Android app will feature an immersive augmented reality (AR) alignment assistant. Users will be able to point their phone's camera at the satellite dish, and the app will overlay real-time guidance directly onto the live camera feed.

Key Features:

• AR Overlay: The app will display a virtual guide with arrows and markers to indicate the correct direction for the dish to align with the satellite.
• Dynamic Signal Feedback: A signal strength meter will appear on the screen, updating in real-time as the dish is adjusted.
• Interactive Tutorials: A step-by-step animated guide will appear in AR, showing users how to adjust azimuth, elevation, and skew.
• Color Transitions: The AR overlay will change colors (e.g., from red to green) as the alignment improves, providing immediate visual feedback.
• Haptic Feedback: The phone will vibrate gently when the dish is perfectly aligned, adding a tactile confirmation.

This innovative AR-based design will make the storm-hi app stand out as a futuristic and highly practical tool for satellite alignment.

7. Non-Functional Requirements

• The system must support both English and Urdu languages for accessibility in Pakistan.
• The Android app must function on devices with OS version 8.0 or higher.
• The system must provide a response time of less than 2 seconds for all API calls.
• The system must ensure data security and comply with local data protection regulations.
• The app must be lightweight, with a maximum size of 50 MB, to ensure compatibility with a wide range of Android devices.

8. Tech Stack

The following technologies will be used to develop the storm-hi project:

Frontend:

• React Native for Mobile App

Backend:

• Python
• FastAPI

Database:

• MySQL (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

9. Assumptions and Constraints

Assumptions:

• Users will have access to a stable internet connection during the alignment process.
• The system will primarily target users in Pakistan, but it will be scalable for global use.
• Satellite data will be provided and updated regularly by the API supervisor.

Constraints:

• The system must operate within the limitations of mobile device hardware, such as GPS accuracy and screen size.
• The application must comply with local regulations regarding satellite data usage and privacy.

10. Glossary

• API Supervisor: A backend system or administrator responsible for managing and updating satellite data.
• Azimuth: The horizontal angle measured clockwise from a reference direction, used in satellite alignment.
• Elevation: The vertical angle between the satellite and the horizon.
• Skew: The rotation angle of the satellite dish to align with the satellite's polarization.
• Signal Strength Feedback: Real-time data indicating the quality of the satellite signal received by the dish.
• Selective Re-Run Capability: A feature allowing users to manually regenerate specific sections of the SRD or app functionality.