---
title: "Upgrade: React & Node (upgrade/deps-react-node-20251028)"
labels: ["enhancement", "dependencies", "infra"]
assignees: []
---

Kurzbeschreibung
-----------------

Dieses Issue beschreibt Analyse, Risiken und einen initialen Plan für das Upgrade von Frontend- und Backend-Dependencies in diesem Repository. Der zugehörige Branch ist `upgrade/deps-react-node-20251028`.

Motivation
----------

- Sicherheits- und Performance-Updates
- Kompatibilität mit aktuellen Toolchains (Node LTS, React 18+, aktuelle Build-Tools)

Aktueller Status (Inventar)
---------------------------

- Frontend
  - react: ^17.0.1
  - react-dom: ^17.0.1
  - react-scripts: 4.0.3
  - @material-ui/core: ^4.11.3 (MUI v4)
  - react-router-dom: ^5.2.0

- Backend
  - node runtime in Dockerfile: node:14
  - express: ^4.17.1
  - sqlite3: ^5.1.7

Kurz-Plan (high level)
----------------------

1. Sicherheits-Upgrade: Backend Dockerfile → node:18 (smoke-test)
2. Frontend: react/react-dom → 18.x, react-scripts → 5.x (build & tests)
3. Optional: react-router v5 → v6 (Routes/useNavigate) — separater PR
4. Optional/Medium-term: MUI v4 → v5 (großer Refactor, separat)

Risiken
-------

- MUI-Migration ist der aufwändigste Schritt: makeStyles/JSS -> sx/styled
- react-router v6 erfordert Änderungen an allen Routen/Navigation uses
- Native Node-Module (sqlite3) können Rebuilds in CI erfordern

Erwartete Artefakte / Deliverables
---------------------------------

- PR(s) auf Branch `upgrade/deps-react-node-20251028` mit:
  - `docs/UPGRADE_PLAN-upgrade-deps-react-node-20251028.md` (detaillierter Plan)
  - Änderungen für Node runtime bump (Dockerfile)
  - Optional: subsequent PRs für React/MUI/Router

Nächste Schritte
---------------

1. Test-Phase: Node 14 → 18 (backend Dockerfile) — Build & smoke-test im Container
2. PR mit Node-Bump + Aktualisierte TODO/Plan
3. React 18 Upgrade in separatem PR

Anmerkung
--------
Diese Datei ist eine Vorlage für Issue/PR-Beschreibung; nach dem Push auf Remote kann sie in GitHub/Gitea als Issue oder PR-Body verwendet werden.