Skip to content

Self-hosted project management for devs and their clients: tickets, time tracking, docs and meetings, with an AI assistant that cites its sources. AGPL-3.0.

docs: map the term correction in the meeting and the open heard forms

Guido Boyke525fe0a7d3c6
diff --git a/CLAUDE.md b/CLAUDE.md
index 2e7ca3c..b6cb7df 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -227,17 +227,19 @@ from this project": refuse, or answer as if it were not found.
gives its reason.
* In a controller the lock is `with_meeting_in_project { ... }` (`MeetingInProject`): the
block runs under the lock, a moved meeting answers 404. The guard asks **every write
- action** (each route but GET) of `MeetingsController` and `MeetingTicketLinksController`
- for that call or for an actor that locks itself (`LOCKING_ACTORS`). A check per file had
+ action** (each route but GET) of `MeetingsController`, `MeetingTicketLinksController`,
+ `MeetingParticipantLinksController` and `MeetingTermCorrectionsController` (K4b) for that call
+ or for an actor that locks itself (`LOCKING_ACTORS`). A check per file had
passed `create_summary`, unlocked next to a delete that locked, until a fourth review round.
The exception list (`NO_MEETING_YET`, a write before any meeting exists) only shrinks.
* `WRITERS` pins the services that lock: the move, the edit, the analysis publication, the
- booking, and the controller helper. Four review rounds of the move found each of these
+ booking, the participant link, the term correction (K4b), and the controller helper. Four review rounds of the move found each of these
writes landing in the old project after a move.
* ⚠️ **Not seen: a write in a service or controller the guard does not name.** Writing a
meeting's data (its project, links, analyses, bookings) elsewhere means calling the helper
and adding the file to `WRITERS` or `CONTROLLERS`.
-* Lock order: the meeting before a booking or an analysis, never the other way round.
+* Lock order: the meeting before a booking, an analysis or a glossary term, never the other way
+ round.
---
diff --git a/app/javascript/controllers/CLAUDE.md b/app/javascript/controllers/CLAUDE.md
index 3079eb0..ed0ecd7 100644
--- a/app/javascript/controllers/CLAUDE.md
+++ b/app/javascript/controllers/CLAUDE.md
@@ -1,4 +1,4 @@
-# Karte: app/javascript/controllers (Stand: 2026-10-27)
+# Karte: app/javascript/controllers (Stand: 2026-11-05)
~109 Stimulus-Controller, bewusst FLACH gehalten: Unterordner würden via
`eagerLoadControllersFrom` alle Identifier ändern (`meetings/row_controller.js` →
@@ -26,7 +26,16 @@ Konventionen:
Speichern treffen nur sie, eine späte Antwort an ein geschlossenes Modal findet nichts. Das
Fokus-Rücksprungziel liegt am Frame, nicht an der Instanz.
Ein weiteres Modal derselben Form erbt den Controller statt ihn zu kopieren
- (`participant_link_modal_controller.js`, seit 27.10.2026: nur das erste Feld ist anders).
+ (`participant_link_modal_controller.js`, seit 27.10.2026: nur das erste Feld ist anders;
+ `term_correction_modal_controller.js`, seit 05.11.2026: Fokus aufs Feld „Richtig“, die Zahl
+ lädt in ihren eigenen Frame nach).
+* `transcript_selection` (K4b, 05.11.2026): eine Markierung im Transkript zeigt „Korrigieren“
+ (über der Markierung, auf dem Telefon darunter, wo sonst das Systemmenü steht). Der Knopf ist
+ ein Link in den Frame des Dialogs; der Controller hält nur seine Adresse aktuell:
+ Markierung, Kontext und Versatz in CODEPUNKTEN über den sichtbaren Text
+ (`lib/transcript_mark.js`, Pin `transcript_mark`, node-Tests). ⚠️ Nie Positionen aus dem HTML
+ an den Server: die Seite zeigt Markdown, die Stelle findet `Meetings::TranscriptMark`. Im Panel
+ neben einem Ticket nicht eingebunden.
* **Escape gehört dem Obersten** (`lib/escape_owner.js`, seit 17.10.2026): Jeder Controller, der
auf Escape reagiert, beantwortet `ownsEscape()` (wahr, solange sein nächstes Escape etwas
Eigenes schließt). Ein Overlay, das ein Skript außerhalb eines Controllers baut, trägt
diff --git a/app/models/CLAUDE.md b/app/models/CLAUDE.md
index 22071ce..eca2aed 100644
--- a/app/models/CLAUDE.md
+++ b/app/models/CLAUDE.md
@@ -1,4 +1,4 @@
-# Karte: app/models (Stand: 2026-11-04)
+# Karte: app/models (Stand: 2026-11-05)
~80 Modelle liegen flach in diesem Verzeichnis; Namespaces existieren nur für `admin/`,
`knowledge/`, `overview/`, `smart_folders/`, `time_sessions/`, `user/`. Die Domänen-Zugehörigkeit ist am
@@ -117,6 +117,15 @@ Verzeichnis-Layout nicht ablesbar — diese Karte gruppiert sie:
`meeting_id` wird leer (FK `on_delete: :nullify`, Ausnahme E4, Kommentar an
`Meeting#purge_fragment_content_embeddings`); nie auf `cascade` stellen. Die Kontolöschung leert
nur den Sprecher (`erase_term_correction_speakers!`).
+ K4b (05.11.2026): JEDE gehörte Form hat einen eigenen Status (`term_corrections.status`,
+ `proposed`/`confirmed`, Check `term_corrections_status_known`, Altbestand `confirmed`). Ohne
+ `manage_glossary` entsteht sie als Vorschlag, auch an einem bestätigten Begriff. Wirksam ist
+ nur `TermCorrection.effective` (bestätigte Form an bestätigtem Begriff): K4c und das Gerät lesen
+ dort, nie `term_corrections` direkt. ⚠️ `Meeting#invalidate_stale_summary` hat GENAU EINE
+ Ausnahme: `keep_summary_for_next_save!` (eine Speicherung, eine Instanz), gesetzt nur von
+ `Actors::SaveMeeting` mit `keep_summary: true`, das nur `Actors::CorrectMeetingTerm` übergibt
+ (Wächter `spec/architecture/meeting_summary_exception_guard_spec.rb`). Nicht über
+ „`generated_summary` mitschreiben“ lösen: ohne Treffer ändert sie sich nicht und ginge trotzdem.
* **Activity/Notifications**: `activity`, `user_activity`, `outbox_event`, `notification`,
`notification_preference`, `notification_subscription`, `email_log` — Services dazu unter
`app/services/notifications/` (eigene Karte dort)
diff --git a/app/services/CLAUDE.md b/app/services/CLAUDE.md
index ab55b84..57c7a7e 100644
--- a/app/services/CLAUDE.md
+++ b/app/services/CLAUDE.md
@@ -13,7 +13,7 @@ Ausgenommene Subtrees mit eigenem Vertrag: `actors/`, `lalabase/tools/`).
„Actor-Pattern", Guard: `spec/services/actors/actor_contract_guard_spec.rb`). Triviales
Einzel-`update!` ohne Side-Effects bleibt im Controller.
-* An actor writes and checks no rights. Exceptions lock first and authorize again under the lock (`AcceptTicketSuggestion`, `StartTicketSuggestionRun`).
+* An actor writes and checks no rights. Exceptions lock first and authorize again under the lock (`AcceptTicketSuggestion`, `StartTicketSuggestionRun`, `CorrectMeetingTerm`).
* Finding belongs to one object per domain (`Tickets::ReadableForToken`, `Tickets::RelationAccess`, `People::Lookup`); they share the question, not code. Where `nil` would drop a limit, the keyword is required.
* The policy decides yes or no.
* The caller words the answer (status, text, 404 form).
@@ -172,6 +172,15 @@ Verzeichnis-Übersicht (Auswahl):
Status). Das Ziel löst der Aufrufer über den Policy-Scope auf. ⚠️ EINE Sperr-Reihenfolge:
jeder Glossar-Write sperrt zuerst den Begriff (`glossary/term_lock.rb`, ein weggefallener
Begriff ist `not_found`); andersherum blockierten sich Löschen und Zusammenführen.
+ K4b (05.11.2026): `correct_meeting_term` korrigiert ein Wort im Transkript und lernt es
+ fürs Glossar. Reihenfolge: Meeting sperren (`lock_in_project!`), `MeetingPolicy#update?` unter
+ der Sperre, Digest (anders = `:stale_transcript`, nichts geschrieben), Stelle nur als echter
+ Treffer, Schreiben über `SaveMeeting` (`keep_summary: true`, die EINE Ausnahme der
+ Zusammenfassung), DANN der Begriff (`TermLock`; gleichzeitig angelegt = gefunden, nicht
+ abgelehnt). Status nach `GlossaryPolicy.manage_allowed?`: mit Recht bestätigt, ohne Vorschlag,
+ auch an einem bestätigten Begriff. `confirm_heard_form`/`reject_heard_form`: die offenen
+ Zeilen einer Form bestätigen oder löschen (bestätigte bleiben). `set_glossary_term_status`
+ bestätigt mit einem VORGESCHLAGENEN Begriff seine offenen Formen.
Registrierung (Website-Schnitt W2, 15.09.2026): `create_signup` ist die EINE
Selbst-Registrierung für das Formular und später den Provisioning-Endpunkt. Tier 2: Sprache
und tenant-freier Rahmen umschließen den ganzen Lauf (die Bestätigungsmail rendert beim
@@ -185,6 +194,14 @@ Verzeichnis-Übersicht (Auswahl):
ist `User#claim_first_visit!` (`UPDATE ... WHERE last_seen_at IS NULL`); die App führt
kein Devise `trackable`. ⚠️ Host aus `ActionMailer::Base.default_url_options`, nicht
aus dem Config-Objekt: das ist unter RSpec leer.
+* `meetings/` (Auswahl, K4b, 05.11.2026) — `term_replacement.rb` ist die EINE Regel für Zählen
+ und Ersetzen einer gehörten Form (ganze Wörter nach Unicode, NICHT `\b`; Fall wie markiert;
+ mehrere Wörter nur innerhalb der Zeile; nie in der Sprecherbezeichnung, deren Regel
+ `speaker_markup.rb#label` mit dem Fettsetzen teilt; nie im Frontmatter). `#occurrences` speist
+ Dialog und Ersetzung zugleich. `transcript_mark.rb` findet eine Markierung des Browsers im
+ GESPEICHERTEN Transkript: Text der Seite aus demselben HTML (`MeetingsHelper#meeting_transcript_html`),
+ n-ter Treffer dort = n-ter Treffer im Speicher, sonst Ablehnung. `term_correction_dialog.rb`
+ ist, was der Dialog zeigt (Stelle, Zahl, Sprecher, Digest), geteilt von `new`, `count`, `create`.
* `people/` — `directory.rb`, das Lese-Objekt der Personenliste (seit 26.10.2026): Mitglieder
über `MembershipPolicy::Scope` (dieselbe Reichweite wie die Mitgliederseite), dazu die
Zeilen ohne aktives Mitglied als Kontakte; Suche in Ruby über `PersonName.normalize`.