System Requirements Document for mint-1

1. Introduction

The mint-1 project, also known as SATQUERY X, is a high-tech satellite image analysis and AI dashboard designed for ISRO and advanced users. It leverages cutting-edge technology and AI models to provide comprehensive satellite imagery analysis. The system is built using a React/Next.js frontend and a FastAPI backend, with a focus on providing a cinematic and futuristic user experience.

2. System Overview

The SATQUERY X system is designed to facilitate satellite image analysis through a user-friendly dashboard. It supports image uploads, GeoTIFF metadata validation, and advanced AI-driven analysis. The system includes a Planner Agent for task routing and a GeoReason Engine for cross-verifying analysis outputs. Users can generate detailed PDF reports of their analyses. The system is built with a focus on high-tech design and user experience, using a specified tech stack and adhering to a 24-hour execution plan.

2a. Product Interpretation and Delivery Boundary

The system is delivered as a web application with a React/Next.js frontend and a FastAPI backend. It requires user authentication for accessing protected features such as image uploads and analysis dashboards. The system persists data using PostgreSQL/PostGIS and generates reports using ReportLab. The Planner Agent and GeoReason Engine are key components, with the former handling task routing and the latter providing verification and confidence scoring. The system's design is inspired by Gleb Kuznetsov's cinematic future tech style, emphasizing a high-tech and immersive user experience.

2b. Source Content Inventory

Not applicable as no content source directive was provided.

2c. Page Content and Component Coverage

Home

• Purpose: Landing page introducing SATQUERY X.
• Components: Overview of features, navigation to login or upload.
• States: Loading, success.

Login

• Purpose: User authentication.
• Components: Username and password fields, login button.
• States: Loading, success, error.

Upload

• Purpose: Image upload and GeoTIFF validation.
• Components: Upload Zone, Image Preview, Validation Results.
• States: Loading, success, error.

Dashboard

• Purpose: Display analysis results and planning.
• Components: Map, Chat Box, Confidence Card, Execution Summary.
• States: Loading, success, error.

Report

• Purpose: PDF report generation and download.
• Components: Report preview, download button.
• States: Loading, success, error.

3. Functional Requirements

• As an Analyst, I should be able to upload satellite images for analysis.

  • Provenance: Explicit
  • Lifecycle: Initiated on the Upload page, validated using Rasterio/GDAL, results displayed on the same page.
  • Observable Result: Successful upload and validation results.

• As an Analyst, I should be able to view analysis results on a dashboard.

  • Provenance: Explicit
  • Lifecycle: Initiated on the Dashboard page after image upload and analysis.
  • Observable Result: Display of maps, AI answers, confidence scores, and execution summaries.

• As an Analyst, I should be able to generate and download a PDF report of my analysis.

  • Provenance: Explicit
  • Lifecycle: Initiated on the Report page, uses ReportLab for generation.
  • Observable Result: Downloadable PDF report.

• As an Analyst, I should be able to log in to access my projects and analyses.

  • Provenance: Required Inference
  • Lifecycle: Initiated on the Login page, required for accessing Upload, Dashboard, and Report pages.
  • Observable Result: Successful login grants access to protected features.

4. User Personas

• Analyst
  • Responsibilities: Upload satellite imagery, ask analysis questions, review maps and AI answers, download reports.
  • Outcomes: Successful image analysis, report generation, and data-driven decision-making.

5. Core User Flows

Analyst Flow

1. Access Home Page: View introductory content and navigate to login.
2. Login: Enter credentials to access the system.
3. Upload Image: Navigate to the Upload page, upload a satellite image, and view validation results.
4. View Dashboard: Access the Dashboard to view analysis results, including maps and confidence scores.
5. Generate Report: Navigate to the Report page and generate a PDF report of the analysis.
6. Download Report: Download the generated PDF for offline review.

6. Visuals Colors and Theme

• Muse: Gleb Kuznetsov
• Palette:
  • Background: #000022
  • Surface: #1c1c3a
  • Text: #ffffff
  • Primary: #00ffff
  • Accent: #ff00ff
  • Muted: #444466
• Typography:
  • Headings: Space Grotesk, Uppercase, wide spacing
  • Body: Orbitron
  • Scale: 1.5 modular, 64/42/28/18/14
• Shape Language: Full-bleed 3D scene, floating glass panels, thin luminous strokes
• Layout: Radial layouts with floating elements

7. Signature Design Concept

A full-bleed 3D scene dominates the viewport on the Home page, with floating glass panels displaying live data streams over a dark void. Electric cyan and magenta glows highlight important sections, creating an immersive and futuristic experience.

8. Interaction Model & Motion Direction

• Interaction Model: Animated
• Motion Tempo: Cinematic
• Hero Dimensionality: webgl
• Landing Hero Motion Brief: A full-bleed 3D holographic object with floating data panels, using electric cyan and magenta highlights that animate on hover. The scene orbits slowly, creating a sense of depth and immersion.

9. Non-Functional Requirements

• Performance: The system must handle concurrent user sessions efficiently.
• Scalability: The architecture should support scaling to accommodate increased data and user load.
• Security: User data must be protected with encryption and secure authentication mechanisms.
• Usability: The interface should be intuitive and accessible to users with varying levels of technical expertise.

10. Tech Stack

• Frontend: TypeScript, React, Next.js, Tailwind
• Backend: Python, FastAPI
• AI: PyTorch, RemoteCLIP, RSVQA, GroundingDINO, ChangeCLIP, SEN12MS encoder
• GIS: Rasterio, GDAL
• Database: PostgreSQL, PostGIS
• PDF Generation: ReportLab
• Tools: ChatGPT, Figma AI, GitHub, Docker, Postman

11. Assumptions and Constraints

• Assumption: Users have access to modern web browsers and stable internet connections.
• Constraint: The system must use the specified tech stack and adhere to the 24-hour execution plan.

12. Glossary

• GeoTIFF: A public domain metadata standard which allows georeferencing information to be embedded within a TIFF file.
• CRS: Coordinate Reference System, a coordinate-based local, regional or global system used to locate geographical entities.
• SAR: Synthetic Aperture Radar, a form of radar used to create two-dimensional images or three-dimensional reconstructions of objects.
• ISRO: Indian Space Research Organisation, the space agency of the Government of India.