System Requirements Document for site-matrix3d

1. Introduction

SITE MATRIX 3D is a mobile application designed for professionals and enthusiasts in the architectural field. It provides a platform for designing and inspecting architectural structures using a floating holographic 3D viewport. The app features a wireframe aesthetic with dynamic callouts, thumb-driven navigation, and AI-assisted design features to enhance user interaction and creativity.

2. System Overview

SITE MATRIX 3D is a mobile app that allows users to design and inspect architectural structures in a 3D holographic environment. The app employs a wireframe aesthetic with glowing cyan/neon-blue vector lines and luminous nodes, providing a futuristic and interactive user experience. Key features include thumb-driven navigation, real-time AI suggestions, and the ability to auto-generate 2D CAD floor plans and elevations from the 3D model.

2a. Product Interpretation and Delivery Boundary

The app is designed to operate within a mobile context, providing a seamless experience for users to create and inspect architectural designs. It requires self-service enrollment for first-time users and returning verification for those revisiting saved models. The app maintains backend persistence for durable architectural models and resumable design states. The delivery is focused on providing a custom UI with application-owned identity management.

2b. Source Content Inventory

Not applicable as no content_source directive was provided.

2c. Page Content and Component Coverage

Landing

• Information/State: Introduction to SITE MATRIX 3D, its purpose, and holographic viewport workflow.
• Primary Actions: Explore app features, understand the design and inspection capabilities.
• Components: Overview video, feature highlights, call-to-action for app download.

Login

• Information/State: User authentication for returning users.
• Primary Actions: Enter credentials, password recovery.
• Components: Login form, error messages for incorrect credentials.

Projects

• Information/State: List of saved architectural models.
• Primary Actions: Browse projects, select a project to continue or revise.
• Components: Project thumbnails, search/filter options, project metadata display.

Studio

• Information/State: Freeform architectural creation and editing environment.
• Primary Actions: Draw, stack blocks, navigate scenes.
• Components: Drawing tools, block library, navigation controls.

Inspect

• Information/State: Detailed inspection of structures in 3D viewport.
• Primary Actions: View coordinate callouts, access blueprint HUD.
• Components: Coordinate vectors, HUD panels, inspection tools.

Layers

• Information/State: Visualization modes for structures.
• Primary Actions: Switch between wireframe, solid, and exploded views.
• Components: View mode toggles, visualization settings.

Suggestions

• Information/State: AI-generated design suggestions.
• Primary Actions: Review and apply suggestions.
• Components: Suggestion list, apply button, feedback mechanism.

Plans

• Information/State: 2D CAD floor plans and elevations.
• Primary Actions: Generate and view plans.
• Components: Plan viewer, export options.

Settings

• Information/State: Application and workspace settings.
• Primary Actions: Adjust settings, save preferences.
• Components: Settings menu, preference sliders, save button.

Actions

• Information/State: Model operations within the design workflow.
• Primary Actions: Execute model actions, undo/redo changes.
• Components: Action toolbar, history panel.

3. Functional Requirements

• As a 3D Designer/Inspector, I should be able to design and inspect architectural structures in a floating holographic 3D viewport. (explicit)
• As a 3D Designer/Inspector, I should be able to use a wireframe aesthetic with glowing cyan/neon-blue vector lines and luminous nodes. (explicit)
• As a 3D Designer/Inspector, I should be able to present structures over a multi-layered interactive circular rotation disc on a 3D ground plane. (explicit)
• As a 3D Designer/Inspector, I should see live x, y, z, and xyz coordinate callouts for key structural points. (explicit)
• As a 3D Designer/Inspector, I should have access to a blueprint HUD with project numbers, revision codes, scale rulers, and quick actions. (explicit)
• As a 3D Designer/Inspector, I should experience subtle levitation oscillation, micro-rotations, wireframe light shimmer, and ambient grid particles. (explicit)
• As a 3D Designer/Inspector, I should be able to toggle among holographic wireframe, volumetric solid, and exploded structural-layer views. (explicit)
• As a 3D Designer/Inspector, I should navigate using thumb-driven controls and gyroscope/AR tilt. (explicit)
• As a 3D Designer/Inspector, I should have the freedom to draw freehand and stack procedural blocks without strict CAD limits. (explicit)
• As a 3D Designer/Inspector, I should receive real-time AI suggestions for structural, architectural, and aesthetic improvements. (explicit)
• As a 3D Designer/Inspector, I should be able to auto-generate 2D CAD floor plans and elevations from the 3D model in real time. (explicit)
• As a 3D Designer/Inspector, I should be able to enroll and verify my identity to create and manage durable models. (required_inference)

4. User Personas

• 3D Designer/Inspector: Responsible for creating, manipulating, inspecting, and refining architectural structures in the 3D viewport. This persona interacts with all aspects of the app, from initial design to final inspection and AI-assisted improvements.

5. Core User Flows

3D Designer/Inspector Flow

1. Landing Page: User opens the app and views an introduction to SITE MATRIX 3D.
2. Login: User enters credentials to access saved projects.
3. Projects Page: User browses and selects a project to continue or revise.
4. Studio Page: User engages in freeform design using drawing tools and procedural blocks.
5. Inspect Page: User inspects the structure with dynamic callouts and HUD information.
6. Layers Page: User switches between different visualization modes.
7. Suggestions Page: User reviews and applies AI-generated suggestions.
8. Plans Page: User generates and views 2D CAD plans.
9. Settings Page: User adjusts application and workspace settings.
10. Actions Page: User performs model operations and manages design workflow.

6. Visuals Colors and Theme

• Muse: Gleb Kuznetsov
• Palette:
  • Background: #000022
  • Surface: #111133
  • Text: #E0E0FF
  • Primary: #00FFFF
  • Accent: #FF00FF
  • Muted: #333355
• Typography:
  • Headings: Orbitron — Bold uppercase
  • Body: Space Grotesk
  • Scale: 1.414 modular (64/45/32/24/18)
• Shape Language: Floating glass panels, thin luminous strokes, radial layouts
• Layout: Full-bleed 3D scenes with floating control panels and HUD elements
• Motion: Continuous slow orbit and parallax, light sweeps, data streams

7. Signature Design Concept

The public entry page features a full-bleed 3D scene with a wireframe structure hovering over a dynamic circular disc. The scene is accented by glowing coordinate vectors and ambient particles, set against a deep navy background. The dominant elements are the wireframe and interactive HUD, creating an immersive first impression.

8. Interaction Model & Motion Direction

• Interaction Model: Animated
• Motion Tempo: Cinematic
• Hero Dimensionality: WebGL
• Landing Hero Motion Brief: The focal subject is a wireframe 3D structure with dynamic xyz vectors. The transformation involves thumb-driven navigation and real-time AI suggestions, using cinematic motion vocabulary. The first frame shows the structure hovering with ambient particles, and a reduced-motion state is available for accessibility.

9. Non-Functional Requirements

• The app must operate smoothly on mobile devices, providing a responsive and immersive user experience. (explicit)
• The app must support real-time updates and AI suggestions without noticeable lag. (explicit)
• The app must maintain secure user authentication and data persistence. (required_inference)

10. Tech Stack

• Frontend: React Native for mobile app development
• Backend: Python/FastAPI for API services
• Storage: Appropriate cloud storage solutions for model persistence
• Deployment: Docker/docker-compose for containerization; Kubernetes if required for scaling

11. Assumptions and Constraints

• The app is designed exclusively for mobile platforms. (explicit)
• The wireframe aesthetic and interactive elements are central to the user experience. (explicit)
• User identity management is necessary for accessing and managing durable models. (required_inference)

12. Glossary

• 3D Viewport: The interactive area where users can view and manipulate 3D models.
• Wireframe Aesthetic: A visual style using glowing vector lines to represent structures.
• AI Co-Pilot: A feature providing real-time design suggestions and improvements.
• Thumb-Driven Navigation: A control scheme using thumb gestures for navigation and interaction.