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.
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 →
data-controller="meetings--row") — bei ~145 data-controller-Stellen in ERB zu viel Churn.
Die Domäne steckt im Dateinamen-Präfix (ticket_*, time_session_*, meeting*, neo_*).
Konventionen:
neo_*(~20 Stück) = Design-System-Controller (Pendants zu den Neo-ViewComponents). Unpräfixierte Controller sind Legacy bzw. feature-spezifisch.- Wiring läuft NUR über
data-controller-Attribute in ERB. Controller→View finden: nach dem Identifier grepen (Dateiname ohne_controller, Unterstriche → Bindestriche). Achtung: manche Mounts entstehen per Ruby-Array-Join — ein Literal-grep kann fälschlich „unused" melden. - Nach jedem Anlegen/Löschen/Umbenennen:
rails importmap:auto_pinausführen und committen (sonst bricht das Prod-Precompile). NIEMALSrails stimulus:manifest:updatedirekt — siehe Root-CLAUDE.md, „Critical Bug Fixes". - Guard:
spec/architecture/stimulus_controller_wiring_spec.rb(kein Mount ohne Controller-Datei). - Modals: IMMER zuerst
docs/dokumentation/modal_pattern.mdundREADME_MODAL_PATTERN.md(hier im Ordner) lesen. Referenz-Implementierung istticket_relation_modal_controller.js(Fokusfalle überdialog_a11y, Schließen über Hintergrund und Escape, Fokus zurück an den Auslöser).meeting_modal_controller.jsist seit 17.10.2026 gelöscht („Neues Meeting“ auf „Alle Meetings“ öffnet in der Bahn),time_session_modal_controller.jsseit 16.09.2026. Seine Form hat KEINEN gemeinsamen Scope mit dem Auslöser: das Modal ist der Inhalt eines Frames neben dem Abschnitt, beide Auslöser sind Links mitdata-turbo-frame, Verbinden heißt Öffnen, Schließen leert den Frame. Jede Öffnung trägt eine eigene ID (Token): Ablehnung und 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;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, Pintranscript_mark, node-Tests). ⚠️ Nie Positionen aus dem HTML an den Server: die Seite zeigt Markdown, die Stelle findetMeetings::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, beantwortetownsEscape()(wahr, solange sein nächstes Escape etwas Eigenes schließt). Ein Overlay, das ein Skript außerhalb eines Controllers baut, trägtdata-owns-escape. Die Bahn (layout-toggle) fragt das in der Capture-Phase aufwindow, bevor irgendein Listener lief, und schließt nur, wenn niemand antwortet. Bis dahin stand eine Selektor-Liste inlayout-toggle, und jedes vergessene Overlay schloss die Bahn DAHINTER. Wächter:spec/architecture/escape_owner_guard_spec.rb(auchkeydown.esc->in Templates; geschlossene ListeNOT_OWNERSmit Grund). ⚠️ EinownsEscape(), das wahr bleibt, obwohl nichts offen ist, hält die Bahn für immer offen: an den Zustand binden, den der eigene Escape-Handler prüft. neo_autosuggesthat zwei Modi: ohneurlfiltert er vorgeladene Optionen im Browser, miturlfragt er den Server; bestätigte Auswahl, Anfragenummer, Entprellen und Abbruch liegen inlib/autosuggest_search.js(Pinautosuggest_search, node-Tests).- ⚠️ Kein
#anker-Link auf einer Bahn-Seite: er legt einen History-Eintrag an, „Zurück" gilt dann als Bahn-Wechsel und lädt die Bahn neu (Kommentarentwurf weg), und der Hash wandert in Adressen, die auswindow.locationgebaut werden. Für Sprüngescroll_into_view(Knopf, scrollt und fokussiert, Adresse bleibt). - Bahn-Historie (
index_page+lib/lane/history.js): ein Eintrag mit ANDEREM Pfad gehört einer anderen Seite; Turbos eigenen stellt Turbo wieder her. Sonst brach „Link in Projekt B, Zurück" Turbos Besuch ab und lief in den 500-ms-Doppelklick-Schutz vonapplication.js.
Ähnlich benannte Controller — Analyse 2026-07-13 (KI-DX Slice 5), KEINE Duplikate:
toggle(generisches, umkehrbares Ein-/Ausblenden, Targetscontent/icon, 13+ Mounts) vs.neo_toggle(Form-Switch mit Visuals +relatedSelect/relatedInput) vs.reveal_more(EINWEG-Reveal: zeigt[data-more-item]unter seinem Element + blendet den Trigger aus, kein Zurückklappen) — drei verschiedene Zwecke.reveal_morespeist aus EINER Quelle das Projekt-„mehr …" der Sidebar (neo_sidebar_project_item_component) UND seit S5b (02.09.2026) die Stand-Tabelle der Zeitenliste, die Projekte ohne Zeiten faltet (time_sessions/_billing_overview_panel). Die Org-Nav (_navigation_application) nutzt ihn nicht mehr.clamp_toggleist der VIERTE aus dieser Familie und der einzige mit einer Vorschau: er kürzt einen langen Block auf eine Vorschauhöhe und klappt ihn wieder auf. Die Kürzungsklasse kommt über die Stimulus-Classes-API von außen, er ist also inhaltsneutral. ⚠️ Sein Markup nicht mehr von Hand verdrahten — seit 04.09.2026 gehört esNeo::MarkdownPreviewComponent(Transkript, Analyse-Vorschau, Ticket-Zusammenfassung). Er blendet den Knopf nur ein, wenn der Text die Kürzung wirklich überläuft; ein Block, der beimconnect()nicht messbar ist (clientHeight === 0, verstecktes Lane), behält Kürzung und Knopf.neo_price_interval(öffentliche Preisseite,doc/billing_preisliste_rabatt_plan.md§7.4) ist KEIN weiterertoggle: er blendet nicht ein Element auf/zu, sondern wählt eine von n Varianten anhanddata-interval— alle serverseitig gerendert, er flippt nurhidden. Die Seite ist ohne JavaScript vollständig; wer das als Ein/Aus nachbaut, verliert genau diese Eigenschaft.billing_form(Rechnungsformular,doc/billing_stammdaten_plan.md§9) ist ebenfalls KEIN weiterertoggle: er blendet nicht auf Knopfdruck etwas auf/zu, sondern leitet aus dem gewählten Land ab, welche Felder überhaupt gelten. Alle Listen und Subdivisionen kommen alsdata-*-Werte ausAccounts::BillingRulesund demcountries-Gem, nie als Kopie im JS. Setzt bewusst KEINrequired: das Formular muss vollständig leerbar bleiben (E3), verbindlich ist die Server-Validierung im:billing-Kontext.dropdown(Targetsmenu/button) vs.neo_dropdown(Targettrigger, auto-close-Value, Keyboard-Nav) — beide live. Für neuen Codeneo_dropdownbevorzugen;dropdown-Mounts opportunistisch migrieren (Boy-Scout). ⚠️ Ausnahme: eine Fläche, die ohne JavaScript vollständig bleiben muss.neo_dropdownblendet sein Menü per JS ein, ohne JS gibt es also gar kein Menü. Die Filterzeile der Zeitenliste (S7,time_sessions/_filter_pill) nimmt darum<details>+details_autoclose: der Zeitraumfilter war vorher neun Links und hätte sein Ohne-JS-Verhalten sonst verloren.details_autoclosehat seit S7 zwei Verbraucher: den Org-Umschalter der Navigation und jede Pille der Zeitenliste. Seinpanel-Target undrepositiongehören nur dem ersten (sie ankern an#sidebar); die Pillen mounten ihn ohne Target und nutzen nur „außen klicken" und Escape. Alles imreposition-Pfad prüfthasPanelTarget, das muss so bleiben.filter_menu_search(S7) filtert die bereits gerenderten Links EINES Pillen-Menüs nach getipptem Text. Reine Verbesserung: ohne JS listet das Menü einfach alle. Mount sitzt literal an jedem Menü, auch ohne Suchfeld — der Verdrahtungs-Zensus liest Mounts als Literale und sieht eine aus Ruby gebaute Bedingung nicht.project_cascadeist mit S7 gelöscht: sein einziger Mount war das Projekt-Auswahlfeld der Zeitenliste. Was er tat (Projektwechsel räumt beide Bezugs-Ids weg) steht jetzt in der Adresse jeder Menü-Option und gilt damit auch ohne JavaScript.slim_select(Wrapper um die SlimSelect-Lib) vs.neo_select— getrennte Zwecke.ticket_selection(08.09.2026,doc/ticket_bulk_edit_plan.mdScheibe 1): die Auswahl der Ticketliste. Zustand inlib/ticket_selection.js(Pinticket_selection, node-Tests), Mount UM Kopf und Listenrahmen in_index_desktop, rendert nach jedem Nachladen neu. ⚠️ Hörtturbo:frame-loadin der CAPTURE-Phase am Mount: auf der Ticketseite erreicht das Ereignis dasdocumentNICHT (gemessen 08.09.2026; jedes andere Frame-Ereignis schon). Damit sind auch diedocument-Listener vonfilter_bar(_hitsbleibt nach einem Nachladen auf dem alten Wert),column_pickerundkeyboard_navigationblind. Ursache ungeklärt, offener Befund, eigener Strang.ticket_bulk_panel(Scheiben 3 und 4): das Panel in der Bahn, Gerüst vom Server, fügt die Änderungszeilen aus<template>s hinzu, holt den Bestand (bulk_summary.json) nach jeder Änderung der Auswahl und spricht mitticket_selectionüber Window-Ereignisse (:ready,:close,:draft,ticket-selection:change), weil Panel (Bahn-Rahmen) und Auswahl (Listenspalte) in verschiedenen Rahmen leben. Der Entwurf (lib/ticket_bulk_draft.js, Pinticket_bulk_draft, node-Tests) wird vonticket_selectionüber den Wechsel mit dem Ticket bewahrt.ticket_selectionfängt den Schließen-Knopf der Bahn in der Capture-Phase amdocumentab, solange eine Auswahl steht.execute(Scheibe 6) schickt Auswahl, Entwurf und Bestands-Digests als JSON anbulk_update(Adresse in der Query), rendert die Turbo-Stream-Antwort selbst (Turbo.renderStreamMessage) und meldet die geänderten Ids alsticket-bulk-panel:done;ticket_selection#afterRunmacht daraus die neue Auswahl. ⚠️ Turbo wendet einen Stream erst beim nächsten Repaint an: die Ids kommen aus dem Antworttext (runTicketIds), und die Häkchen der neuen Zeilen setztticket_selection#onStreamRenderüber denrender-Haken vonturbo:before-stream-render, nicht über einsetTimeout. Scheibe 7: die anderen Aktionen unter dem Knopf öffnen native<dialog>s im Panel (openMove/openDelete), holen die Zahlen perPOST bulk_impact(JSON-Body, wie seit Scheibe 7 auchbulk_summary: 200 Ids passen in keine Request-Zeile) und antworten wie ein Durchlauf;donemitclear: trueleert die Auswahl,ticket_selectionhält die Ergebniszeile ohne Auswahl bis zum ✕ (dismissResult).filter_barist die EINE Filterleiste (Reiter, Pillen, Speicherzeile; Zustand kommt aus der Adresse, Logik inlib/filter_bar/change_set.js). Die eingefrorene Kopiefilter_bar_legacysamtlib/filter_bar_legacy/und dem Nutzer-Flag ist am 07.09.2026 gelöscht.- Echte Duplikate/Leichen wurden 2026-07-13 gelöscht (
sort,search_clear,search_input,permission_radio,neo_grouped_notification,.disabled-Dateien) — der Census-Guard meldet neue.
Rich-Text (seit Paket 2 Inline-Bilder, 2026-08-23)
Lexxy ist der einzige Editor; Trix ist aus Importmap, JS und CSS verschwunden
(Guard: spec/views/no_trix_guard_spec.rb). Zwei Controller gehören dazu:
neo_rich_text_embedssitzt am<lexxy-editor>(Attribute ausRichTextEmbedsHelper#lexxy_embed_editor_options), hörtlexxy:file-acceptund prüft NUR neue Dateien gegen Typ und Größe ausRichTextEmbeds(lib/rich_text_embed_accept.js,node:test). Abgelehnte Dateien wandern in das Anhang-Feld des Formulars, das er über einen Selektor im umschließendenformfindet. ⚠️ Nie Lexxys eigenespermitted-attachment-typessetzen: Lexxy filtert damit auch beim LADEN und wirft Bestands-Attachments weg.neo_rich_text_zoomsitzt am Wrapper jedes gerenderten Rich-Texts (layouts/action_text/contents/_content.html.erb), nie am Bild: ActionText streichtdata-*aus den Attachment-Partials. Delegierter Klick aufa.attachment__zoom(lib/rich_text_zoom.js) öffnet ein natives<dialog>; ohne JS öffnet der Link die große Variante. Funktioniert in Turbo-Streams, weil der Listener am Wrapper hängt.neo_writing_surface(Paket 3) sitzt an der großen Ticket-Schreibfläche (tickets/_writing_surface.html.erb, gerendert inturbo-frame#writing_surfacevontickets#newund#edit; der leere Frame gehört dem Application-Layout, damit Liste, Dashboard UND Inbox-Pane ihn erreichen). ⚠️ Bewusst NICHTturbo-frame#modal:filter_bar_controllerbesucht die Seite nach jedem erfolgreichen Submit in#modalneu, und die URL trägt noch das vorher gewählte Ticket. Er kennt nur den Weg HINAUS ohne Speichern: Escape und Abbrechen schließen ein unverändertes Formular sofort, sonstwindow.confirm; Klick daneben schließt nie. „Verändert" ist ein Vergleich von FormData-Snapshots (lib/form_snapshot.js,node:test), flüchtige Felder wieauthenticity_tokenausgenommen. Speichern schließt nicht er, sondern der Turbo-Streamupdate('writing_surface', '')der Controller-Antwort.
Begleit-Panel des Assistenten (S3a T4, 2026-08-24)
Zwei Controller, ein Grund für die Trennung: das Panel liegt auf Body-Ebene (es muss, um
data-turbo-permanent zu sein und dem transform/overflow der Sidebar zu entkommen),
die Sidebar-Zeile liegt in der Navigation. Damit sind sie NICHT im selben Stimulus-Scope.
assistant_panelsitzt am permanenten Knoten#assistant_panel(layouts/_assistant_panel.html.erb). Turbo VERPFLANZT diesen Knoten bei jedem Drive-Besuch, deshalb gilt hier durchgehend: Zustand gehört auf den Knoten, nicht in die Instanz — die Stimulus-Values (open,width) tun genau das, weil sie Attribute sind. ⚠️disconnect()feuert bei JEDER Verpflanzung, nicht nur beim Abbau: dort nichts abräumen und vor allem nichts MESSEN (scrollTopliest dort 0, der Knoten hängt schon aus). ⚠️ Ein permanenter Knoten sieht die frisch gerenderte Fassung nie — serverseitige Änderungen an seinen Attributen kommen nicht an; der Weg vom Server dorthin ist die URL (?assistant_chat_id=,honourRequestedChat; ebenso?assistant=full,honourRequestedMode). Umgekehrt gilt dasselbe für den KOPF des Panels: er weiß nie, welchen Verlauf der Frame gerade zeigt. Deshalb ist „Frühere Verläufe" ein Knopf und kein Link —showHistoryliest die offene Id am Chat-Frame ab (#assistant-panel-chat[data-chat-id], gesetzt vonChatContainerComponent) und baut die Adresse selbst. ⚠️ Wer Zustand aus der URL übernimmt, MARKIERT die Adresse (dataset.honouredChat,dataset.honouredMode,dataset.honouredArtefact) — der Morph-Refresh besucht dieselbe URL erneut und macht sonst eine Nutzerentscheidung rückgängig. Wer sie SCHREIBT (publishArtefactAddress,replaceState), markiert sie im selben Zug.- Drei Zustände, EIN Knoten (S3c T2): Die Vollansicht ist eine KLASSE am selben Knoten
plus ein Grid darin, nie eine Seite — eine Seite nähme Entwurf, Bildlauf und laufenden
Stream mit. Das Raster aus
layout.cssist dafür unbrauchbar (lebt in<main>); Regeln incomponents/assistant_panel.css. - ⚠️ Ein Marker im Panel-Knoten ist NICHT eindeutig.
showHistoryfragt, ob die Verlaufsliste schon offen ist, und muss dafür den CHAT-FRAME fragen, nichtthis.element: seit T2 rendert die Verlaufs-Lane dieselbe Komponente mit demselbendata-assistant-historyim selben Knoten. Ein Ausflug in die Vollansicht lud die Lane, der Marker blieb danach im DOM (die Lane ist nurdisplay:none), und der Uhr-Knopf tat bis zum nächsten Neuladen nichts mehr. In PRODUKTION gefunden, nicht im Test. Wer hier einen Marker oder eine Id sucht, fragt die Fläche, die ihn besitzt. showSettings(Zahnrad, 30.08.2026) ist derselbe Bau wieshowHistory: dritter Zustand des Chat-Frames (?settings=1),data-assistant-settingsals Marker, und der offene Verlauf reist als?current=mit, damit der Rückweg dort landet, wo das Zahnrad gedrückt wurde. Ohne diesen Parameter fällt der Rückweg auf die Panel-Vorgabe, also den NEUESTEN Verlauf. ⚠️ Ein Test dagegen ist nur dann echt, wenn der Ziel-Verlauf nicht selbst der neueste ist: sonst ist der Rückfall vom Rückweg nicht zu unterscheiden (gemessen,spec/system/assistant_panel_spec.rb).- Die Artefakt-Lane (S3c T3) ist die dritte Spur, sichtbar nur wenn BEIDE Klassen
stehen (
assistant-panel--full+assistant-panel--artefact). Ein einziger delegierter Klick-Handler (handleClick) entscheidet beides: ein Link mitdata-assistant-artefactöffnet in der Vollansicht die Lane statt zu navigieren, und jeder Link, der das Panel VERLÄSST, klappt vorher auf die Begleitspur zurück — sonst lädt die Seite hinter einem bildschirmfüllenden Panel und der Klick sieht folgenlos aus (der Defekt, mit dem T2 lief). Links, die einen Frame IM Panel adressieren (data-turbo-frame="assistant_panel_body"), sind davon ausgenommen. ⚠️ Der Frame-srcwird IMMER aus dem eigenen Endpunkt (artefactSrcValue) plus Query gebaut, nie aus einem Adress-Wert als Ganzem. ⚠️handleClicksteigt bei ⌘/Strg/Shift/Alt undbutton !== 0sofort aus. Beide Zweige lägen sonst falsch:preventDefault()verschluckt den neuen Tab, und die Rückklappe faltet das Panel weg, obwohl Turbo modifizierte Klicks selbst ignoriert und die Seite gar nicht navigiert. Dasselbe für#-Anker undmailto:/tel:. - ⚠️
turbo_stream.updatefeuert KEINturbo:frame-load. Das Kontext-Angebot (S4 T2 Schritt 5b) muss wissen, welchen Gegenstand die Seite gerade zeigt, und ein Frame-Load-Listener beantwortet das fast nie:#ticket_display_framehat ACHT Schreiber, und genau einer davon (list_row_controller, setzt einesrc) ist ein Load. Der Rest sind Streams, dazu zwei Stellen, dieinnerHTMLdirekt zuweisen (turbo_cache_controller, und der Kanban-Ausklapper beim Schliessen) und damit gar nichts feuern. Drei Defekte im Review liefen auf diese eine Tatsache hinaus. Deshalb einMutationObserver— auf<main>, nicht aufdocument.body: das Panel ist ein Geschwister von<main>, und eine laufende Antwort schreibt den Verlauf pro Token neu, ein body-weiter Beobachter liefe also während jeder Antwort sechzigmal pro Sekunde. - Das Angebot liegt im FRAME, nicht mehr in der Hülle (27.08.2026). Sein Markup ist
Neo::Chat::ContextOfferComponent, gerendert vonChatContainerComponent, und zwar NUR fürPANEL_FRAME_ID: es steht jetzt direkt über der Zeile, deren Bezug es setzen will, weil es unten am Panelrand niemand ansah. Der Preis dafür steht oben: was der Client inassistant_panel_bodyschreibt, ist beim nächsten Frame-Load weg. Beantwortet wird das am Ladeereignis selbst,handleChatFrameLoadfragt danach erneut, und zwar ZWEIMAL: sofort und im nächstenrequestAnimationFrame. Stimulus findet die Targets eines frisch getauschten Teilbaums über einenMutationObserver, also einen Microtask NACHturbo:frame-load; der erste Aufruf redet unter Umständen noch mit dem abgehängten Knoten. Seit 10.09.2026 rendert auch der Empty State das Angebot. Ohne gespeicherten Verlauf landen angenommene Bezüge inDraftReferencesComponentals sichtbare Chips und versteckte Formularfelder (chat[reference_keys][]). Der permanente Panel-Knoten erhält diese Auswahl bei Navigation; „Neuer Chat“ tauscht das Formular aus und leert sie.Actors::SaveChatprüft die Sammlung überTools::Scope#referencesund speichert sie mit der ersten Nachricht, bevor der Antwort-Job startet. Fehler rendern die Nachricht samt weiterhin lesbaren Bezügen erneut. Während des Sendens sperrt der Controller die Auswahl und weitere Submits. Bei einer Turbo-Stream-Antwort bleibt das alte Formular bis zum Austausch gesperrt:submit-endkann vor dem Lesen des Antworttexts feuern.offerTargetConnectederneuert das Angebot auch nach einem Stream-Austausch. Verlaufsliste und Einstellungen rendern weiterhin kein Angebot. chat_scroll_controllerhat zwei Akte, und der zweite ist neu (27.08.2026): der Sprung (die eigene Frage an den oberen Rand) und danach das FOLGEN, das das Ende des Verlaufs sichtbar hält, während die Antwort Token für Token hereinkommt. Beide sind nur durch dasturbo:submit-enddes eigenen Composers scharf, nie durch einen Broadcast. ⚠️ Dass der Leser selbst gescrollt hat, wird OHNE Scroll-Listener erkannt: ein programmatischer Bildlauf feuert dieselben Ereignisse wie ein echter, eine gemerkte Position unterscheidet die beiden. Der Sprung ist darum bewusst NICHT smooth: ein laufender Smooth-Scroll hätte keine verlässliche Bezugsposition, und das Folgen würde ihn überschreiben (eine frühere SchonfristJUMP_SETTLE_MSgibt es nicht mehr).- Das Ende beim Öffnen (10.09.2026) gehört dem PANEL-Controller, nicht dem
Scroll-Controller:
showTranscriptEndläuft inopen()und beiturbo:frame-loaddes Chat-Frames. ⚠️ Nicht inconnect()des Scroll-Controllers: der feuert bei jeder Verpflanzung und würde die Leseposition überschreiben, dierestoreTranscriptScrollgerade zurückgeholt hat. Ein Seitenwechsel bei offenem Panel behält die Position, jedes Öffnen und jeder Verlaufswechsel zeigt das Ende. Steht eine Antwort noch aus, lädt der Resync den Frame beim Seitenwechsel ohnehin neu, und der frische Verlauf zeigt dann ebenfalls das Ende (gemessen: ein Verlauf, dessen letzte Blasedata-answer-pending="true"trägt, wird bei jedem Besuch neu geholt). - ⚠️ Der permanente Knoten stirbt auf jeder Seite OHNE Organisation (Org-Wechsler,
Kontoseiten, Admin,
/hilfe):assistant_available?verlangtcurrent_organisation, also rendert das Layout das Panel dort nicht und Turbo verpflanzt nichts. Die Listener aufdocument/windowsterben aber nicht mit, sie halten die tote Instanz samt abgehängtem Teilbaum am Leben, einer mehr pro Rundreise.disconnect()kann das nicht aufräumen (eine Verpflanzung feuert es auch), deshalb melden sich die Listener selbst ab (releaseIfGone) — und erst nach einer ZWEITEN Frage in einer späteren Task, weil eine Verpflanzung den Knoten kurz aus dem Dokument nimmt. - ⚠️ Für das Ergebnis eines Chip-Schreibens gibt es kein Ereignis.
turbo:submit-endfeuert, bevor der Stream die Chip-Zeile ersetzt hat, und ein Div-Tausch ist kein Frame-Load. Wer dort zu früh aufräumt, bietet das gerade gesetzte Ticket erneut an; wer nie aufräumt, lässt das Ticket für die Lebensdauer des Tabs verstummen.settleAfterScopeWritewartet deshalb, bis die Zeile sich WIRKLICH ändert, mit einem Frame-Budget als Rückfall für den Fall, dass sie unverändert zurückkommt — was genau die Form einer Ablehnung ist. - Der Bezug ist eine SAMMLUNG, und ihre Vokabel ist der Schlüssel
<Typ>:<uuid>(Bezugs-Sammlung S1, 27.08.2026,doc/assistent_bezug_sammlung_plan.md§7.1/§8.3). Derselbe Wert im URL-Segment, im Formularfeld, indata-reference-keysam Chip und indismissedContexts/refusedContexts/pendingContext; Meeting-Einstiege führen daneben ihre noch nicht erfüllte Absicht inpendingMeetingIntents. Zusammengesetzt wird der Schlüssel an genau zwei Stellen:assistant_trigger#adoptaus seinen beiden Values, undpageContext()ausdata-assistant-contextplusdata-assistant-context-type. Beide Attributsätze schreibt auf der Server-Seite EIN Besitzer,AssistantContextHelper(assistant_context_attributesfür den Marker,assistant_trigger_attributesfür den Knopf), seit Wissen sie neben den Tickets rendert (10.09.2026,doc/assistent_wissen_kontext_plan.md). ⚠️pageContext()überspringt Marker in einer GESCHLOSSENEN Bahn (.layout.hide-content): das ✕ blendet die Spalte per Klasse aus und lässt den Inhalt stehen, sonst bliebe die eben geschlossene Notiz im Angebot. Deshalb beobachtetobservePageContentneben der Kinderliste von<main>dasclass-Attribut des.layout-Knotens, und nur dieses.standingReferenceKeys()liest die ganze Zeichenkette (das ist es, wassettleAfterScopeWritevergleicht),standingKeySet()beantwortet die Mitgliedschaftsfrage. Geschrieben wird per POST auf.../assistant_chats/:id/references, entfernt per DELETE auf den Schlüssel. Eine Server-ABLEHNUNG landet inrefusedContexts(S2, §8.3), sonst entsteht mit der Obergrenze 10 eine Schleife: Klick, 422 „höchstens zehn", Angebot wieder da. Sie wird nicht aus einer unveränderten Zeile geraten, sondern nur aussuccess:falseMITfetchResponsedes eigenen Kontextformulars gelesen; ein Netzfehler darf den Bezug nicht für den Tab verstummen lassen.settleAfterScopeWritewartet trotzdem auf die wirklich gerenderte Chip-Zeile, bevor Angebot und Meeting-Absicht neu bewertet werden. ⚠️ Mehrere Scope-Schreiben können einander in Turbo abbrechen. Deshalb zähltcontextSubmissionsInFlightpro Schlüssel bereits VORrequestSubmit(): nur der letzte Settle darfpendingContextundpendingMeetingIntentslöschen oder den Modus aktivieren. assistant_triggerwirft ein Custom-Event aufwindow: neben dem Bezug trägt ein Meeting-Einstieg optionalanalysisoderticket-suggestionsals Absicht. Der Panel- Controller erfüllt sie erst, wennMeeting:<uuid>sichtbar in der aktuellen Sammlung steht. Ein zweiter Klick auf denselben fliegenden Bezug ersetzt nur die Absicht; ein erneutesrequestSubmit()würde Turbos erste Übernahme abbrechen.- ⚠️ Solange eine solche Meeting-Absicht auf die Bezugsübernahme wartet, hält
guardPendingMeetingIntentSubmitausschließlich das Nachrichtenformular an. Andere Formulare im Panel — Vorschläge übernehmen/verwerfen, Lauf wiederholen, Chip oder Chat löschen — bleiben bedienbar. Der Guard lauscht in der Capture-Phase, zeigt seinenrole="alert"-Status ausComposerComponentin neuem UND bestehendem Chat und verhindert so, dass ein sichtbarer alter Aufgabenmodus versehentlich für Meeting A absendet, während der Einstieg für Meeting B noch geprüft wird. assistant_suggestion_composer(Meeting-Migration Schritt 3) ergänzt das vorhandene Nachrichtenfeld um einen sichtbaren, aufhebbaren Aufgabenmodus. Das versteckte Feldticket_suggestion_meeting_idträgt dessen Absicht;assistant_panelerhält es beim Frame-Abgleich zusammen mit dem Entwurf. Ziele kommen aus den übernommenen Meeting-Bezügen und einem berechtigungsgeprüften Endpunkt, nie aus der gerade geöffneten Seite. Ein ausdrücklicher Meeting-Einstieg wartet nur, solange genau der Fetch läuft, der dieses Meeting entscheiden kann. Nach einem Fehler fällt die Absicht weg, normale Nachrichten lassen sich wieder senden; der sichtbare Wiederholen-Knopf oder derselbe Einstieg lädt die Auswahl erneut.meeting_section_synchält gespeicherte Analysen und die gemeinsame Vorschlagsliste am geöffneten Meeting mit den Assistenten-Karten synchron.assistant:analyses-changedundassistant:suggestions-changedsind nur Hinweise: die Meeting-Seite lädt ihre eigene, berechtigungsgeprüfte Darstellung mitTurbo-Frame: meeting_display_frame, bündelt Ereignisse während eines laufenden Abrufs und versucht einen flüchtigen Fehler einmal erneut. Nur eine erfolgreiche Ticket-Übernahme trägtrefreshLinksund ersetzt im selben Abruf auch die Verknüpfungsliste; Start, Abschluss und Verwerfen lassen einen dort noch nicht abgesendeten Autosuggest-Entwurf stehen. Ein eingereihtes Ereignis darf dieses Flag auch dann nicht verlieren, wenn der erste Abruf fehlschlägt.assistant_suggestion_resultaktualisiert genau einen gespeicherten Lauf per HTTP, solange Panel, Dokument und Karte sichtbar sind und der Lauf aktiv ist (Backoff bis 30 Sekunden, bei 429 mindestens 60 Sekunden). Fertige Karten aktualisieren ausdrücklich oder beim Zurückkehren mit mindestens 60 Sekunden Abstand zum letzten Abruf. Wiederandocken setzt die Observer-Markierung zurück und löst keinen Abruf aus. Ein Server-Digest berücksichtigt Aktionsfehler, ignoriert aber wechselnde CSRF-Tokens. Vor dem Einsetzen einer Antwort prüft er die Sichtbarkeit erneut; wird die Karte während des Abrufs versteckt, bleibt siestaleund holt beim nächsten Anzeigen sofort nach.disconnectbricht den Request ab und entwertet über eine Generation alte Timer. Geschlossene Ergebnisflächen erhalten keine Inhalte. Der allgemeine Chat-Resync überspringt diese Ergebnisse, damit nicht zwei Polling-Wege denselben Auftrag aktualisieren.- Die Grenzen des lebenden Knotens stehen in
doc/persoenlicher_assistent_plan.md§7.7. Kurzform: Org-Wechsel und globale Suche sindturbo: false, undknowledge/index.html.erbträgt<meta name="turbo-visit-control" content="reload">— jeder dieser Wege ist ein Vollreload und tötet den Knoten samt getipptem Entwurf. Das Cookie (AssistantPanelState) stellt danach Geometrie und Offen-Zustand wieder her. Guard gegen die Rückkehr der TOTEN Attribut-Variante:spec/architecture/turbo_visit_control_guard_spec.rb.
Spaltenwahl der Ticketliste (07.09.2026, doc/spaltenwahl_plan.md)
column_pickersitzt am Wrapper der Ticketliste (tickets/index.html.erb) und erreicht von dort das Grid (Targetgrid, Klassecolumn-picker-open), das Panel (Neo::ColumnPickerComponent, außerhalb des Listen-Frames, überlebt jeden Reload) und den Auslöser in der Filterleiste ([data-column-picker-trigger], seit 20a/S2; er saß bis dahin im Tabellenkopf). Ob das Panel schwebt, entscheidetplacePanelund schreibt es alsdata-floatingan das Panel selbst — nicht der Stylesheet aus Klassen am Grid. Drei Aufgaben: öffnen/schließen (Escape, Klick außen; gleitet ein übercolumn-picker-enteringam Grid, einen Frame beim Öffnen, den ganzen Weg beim Schließen; schwebend sitzt das Panel 10 px neben der Liste,placePanel), die Passung messen (Listenbreite minus Nr. und Titel, ohne Auslöserzelle gegen die Mindestbreiten in Rangfolge,data-fitam<table>, Grenzlinie im Panel an dieselbe Stelle; neu bei jedem Resize der Listenspalte und jedem Frame-Load) und jede Änderung sofort speichern (User 07.09.2026: kein Entwurf): PATCHcols[]an dencolumns-Endpunkt des Ordners oder der Grundansicht, dannframe.reload(). Nur „für alle Ansichten übernehmen" ist ein eigener Schritt (Formular,fillApplyForm). Nicht änderbare Ansicht:editable=false, keine Haken. Reine Teile ohne Imports inlib/column_picker/fit.jsundorder.js(node:test). ⚠️applyFitliest die Mindestbreiten aus den Panel-Zeilen (data-min), ohne Panel aus denth[data-col-min]; beide kommen ausViewConfiguration::COLUMN_MIN_WIDTH_PX.table_config,view_config_modalundfilter_bar_legacysind gelöscht (07.09.2026): sie bedienten die Legacy-Filterleiste und ihr Ein-Listen-Modal, und mit dem Flagnew_filter_bar?ist beides weg.smart_folder_displayist ebenfalls gelöscht (der Spaltenabschnitt des Expertenformulars ist weg, D8).
lane_split(Tickets UND Wissen seit 10.09.2026, Schlüssel je Kontext) — die Grenze zwischen Liste und Detailbahn, gezogen am Griff auf der Trennlinie. EIN Wert besitzt sie:--list-splitam Grid, gelesen von der Spur UND vom Griff, damit der Griff nicht von der Kante wegläuft, die er verschiebt. Gespeichert als ANTEIL (localStorage, je Bereich), angewendet in Pixeln: eine gemerkte Pixelbreite vom großen Monitor lässt auf dem Notebook eine handygroße Liste übrig.list_row(bis 10.09.2026ticket_row;knowledge_rowist darin aufgegangen,doc/wissen_als_bahn_plan.mdS2) sitzt auf der Ticket-Tabellenzeile, der Board-Karte UND der Wissen-Zeile: ein Controller, drei Mounts. Values:url(die DETAIL-Adresse, die der Frame lädt),id,param(der eigene Auswahlparameter),params(ALLE der Seite, sie schließen sich aus),frame,navigate(Meeting-Treffer verlassen die Seite). Die Adresslogik ist rein inlib/list_row/address.js(node:test). Die eine Markierung heißt.selected-row(Server-Zeile und Client gleich). Die Adresse ist die Wahrheit (Index +ticket_id, gebaut ausdata-index-urlam Container, gefunden perclosest), und jedes Element markiert sich aufconnectselbst aus der Adresse; darum überlebt die Tönung jeden Karten- oder Board-Tausch ohne „nach X neu anwenden".index_pagenormalisiert den Deep-Link/tickets/:idbeim Laden auf diese Adresse (D7).kanban_boardöffnet nichts mehr (keinopenTicket); er zieht, hält die Pfeile über einenResizeObserveraktuell und scrollt die gewählte Karte per Rechtecken ins Bild (revealSelected, niescrollIntoView).kanban_ticket_modalist gelöscht. ⚠️turbo:frame-loadhört das Board in der Capture-Phase amdocument, aus dem Grund oben beiticket_selection. ⚠️ Die Doppel-Sperre inapplication.jsschlüsselt seitdem auf Methode + Ziel-Frame, nicht nur auf die Adresse: der Reload-GET des Boards nach „+ Ticket" wäre sonst im 500-ms-Fenster verschluckt worden.- Bahn einer fremden Liste (17.10.2026, „Alle Meetings“, PR 3): die Übersicht zeigt das
Meeting eines Projekts in ihrer Bahn.
layout_toggle#syncFilterContextgibt den Listenzustand nur Links und Formularen unter dem Index der Seite (data-index-url) UND unter dem Index, den der Kopf der Bahn nennt (data-lane-index-url, Regel inlib/lane/filter_context.js, node:test). Ohne den zweiten behielten Bearbeiten und Speichern den Filter vom Öffnen. Ein Löschen in der Bahn schicktcloseLane(application.js):layout_toggle#closeLaneschließt und nimmtmeeting_idim SELBEN Eintrag aus der Adresse.list_addressist gelöscht, die Übersicht hat wie die Projektseite EINEN Adress-Schreiber (layout_toggle#syncUrlFromFrame). Dazu hängtsyncFilterContextden WertlaneContext(bei der Übersicht{"list_context":"organisation"}) an jede Anfrage der fremden Bahn, auch an Links aus Broadcasts und Abschnitts-Aktualisierungen, die ohne Kontext gerendert wurden. Sonst lädt ein Klick auf „aktualisieren“ die Bahn im Projektmodus, und das nächste Speichern zeichnet die Liste der Übersicht nicht neu. Die Adresse nennt nur, was der Server geöffnet hat: einemeeting_id, die er nicht auflösen konnte, oder einnew, das er nicht gerendert hat, steht inunresolvedSelection(Name und Wert,meeting_list_page_data).layout_toggle#dropUnresolvedSelectionnimmt sie beim Verbinden aus der Adresse, bevorhasSelection()undindex-pagesie lesen. Sonst öffnet ein gelöschtes oder fremdes Meeting eine leere Bahn.
Mobile Anwendung (PR #807)
mobile_shell bedient den Projektwechsel (erst beim Öffnen als Lazy-Frame geladen),
Kopfwerkzeuge und Auswahlkopf. neo_mobile_nav enthält die Organisationsziele und
wechselt im Auswahlmodus zur Aktionsleiste. mobile_ticket_list ergänzt die zentrale
ticket_selection um langes Antippen und den nativen Editor-Dialog. Das Ergebnis
bleibt während des Bearbeitens im Dialog und danach in der Liste, einschließlich Undo.
Die Grenze ist FULL_PAGE_BELOW_PX aus list_row/address (1024), nicht
MOBILE_BREAKPOINT (768) der älteren Listen. Nur Ticket-Anfragen erhalten die
Viewport-Kennung. Kopf und Fuß sind sticky; das Dokument scrollt.
viewport ist Darstellungszustand und gehört in ADDRESS_NOISE, nicht zum Filter.
Projekt-Dialoge vor dem Turbo-Cache schließen. Das mobile Assistentenblatt
schließt erst bei turbo:visit; Klicks, abgebrochene Bestätigungen und
Turbo-Stream-Schreibaktionen lassen es offen. Browser-Regressionen laufen in .github/workflows/guards.yml.
Beim ganzen Frame-Tausch schützt ticket_selection die bisherige Seitenauswahl
während event.detail.render bis nach dessen DOM-Callbacks. Ein Timer schon
vor dem Render läuft zu früh ab, weil Turbo bis zur nächsten Zeichnung warten kann.