How pong-lei/su7_imitate works
Project Type and Purpose
• This is a front-end single-page application built with Vue 3 and Vite.
• Purpose: an interactive 3D car-visualization tool with three modes (“wind resistance,” “body inspection,” “smart driving”), using WebGL/Three.js plus custom GLSL shaders and Draco-compressed 3D assets.
High-Level Architecture
• No backend/microservices: all logic runs in the browser.
• Core components:
• Build & Serve (Vite, package.json)
• Static Assets (public folder: Draco decoders, images)
• Application Code (src folder: Vue components, shaders, models)
• Rendering Engine (Three.js via imports, custom shaders)
• Deployment (static hosting on Vercel)
Main Components
a. Browser/Client
• Vue 3 SPA (App.vue → child components)
• Vite dev server/build pipeline
b. Rendering Engine
• Three.js scene graph
• Custom GLSL shaders (fragment.glsl, vertex.glsl)
• Draco decoder WASM + JS modules (public/draco)
c. Asset Store
• 3D models (.glb, .gltf, .blend backups, JSON outlines)
• Textures (.hdr, .mp3 audio)
d. User Interaction Layer
• Mode-switch UI in components/World/I_drivingMode
• Animation logic in components and Test/groundGlass
e. Deployment
• Vite output → static files
• Served via Vercel URL
Relationships & Data Flow
• User events → Vue components → update Three.js scene graph
• Vue components import shaders & models → pass to Three.js renderer
• Three.js + WebGL → GPU → Canvas in index.html
• Build step (Vite) bundles src, shaders, public assets → dist
• Dist deployed to Vercel → CDN → Browser
Architectural Patterns & Principles
• Component-based UI (Vue’s single-file components)
• Layered separation: UI layer ↔ Rendering layer ↔ Asset layer
• Static asset pipeline: Draco compression for model delivery
• Build-time configuration (vite.config.js) decoupled from runtime
Technologies & Frameworks
• Vue 3 (composition API via .vue files)
• Vite (ESM bundler, dev server)
• Three.js (3D engine)
• Draco (geometry compression, WASM)
• GLSL (custom shaders for glass, outlines, bloom, wind lines)
• Vercel (static hosting)