urban-way System Requirements Document

Introduction

The "urban-way" project aims to develop a sophisticated AI assistant tailored to the daily needs of Desert, an executive user. This assistant, inspired by the concept of J.A.R.V.I.S., will focus on enhancing productivity through intelligent integration with services like Outlook, providing proactive assistance in managing emails, scheduling, and more.

System Overview

The urban-way project is designed to create an AI assistant that seamlessly integrates with Outlook to manage emails and scheduling. The system will support both voice and text command interactions, making it intuitive and efficient for executive-level tasks. The primary goal is to streamline daily operations and enhance productivity by automating routine tasks and providing intelligent insights.

Functional Requirements

• As an Executive, I should be able to manage my emails through voice commands.
• As an Executive, I should be able to schedule meetings and appointments using text commands.
• As an Executive, I should be able to receive reminders for upcoming tasks and meetings.
• As an Executive, I should be able to integrate the assistant with Outlook for seamless email and calendar management.
• As an Executive, I should be able to use both voice and text commands to interact with the assistant.

User Personas

• Executive User: The primary user of the urban-way assistant, responsible for managing high-level tasks, communications, and scheduling. This user requires a system that is intuitive, efficient, and capable of handling complex commands.

Visuals Colors and Theme

• primary: #121212 (a deep black representing sophistication and focus)
• primary_light: #1E1E1E (a lighter tint of the primary color for hover states)
• secondary: #BB86FC (a soft purple hue for emphasis and links)
• accent: #03DAC6 (a vibrant teal for CTAs and active states)
• highlight: #CF6679 (a muted red hue for notifications and active indicators)
• bg: #121212 (a dark gray for the page background)
• surface: rgba(18, 18, 18, 0.9) (a soft black for card/panel backgrounds)
• text: #E0E0E0 (a light gray for primary text)
• text_muted: #B0B0B0 (a softer gray for secondary text)
• border: rgba(50, 50, 50, 0.5) (a subtle dark gray for borders)

Signature Design Concept

The urban-way project will feature a dynamic and interactive homepage that resembles a futuristic command center. Using @react-three/fiber and gsap, the homepage will present a 3D holographic interface where users can interact with floating panels representing different functionalities like email, calendar, and task management. The tagline will be updated to "Welcome Master". The executive-focused subtitle will be removed. As users hover over or click these panels, they will animate with smooth transitions, providing a tactile and engaging experience. The interface will also feature subtle ambient animations that respond to user interactions, creating a sense of immersion and control. Additionally, the background will include dynamic, subtly moving elements to convey intelligence while maintaining a dark theme.

Interaction Model & Motion Direction

The landing page will adopt a "parallax" interaction model, providing a layered depth experience via scroll. Decorative elements will translate at different speeds, enhancing the storytelling aspect of the assistant's capabilities. Internal pages will maintain a "static" interaction model to ensure clarity and speed in accessing information and functionalities.

Non-Functional Requirements

• The system must be highly responsive and capable of processing voice and text commands in real-time.
• The integration with Outlook must be secure and comply with data privacy regulations.
• The user interface should be intuitive and accessible, adhering to accessibility standards.

Tech Stack

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

Assumptions and Constraints

• The system will initially focus on integration with Outlook, with potential expansions to other services in future phases.
• The AI assistant will be designed to handle executive-level tasks, with scalability for additional functionalities.
• The project will adhere to Omani data protection laws and regulations.

Glossary

• AI Assistant: An artificial intelligence system designed to assist users with tasks through voice and text commands.
• Outlook Integration: The process of connecting the AI assistant with Microsoft Outlook to manage emails and calendar events.
• Voice Commands: Spoken instructions that the AI assistant can interpret and act upon.
• Text Commands: Written instructions that the AI assistant can interpret and act upon.