Project-Image-Uploader/.github/ISSUES/upgrade-deps-react-node-20251028.md
matthias.lotz 58a1979b89 chore(upgrade): add issue template and upgrade plan for deps upgrade
- 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
2025-10-28 20:13:57 +01:00

2.0 KiB

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

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.