Generate comprehensive technical architecture documentation with Mermaid diagrams

[Copilot]

This PR adds comprehensive technical architecture documentation for Zoo Design Studio, providing detailed insights into the system's design, component interactions, and development workflows.

Documentation Added

The documentation is organized into 8 focused sections covering all aspects of the application architecture:

📋 Technical Architecture Overview

• High-level system architecture with core design principles
• Technology stack overview and key architectural decisions
• Performance considerations and security aspects
• Rich Mermaid diagram showing the complete system architecture

🎨 Frontend Architecture

• React component hierarchy and state management patterns
• XState integration and context providers
• Code editor (CodeMirror) and 3D viewer (Three.js) integration
• UI component system and performance optimizations

⚙️ Backend Architecture

• Rust implementation details and WASM integration
• KCL language compiler and execution engine
• Language Server Protocol (LSP) implementation
• Memory management and cross-platform considerations

🔄 Data Flow

• Complete data flow patterns with sequence diagrams
• State synchronization and conflict resolution
• Real-time communication via WebSockets
• Caching strategies and performance optimizations

🎯 State Management

• XState machine architecture and communication patterns
• State persistence and hydration strategies
• Error handling and recovery mechanisms
• Debugging and testing approaches

🚀 Build & Deployment

• Multi-stage build pipeline (Rust/WASM + TypeScript/React)
• CI/CD workflows and cross-platform packaging
• Development environment setup and hot reloading
• Performance monitoring and optimization strategies

🔗 Component Interactions

• Detailed component communication protocols
• Integration patterns for WASM, WebSockets, and file systems
• Error propagation and boundary handling
• Cross-component state synchronization

👩‍💻 Development Guide

• Complete developer onboarding with environment setup
• Code organization patterns and naming conventions
• Testing workflows (unit, integration, e2e)
• Best practices and contribution guidelines

Key Features

• 25+ Mermaid Diagrams: Comprehensive visual representation of system architecture, data flow, state machines, and component interactions
• Technology Deep Dives: Detailed coverage of React, TypeScript, Rust, WASM, XState, Three.js, CodeMirror, and Electron
• Practical Examples: Real code snippets demonstrating architectural patterns and implementation details
• Developer-Focused: Clear setup instructions, coding standards, and contribution workflows
• Performance-Oriented: Optimization strategies, caching patterns, and monitoring approaches

Architecture Highlights

The documentation showcases Zoo Design Studio's innovative approach to CAD software:

• Code-First Modeling: All geometric models represented as human-readable KCL code
• Hybrid Interface: Seamless integration between visual tools and direct code editing
• Modern Web Stack: GPU-accelerated 3D rendering with WebGL and Three.js
• WASM Performance: Near-native performance for language processing in the browser
• State Machine Architecture: Predictable state management with XState
• Cross-Platform: Unified codebase for web and desktop (Electron) deployment

The documentation serves both as an architectural reference for contributors and a comprehensive guide for understanding the sophisticated engineering behind this modern CAD application.

Fixes #1.

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[Copilot]

@drzo 👋 This repository doesn't have Copilot instructions. With Copilot instructions, I can understand the repository better, work faster and produce higher quality PRs.

I can generate a .github/copilot-instructions.md file for you automatically. Click here to open a pre-filled issue and assign it to me. I'll write the instructions, and then tag you for review.