matthias.lotz
58a1979b89
- Add .github/ISSUES/upgrade-deps-react-node-20251028.md with analysis summary - Add docs/UPGRADE_PLAN-upgrade-deps-react-node-20251028.md with detailed plan and steps Branch: upgrade/deps-react-node-20251028
66 lines
2.0 KiB
Markdown
66 lines
2.0 KiB
Markdown
---
|
|
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.
|