bright-market System Requirements Document

Introduction

The "bright-market" project is designed to provide a personalized day trading tool for David Baldwin. This application will continuously analyze market level 2 order books to identify potential day trading opportunities, specifically focusing on pinpointing stocks and suggesting optimal buy and sell points.

System Overview

The bright-market application is a real-time trading assistant tailored for individual use. It leverages market level 2 order book data to provide actionable insights for day trading. The system is designed to streamline decision-making by focusing on identifying buy and sell opportunities without the need for additional complex features. The application will operate in the US market, considering locale-specific defaults such as currency (USD) and timezone (Eastern Standard Time).

Functional Requirements

• As a User, I should be able to receive real-time alerts when a stock meets the criteria for buying.
• As a User, I should be able to receive real-time alerts when a stock meets the criteria for selling.
• As a User, I should be able to view a dashboard that visualizes data trends and trading opportunities.

User Personas

• User: An individual day trader who utilizes the application to identify and act on trading opportunities in real-time.

Visuals Colors and Theme

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

Signature Design Concept

The bright-market application will feature an interactive "Market Pulse" homepage. This page will display a dynamic, real-time visualization of the stock market, represented as a pulsating network of nodes. Each node symbolizes a stock, with its size and color intensity reflecting trading volume and volatility. Users can hover over nodes to reveal detailed trading information and click to set alerts or view historical data. The visualization will be powered by d3 for data-driven transformations and framer-motion for smooth animations, creating an engaging and informative user experience.

Interaction Model & Motion Direction

The landing page will utilize a "parallax" interaction model, providing a layered depth effect as users scroll through the application. This will include decorative layers that move at different speeds, enhancing the storytelling aspect of the market data. Internal pages, such as dashboards and settings, will adopt a "static" interaction model to prioritize clarity and ease of use for data-heavy content.

Non-Functional Requirements

• The system must process and analyze market data with minimal latency to ensure real-time performance.
• The application should be highly reliable, with an uptime of 99.9% to support continuous trading activities.
• The user interface must be intuitive and responsive, supporting both desktop and mobile devices.

Tech Stack

• Frontend: React for Web
• Backend: Python with FastAPI
• Database: MongoDB for storing historical trading data
• AI Models: GPT 5.4 for generating user-friendly alerts and insights
• Local Orchestration: Docker and docker-compose
• Server-side Orchestration: Kubernetes

Assumptions and Constraints

• The application will operate within the US stock market, focusing on stocks listed on major exchanges.
• Real-time data feeds will be sourced from a reliable market data provider.
• The application will be designed for personal use, not intended for commercial distribution.

Glossary

• Level 2 Order Book: A detailed view of the market's buy and sell orders, showing the price levels and quantities available.
• Day Trading: The practice of buying and selling financial instruments within the same trading day.
• Parallax: A design technique that creates an illusion of depth by moving background images slower than foreground images.
• Node: A visual representation of a stock within the market pulse visualization.

This document outlines the requirements and design considerations for the bright-market project, ensuring a focused and efficient tool for day trading.