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.
Ruby agplai-assistantdockerdsgvogdprhotwireissue-trackerjira-alternativeknowledge-basellmmcp-servermeeting-notesopen-sourceproject-managementredmine-alternativeruby-on-railsself-hostedticketingtime-tracking
docs: map the term correction in the meeting and the open heard forms
Guido Boyke525fe0a7d3c6
diff --git a/CLAUDE.md b/CLAUDE.mdindex 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`): theblock 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 hadpassed `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 thesewrites landing in the old project after a move.* ⚠️ **Not seen: a write in a service or controller the guard does not name.** Writing ameeting's data (its project, links, analyses, bookings) elsewhere means calling the helperand 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.mdindex 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. DasFokus-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, derauf Escape reagiert, beantwortet `ownsEscape()` (wahr, solange sein nächstes Escape etwasEigenes schließt). Ein Overlay, das ein Skript außerhalb eines Controllers baut, trägtdiff --git a/app/models/CLAUDE.md b/app/models/CLAUDE.mdindex 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 leertnur 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.mdindex 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`). TrivialesEinzel-`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 weggefallenerBegriff 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 EINESelbst-Registrierung für das Formular und später den Provisioning-Endpunkt. Tier 2: Spracheund 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ührtkein Devise `trackable`. ⚠️ Host aus `ActionMailer::Base.default_url_options`, nichtaus 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 dieZeilen ohne aktives Mitglied als Kontakte; Suche in Ruby über `PersonName.normalize`.