Skip to content
Open
98 changes: 26 additions & 72 deletions ss-messebau-configurator/README.md
Original file line number Diff line number Diff line change
@@ -1,73 +1,27 @@
# React + TypeScript + Vite
# S&S 3D Standkonfigurator

Interner React/Three-Konfigurator für Systemstände. Relevante Dateien:
- `src/components/Configurator3D.tsx` – 3D-Szene inkl. Edit-Mode & Kollisionslogik
- `src/components/SidebarControls.tsx` – UI/Presets & Kollisionshilfe
- `src/store/configStore.ts` – Zustand + Normalisierung

## Kollisionsprüfung (AABB)
- Alle bewegten Objekte (Counters, Screens, Kabine, Truss-Griff/‑Stützen) erhalten AABBs mit
einem Mindestabstand (Default `0.2 m`, konfigurierbar über `modules.collisionClearance`).
- Bewegungen werden in `onChange` geblockt, sobald ein AABB andere aktive Objekte schneiden
würde. Die Position springt zurück auf die zuletzt gültige Koordinate.
- Visuelles Feedback: roter Wireframe + Tooltip am betroffenen Objekt.
- Nur kollisionsfreie Positionen werden im Store gespeichert; ungültige Moves erzeugen keine
Seiteneffekte im Zustand.

## Collision-Playground
- Über die Sidebar („Kollisions-Playground“) lässt sich ein Mock-Stand mit mehreren Counters,
Screens, Kabine und Truss laden (`src/lib/playgrounds.ts`).
- Der Playground nutzt einen höheren Sicherheitsabstand (`0.25 m`) und eignet sich für
manuelle Checks von AABB-Kollisionen.

## Bedienhinweise (Auszug)
- Edit-Mode per Taste `E` aktivieren, Transform-Gizmos mit `T/R/S`, Snap via `G`.
- Objekte per Klick auswählen, Drag sperrt Orbit automatisch. Doppelklick auf Legacy-Counter
konvertiert sie in frei platzierbare Varianten.

This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.

Currently, two official plugins are available:

- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react) uses [Babel](https://babeljs.io/) (or [oxc](https://oxc.rs) when used in [rolldown-vite](https://vite.dev/guide/rolldown)) for Fast Refresh
- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react-swc) uses [SWC](https://swc.rs/) for Fast Refresh

## React Compiler

The React Compiler is not enabled on this template because of its impact on dev & build performances. To add it, see [this documentation](https://react.dev/learn/react-compiler/installation).

## Expanding the ESLint configuration

If you are developing a production application, we recommend updating the configuration to enable type-aware lint rules:

```js
export default defineConfig([
globalIgnores(['dist']),
{
files: ['**/*.{ts,tsx}'],
extends: [
// Other configs...

// Remove tseslint.configs.recommended and replace with this
tseslint.configs.recommendedTypeChecked,
// Alternatively, use this for stricter rules
tseslint.configs.strictTypeChecked,
// Optionally, add this for stylistic rules
tseslint.configs.stylisticTypeChecked,

// Other configs...
],
languageOptions: {
parserOptions: {
project: ['./tsconfig.node.json', './tsconfig.app.json'],
tsconfigRootDir: import.meta.dirname,
},
// other options...
},
},
])
```

You can also install [eslint-plugin-react-x](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-x) and [eslint-plugin-react-dom](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-dom) for React-specific lint rules:

```js
// eslint.config.js
import reactX from 'eslint-plugin-react-x'
import reactDom from 'eslint-plugin-react-dom'

export default defineConfig([
globalIgnores(['dist']),
{
files: ['**/*.{ts,tsx}'],
extends: [
// Other configs...
// Enable lint rules for React
reactX.configs['recommended-typescript'],
// Enable lint rules for React DOM
reactDom.configs.recommended,
],
languageOptions: {
parserOptions: {
project: ['./tsconfig.node.json', './tsconfig.app.json'],
tsconfigRootDir: import.meta.dirname,
},
// other options...
},
},
])
```
5 changes: 5 additions & 0 deletions ss-messebau-configurator/eslint.config.js
Original file line number Diff line number Diff line change
Expand Up @@ -19,5 +19,10 @@ export default defineConfig([
ecmaVersion: 2020,
globals: globals.browser,
},
rules: {
'@typescript-eslint/no-explicit-any': 'off',
'react-hooks/exhaustive-deps': 'off',
'react-hooks/set-state-in-effect': 'off',
},
},
])
38 changes: 34 additions & 4 deletions ss-messebau-configurator/src/App.tsx
Original file line number Diff line number Diff line change
@@ -1,13 +1,43 @@
import SidebarControls from "./components/SidebarControls";
import { useState } from "react";
import ConfiguratorPanel from "./components/ConfiguratorPanel";
import Configurator3D from "./components/Configurator3D";
import MobileDrawer from "./components/MobileDrawer";

export default function App() {
const [isMobileMenuOpen, setIsMobileMenuOpen] = useState(false);

return (
<div className="app-root">
<SidebarControls />
<main className="main-viewport">
<Configurator3D />
<div className="mobile-banner">Mobile Version aktiv</div>

<header className="app-header">
<h1 className="app-header__title">S&S Standkonfigurator</h1>
<button
type="button"
className="app-header__menu-btn"
aria-label="Menü öffnen"
aria-expanded={isMobileMenuOpen}
onClick={() => setIsMobileMenuOpen((prev) => !prev)}
>
Menü
</button>
</header>

<main className="app-main">
<div className="app-canvas-area main-viewport">
<Configurator3D />
</div>
<div className="app-sidebar">
<ConfiguratorPanel />
</div>
</main>

<MobileDrawer
open={isMobileMenuOpen}
onClose={() => setIsMobileMenuOpen(false)}
>
<ConfiguratorPanel />
</MobileDrawer>
</div>
);
}
Loading