eagle-apk System Requirements Document

Introduction

The purpose of this document is to outline the system requirements for the "eagle-apk" project, which aims to convert the existing web application, "Isolated Trader," into a mobile APK. This application serves as a personal trainer with routine reminders and a trading learning platform. The goal is to ensure the APK version retains all the features and functionalities of the current web app.

System Overview

The "eagle-apk" project is designed to provide users with a comprehensive mobile application that combines personal training routines with trading education. The application will include features such as routine reminders, educational content, and interactive learning modules. The APK will be developed to ensure seamless user experience and accessibility on mobile devices, reflecting the full capabilities of the existing web application.

Functional Requirements

• As a User, I should be able to access personal training routines.
• As a User, I should receive routine reminders.
• As a User, I should be able to access trading learning materials.
• As a User, I should have interactive learning modules for trading.
• As a User, I should be able to track my progress in both training and trading.
• As a User, I should be able to use the camera to track exercise posture and movement.
• As a User, I should be able to customize my training and learning schedules.

User Personas

• User: Individuals seeking personal training and trading education. They require routine reminders and interactive learning experiences.

Visuals Colors and Theme

• primary: #1E3A8A (Deep Indigo)
• primary_light: #3B82F6 (Light Blue)
• secondary: #F97316 (Vibrant Orange)
• accent: #10B981 (Emerald Green)
• highlight: #F59E0B (Amber)
• bg: #F3F4F6 (Light Gray)
• surface: rgba(255, 255, 255, 0.8) (White)
• text: #111827 (Dark Gray)
• text_muted: #6B7280 (Muted Gray)
• border: rgba(209, 213, 219, 0.2) (Light Gray)

Signature Design Concept

The "eagle-apk" will feature an interactive galaxy map as its homepage. Each star in the galaxy represents a feature or section of the app, such as training routines, trading lessons, or progress tracking. Users can click on a star to open a task card, drag to rotate the galaxy cluster, and hover to highlight connections between different sections. This dynamic and engaging interface will be built using @react-three/fiber and @react-three/drei for 3D interactions, providing a unique and memorable user experience.

Interaction Model & Motion Direction

The landing page will utilize a "parallax" interaction model, creating a layered depth effect as users scroll through the app. Decorative elements like atmospheric blobs and distant shapes will move at different speeds, enhancing the storytelling aspect of the app. The real content will remain in the normal flow, ensuring a natural scrolling experience. Internal pages will adopt a "static" interaction model for clarity and ease of use.

Non-Functional Requirements

• The application must be responsive and perform well on a variety of mobile devices.
• The APK should be lightweight and optimized for quick loading times.
• Ensure data security and user privacy are maintained throughout the application.

Tech Stack

• Frontend: React Native for mobile app development.
• Backend: Python with FastAPI.
• Database: MySQL or MariaDB, using Alembic for migrations.
• AI Models: GPT 5.4 for user-friendly responses.
• Local Orchestration: Docker and docker-compose.
• Server-side Orchestration: Kubernetes.

Assumptions and Constraints

• The APK will be developed to mirror the existing web app's features without introducing new functionalities.
• The application will be designed to operate primarily in the Indian market, considering local preferences and standards.
• Development will focus on ensuring compatibility with the latest Android devices.

Glossary

• APK: Android Package Kit, the file format used by Android operating systems for distribution and installation of mobile apps.
• React Native: A framework for building native apps using React.
• FastAPI: A modern, fast web framework for building APIs with Python.
• Alembic: A lightweight database migration tool for use with SQLAlchemy.
• Docker: A platform for developing, shipping, and running applications in containers.
• Kubernetes: An open-source system for automating deployment, scaling, and management of containerized applications.