Skip to content

WEBAPP.md

Latest commit

 

History

History
115 lines (81 loc) · 5.28 KB

WEBAPP.md

File metadata and controls

115 lines (81 loc) · 5.28 KB
Raw

MethodenAnalyser Lokale Weboberfläche

Stand: 2026-08-11

Die lokale Weboberfläche ist ein Hilfs-/Demo-Modus für schnelle Snippet-, Einzeldatei- und kleine ZIP-Analysen auf demselben Rechner. Sie ersetzt nicht die Desktop-App für ganze Projektordner, ist keine Companion-App und keine eigene Mobile-Produktlinie. Sie nutzt denselben Analysekern und dasselbe JSON-Format wie CLI und GUI.

Sprache

Die sichtbaren Kernsteuerelemente der Weboberfläche lassen sich über die Sprachauswahl auf Deutsch, Englisch, Spanisch, Chinesisch, Japanisch oder Russisch umstellen. Der Browser lädt die Texte über GET /api/translations?lang=<code> aus derselben locales/translations.json-Quelle wie GUI und CLI und speichert nur den gewählten Sprachcode im lokalen Browserprofil. Für CLI-Hilfe und Textreports steht derselbe Katalog über --lang <code> bereit, zum Beispiel python MethodenAnalyser3.py --lang en --file beispiel.py.

Start

python webapp/server.py

Unter Windows kann alternativ START_WEBAPP.bat per Doppelklick gestartet werden.

Standard-Adresse:

http://127.0.0.1:8765/

Optionale Parameter:

python webapp/server.py --host 127.0.0.1 --port 8765

Für Android-/iOS-Tests im selben WLAN:

python webapp/server.py --host 0.0.0.0 --port 8765

Die Oberfläche kann dann erkannte LAN-URLs anzeigen. Das ist nur ein technischer Testpfad für lokale Browser-Smokes, kein geplanter Android-/iOS-Releasepfad. Der LAN-Modus nutzt bewusst nur lokales HTTP: Es gibt keine Authentifizierung und kein TLS. Deshalb nur in einem vertrauenswürdigen, eigenen Netz starten und keinen Quellcode oder Bericht über fremde/offene Netze senden.

Funktionen

  • Python-Code in das Textfeld einfügen und lokal analysieren.
  • Einzelne .py-Dateien im Browser öffnen und analysieren.
  • Kleine .zip-Archive mit Python-Dateien lokal hochladen und als Mini-Projekt analysieren.
  • Textreport direkt anzeigen.
  • JSON-Report im Schema methodenanalyser-report-v1.json anzeigen, speichern und wieder importieren.
  • Entwurf und letzter JSON-Report lokal im Browser zwischenspeichern.
  • PWA installieren und nach der ersten Nutzung offline erneut öffnen.
  • Statische PWA-Dateien mit Service Worker cachen; die Analyse-API bleibt lokal und wird nicht gecacht.

Browser-Verhalten

  • Chrome und Edge können die Oberfläche als installierbare PWA anbieten.
  • Für lokale Browser-Smokes zeigt die Oberfläche den empfohlenen LAN-Startbefehl und, falls erkannt, direkte URLs zum Kopieren.
  • Die PWA-Testkarte bündelt App-Modus, Install-Flow, Service-Worker-Status, lokalen Speicher, Viewport und den erkannten Serverpfad in einer kopierbaren Kurzdiagnose.
  • Bereits geladene Oberfläche bleibt durch den Service Worker auch ohne laufenden Server erreichbar.
  • Neue Analysen benötigen weiter den lokalen Python-Prozess; offline bleiben Entwurf, letzter JSON-Report, importierte Reports und die UI verfügbar.
  • Android und iOS sind keine Zielplattformen; es gibt keine native App, keine Mobile-Roadmap und keinen Cloud-Sync.

Lokale API

POST /api/analyze

Request:

{
  "source_kind": "snippet",
  "filename": "<snippet>",
  "code": "import os\nprint('ok')\n"
}

source_kind ist für POST /api/analyze aktuell snippet, file oder zip. Ein project-POST wird bewusst mit HTTP 400 abgelehnt.

Für ZIP-Analysen wird statt code ein Base64-Feld zip_base64 gesendet. Das Archiv bleibt lokal, wird temporär entpackt und nur auf .py-Dateien geprüft.

Quellenmatrix

Quelle API-Eingang Report-Import Bedeutung
snippet Ja Ja Einzelner Code-Snippet
file Ja Ja Einzelne Datei, Dateiname wird auf den Basename reduziert
zip Ja Ja Kleines lokales ZIP mit Python-Dateien
project Nein Ja Fertiger Desktop-/CLI-Projektbericht, nur Anzeige/Import

Die UI akzeptiert project ausschließlich beim Laden eines bereits erzeugten methodenanalyser-report-v1.json. Der lokale Server analysiert Projektordner nicht über die API; dadurch bleiben API-Quellen und importierte Projektberichte klar getrennt.

Response:

{
  "ok": true,
  "has_findings": true,
  "text_report": "...",
  "report": {
    "schema_version": "methodenanalyser-report-v1"
  }
}

Datenschutz und LAN-Grenze

Der Standardstart bindet ausschließlich an 127.0.0.1; damit ist die Oberfläche nur auf diesem Rechner erreichbar. Code wird an den lokalen Python-Prozess gesendet, nicht an externe Dienste. Es gibt keine Telemetrie, keine Cloud-Synchronisierung und keine externen CDN-Abhängigkeiten.

--host 0.0.0.0 oder eine andere LAN-Adresse ist eine bewusste Ausnahme für einen technischen Test im selben vertrauenswürdigen Netz. Der Server bietet dabei weder Authentifizierung noch TLS und ist kein Internet-Deployment. Alle Clients, die die LAN-URL erreichen, können die lokale Analyse-API verwenden; keine sensitiven Dateien oder Berichte über ein fremdes/offenes Netz übertragen.

Grenzen

  • Große Projektordner bleiben Aufgabe der Desktop-/CLI-Version.
  • ZIP-Uploads sind bewusst klein gehalten: nur .py-Dateien, begrenzte Archivgröße und keine beliebigen Binärdateien.
  • Android und iOS können nur über diesen technischen PWA-/Browser-Smoke im selben WLAN geprüft werden; native Apps und eine Mobile-Produktlinie sind weiterhin Nicht-Ziele.