robert/rezeptbuch
Watch
1
0
Fork
You've already forked rezeptbuch
 0
Code Issues 16 Pull requests Projects Releases Packages Wiki Activity Actions

Problem oder Idee melden #16

New issue
Closed
opened 2026-10-07 22:22:38 +02:00 by lena · 3 comments
lena commented 2026-10-07 22:22:38 +02:00
Collaborator
Copy link

Ziel

Fällt beim Benutzen ein Fehler auf oder kommt eine Idee für die App, soll sie
sofort festgehalten werden können – mit den technischen Angaben, die beim
Nachvollziehen helfen. Die Nachricht landet als Issue im Kochbuch-Projekt auf
git.butzei.de. Übernommen aus Checkly.

Grundlage

PRD Kapitel 19 (Punkt 13), 21 (Glossar „Problem oder Idee melden“);
CLAUDE.md „Technik-Stapel“; Checkly Checkly/Features/Feedback/,
Checkly/Forgejo/, ReactUi/src/components/FeedbackButton.tsx und
FeedbackDialog.tsx

Abhängig von

#1

Akzeptanzkriterien

  • AK-1: Der Knopf „Problem oder Idee melden“ ist von jeder Seite aus
    erreichbar, stört aber nicht beim Lesen und Kochen (z. B. im Menü, nicht
    als schwebender Knopf im Kochmodus).
  • AK-2: In der Oberfläche wird nicht das Wort „Feedback“ verwendet.
  • AK-3: Ein Dialog nimmt einen freien Text an; leer kann nicht gesendet
    werden.
  • AK-4: Nach dem Senden entsteht im Repo robert/rezeptbuch ein Issue.
    Titel: die erste Zeile der Nachricht (gekürzt). Inhalt: der Text und die
    Angaben Name aus der Haushaltsanmeldung, Zeitpunkt, aktuelle Seite, ggf.
    geöffnetes Rezept (Titel und Nummer), Browser, Bildschirmgröße, Sprache,
    online/offline.
  • AK-5: Die App bestätigt das Senden („Danke, ist angekommen“) oder sagt
    verständlich, dass es nicht geklappt hat; der Text geht dabei nicht
    verloren.
  • AK-6: Der Zugangsschlüssel für git.butzei.de liegt nur auf dem Server
    (Einstellung wie in Checkly) und gelangt nie in den Browser.
  • AK-7: Ist kein Zugangsschlüssel eingerichtet, ist der Knopf
    ausgeblendet.
  • AK-8: Die vom Browser mitgeschickten Angaben werden auf dem Server auf
    eine Höchstlänge gekürzt (wie in Checkly 300 Zeichen), damit niemand das
    Issue aufblähen kann.

Nicht in dieser Stufe

– Bildschirmfotos oder Bilder werden nicht mitgeschickt (entschieden
08.10.2026, wie in Checkly). Ein Bild kann bei Bedarf direkt im Issue auf
git.butzei.de angehängt werden.

Offene Fragen

  1. Bildschirmfoto mitschicken? – entschieden 08.10.2026: nein, nur
    Text und die automatischen Angaben, wie in Checkly.

Alle offenen Fragen sind geklärt; das Issue ist bereit zum Bau.

## Ziel Fällt beim Benutzen ein Fehler auf oder kommt eine Idee für die App, soll sie sofort festgehalten werden können – mit den technischen Angaben, die beim Nachvollziehen helfen. Die Nachricht landet als Issue im Kochbuch-Projekt auf git.butzei.de. Übernommen aus Checkly. ## Grundlage PRD Kapitel 19 (Punkt 13), 21 (Glossar „Problem oder Idee melden“); CLAUDE.md „Technik-Stapel“; Checkly `Checkly/Features/Feedback/`, `Checkly/Forgejo/`, `ReactUi/src/components/FeedbackButton.tsx` und `FeedbackDialog.tsx` ## Abhängig von #1 ## Akzeptanzkriterien - **AK-1:** Der Knopf „Problem oder Idee melden“ ist von jeder Seite aus erreichbar, stört aber nicht beim Lesen und Kochen (z. B. im Menü, nicht als schwebender Knopf im Kochmodus). - **AK-2:** In der Oberfläche wird nicht das Wort „Feedback“ verwendet. - **AK-3:** Ein Dialog nimmt einen freien Text an; leer kann nicht gesendet werden. - **AK-4:** Nach dem Senden entsteht im Repo `robert/rezeptbuch` ein Issue. Titel: die erste Zeile der Nachricht (gekürzt). Inhalt: der Text und die Angaben Name aus der Haushaltsanmeldung, Zeitpunkt, aktuelle Seite, ggf. geöffnetes Rezept (Titel und Nummer), Browser, Bildschirmgröße, Sprache, online/offline. - **AK-5:** Die App bestätigt das Senden („Danke, ist angekommen“) oder sagt verständlich, dass es nicht geklappt hat; der Text geht dabei nicht verloren. - **AK-6:** Der Zugangsschlüssel für git.butzei.de liegt nur auf dem Server (Einstellung wie in Checkly) und gelangt nie in den Browser. - **AK-7:** Ist kein Zugangsschlüssel eingerichtet, ist der Knopf ausgeblendet. - **AK-8:** Die vom Browser mitgeschickten Angaben werden auf dem Server auf eine Höchstlänge gekürzt (wie in Checkly 300 Zeichen), damit niemand das Issue aufblähen kann. ## Nicht in dieser Stufe – Bildschirmfotos oder Bilder werden nicht mitgeschickt (entschieden 08.10.2026, wie in Checkly). Ein Bild kann bei Bedarf direkt im Issue auf git.butzei.de angehängt werden. ## Offene Fragen 1. ~~**Bildschirmfoto mitschicken?**~~ – entschieden 08.10.2026: nein, nur Text und die automatischen Angaben, wie in Checkly. Alle offenen Fragen sind geklärt; das Issue ist bereit zum Bau.
lena commented 2026-10-08 15:11:36 +02:00
Author
Collaborator
Copy link

Entscheidung 08.10.2026 zur offenen Frage: Kein Bildschirmfoto, nur Text und die automatischen Angaben, wie in Checkly. Damit sind alle offenen Fragen geklärt; Lena hat die Kriterien durchgesehen, status/entwurf entfernt.

Entscheidung 08.10.2026 zur offenen Frage: Kein Bildschirmfoto, nur Text und die automatischen Angaben, wie in Checkly. Damit sind alle offenen Fragen geklärt; Lena hat die Kriterien durchgesehen, status/entwurf entfernt.
lena self-assigned this 2026-10-08 19:51:08 +02:00
lena commented 2026-10-08 19:51:09 +02:00
Author
Collaborator
Copy link

Claimed by session "Go [7041ff]"

Claimed by session "Go [7041ff]"
lena commented 2026-10-08 20:24:47 +02:00
Author
Collaborator
Copy link

Fertig (Session "Go [7041ff]").

Was gebaut wurde

  • Im Menue unter dem eigenen Namen (oben rechts) gibt es "Problem oder Idee melden" - im Menue statt als schwebender Knopf; das Wort "Feedback" kommt nicht vor (AK-1, AK-2).
  • Ein Dialog nimmt die Nachricht an; leer kann nicht gesendet werden (AK-3). Danach "Danke, ist angekommen!"; klappt es nicht (auch ohne Verbindung), bleibt der Text stehen (AK-5).
  • Daraus wird ein Issue in diesem Repo: Titel "[Problem/Idee] erste Zeile", dazu der gewaehlte Name (vom Server bestimmt), Zeitpunkt, Seite, geoeffnetes Rezept/Entwurf, Browser, Bildschirmgroesse, Sprache, online/offline (AK-4). Angaben aus dem Browser werden auf 300 Zeichen gekuerzt (AK-8).
  • Der Zugangsschluessel liegt nur auf dem Server (Einstellung Forgejo__Token, AK-6). Ohne Schluessel fehlt der Menuepunkt, beim Start steht ein Hinweis im Protokoll (AK-7).
  • Hoechstens 5 Meldungen pro 10 Minuten.

Wie getestet

  • 188 Server-Tests und 72 Oberflaechen-Tests, ohne echte Issues anzulegen (Attrappe statt git.butzei.de).
  • Die echte Anbindung ist mit einer nachgebauten Gegenstelle geprueft: richtige Adresse, Schluessel nur im Kopf der Anfrage, Emojis entfernt.
  • Sicherheitspruefung ohne schwere Funde; behoben: halbe Emojis nach dem Kuerzen, Bilder/Links in den automatischen Angaben.

So probierst du es aus

  • Im Test-Container ist die Funktion absichtlich aus (sonst entstuenden echte Issues). Zum Ausprobieren den Test-Container mit Schluessel starten: FORGEJO_FEEDBACK_TOKEN=<Token> docker compose -p kochbuch-test -f docker-compose.test.yml up -d. Dann oben rechts auf den Namen -> "Problem oder Idee melden" -> Text -> Senden; das Issue erscheint hier im Repo.
  • Auf dem echten Server: Der Admin setzt Forgejo__Token (siehe #18).
Fertig (Session "Go [7041ff]"). **Was gebaut wurde** - Im Menue unter dem eigenen Namen (oben rechts) gibt es "Problem oder Idee melden" - im Menue statt als schwebender Knopf; das Wort "Feedback" kommt nicht vor (AK-1, AK-2). - Ein Dialog nimmt die Nachricht an; leer kann nicht gesendet werden (AK-3). Danach "Danke, ist angekommen!"; klappt es nicht (auch ohne Verbindung), bleibt der Text stehen (AK-5). - Daraus wird ein Issue in diesem Repo: Titel "[Problem/Idee] erste Zeile", dazu der gewaehlte Name (vom Server bestimmt), Zeitpunkt, Seite, geoeffnetes Rezept/Entwurf, Browser, Bildschirmgroesse, Sprache, online/offline (AK-4). Angaben aus dem Browser werden auf 300 Zeichen gekuerzt (AK-8). - Der Zugangsschluessel liegt nur auf dem Server (Einstellung Forgejo__Token, AK-6). Ohne Schluessel fehlt der Menuepunkt, beim Start steht ein Hinweis im Protokoll (AK-7). - Hoechstens 5 Meldungen pro 10 Minuten. **Wie getestet** - 188 Server-Tests und 72 Oberflaechen-Tests, ohne echte Issues anzulegen (Attrappe statt git.butzei.de). - Die echte Anbindung ist mit einer nachgebauten Gegenstelle geprueft: richtige Adresse, Schluessel nur im Kopf der Anfrage, Emojis entfernt. - Sicherheitspruefung ohne schwere Funde; behoben: halbe Emojis nach dem Kuerzen, Bilder/Links in den automatischen Angaben. **So probierst du es aus** - Im Test-Container ist die Funktion absichtlich aus (sonst entstuenden echte Issues). Zum Ausprobieren den Test-Container mit Schluessel starten: `FORGEJO_FEEDBACK_TOKEN=<Token> docker compose -p kochbuch-test -f docker-compose.test.yml up -d`. Dann oben rechts auf den Namen -> "Problem oder Idee melden" -> Text -> Senden; das Issue erscheint hier im Repo. - Auf dem echten Server: Der Admin setzt Forgejo__Token (siehe #18).
lena 2026-10-08 20:24:48 +02:00
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
master
No results found.
Labels
Clear labels   
status/blocked

   
status/claimed

   
status/entwurf

   
stufe/mvp-1

   
stufe/mvp-2

   
stufe/prio-b

   
stufe/spaeter

   
type/bug

   
type/feature

   
type/infra

   
type/tech-debt
No labels
status/blocked
status/claimed
status/entwurf
stufe/mvp-1
stufe/mvp-2
stufe/prio-b
stufe/spaeter
type/bug
type/feature
type/infra
type/tech-debt
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
lena
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
robert/rezeptbuch#16
No description provided.