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
Karte: app/models (Stand: 2026-11-06)
~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
Verzeichnis-Layout nicht ablesbar — diese Karte gruppiert sie:
- Kern/Tenancy:
organisation(= Tenant),project,user(+user/*— Split-Vertrag in den Kommentaren vonuser.rb, Include-Reihenfolge ist load-bearing!; Namens-Rendering hat EINEN Owner:user/name_display.rb; welche E-Mail andere sehen (Login-Adresse, Kontakt-Adresse oder keine,email_visibility) EINEN Owner:user/email_display.rb(#shown_email,.matching_shown_email), Wächterspec/architecture/shown_email_guard_spec.rbgegen ein rohes Mitglieds-.email; Anmeldung, Mails und/adminbehaltenemail),membership,role,permission,project_permission,invitation,account(Billing-Ebene ÜBER Orgs),current(Current.user= Audit-Actor der Activity-Kette) - Tickets:
ticket,ticket_assignment,ticket_attribute_definition,ticket_document,tag,tagging,ticket_relation(typisierte Beziehung zweier Tickets einer Organisation,doc/ticket_relations_plan.md: EINE Zeile je Beziehung, „blockiert von“/„folgt auf“ sind dieselbe Zeile vom Ziel aus,KINDSbildet sieben Beschriftungen auf vier Arten ab; Enum-Zahlen fest, zwei Guards vergleichen sie mit Index und CHECK; kein Trackable, kein Verlauf). ⚠️ „Wartet“ und „hält auf“ beantwortet NURTickets::Waiting, „erledigt“ je eigenem Projekt an beiden Enden (closed_status_values_by_project, nicht der Topfclosed_status_values_for); Handbauten lehntspec/architecture/ticket_waiting_owner_guard_spec.rbab. Liste, Kanban und Handy zählen je Seite überTickets::WaitingCountsCache. Wie Subs und Zeiten meldet eine Liste nur ihre Seite an (TicketsHelper#register_ticket_count_page), der erste Lesezugriff lädt sie (Tickets::LazyPagePreload, perprepend). Ein neuer Zähler: Modul voranstellen,answered?bereitstellen,preloadbeantwortet jedes übergebene Ticket, eine Zeile inregister_ticket_count_page, ein Eintrag inbuildersder Modul-Spec; braucht er einen Leser, bekommt er ihn beim Bauen (new(user:)). Keine View lädt von Hand vor. Die Spaltewaitingsteht bewusst NICHT inViewConfiguration::CHILDREN_COLUMN_KEYS(andere Zeilen stimmen erst beim Neuladen). Als Regel einer Ansicht:smart_folders/filters/waiting_state_filter.rb(IS/IS_NOT × true/false,wants_state?liest auch der Dissolver), Felderwaiting/blocking. Anlegen/Löschen nur überActors::CreateTicketRelation/DestroyTicketRelation(Kreis-Prüfung unter Sperre je Org). ⚠️ Wer einem Ticket NEU ZUGEWIESEN werden (oder ihm folgen) darf, entscheidet nurProject#assignable_users: Ticket-Leserecht im Projekt UND aktive Mitgliedschaft. Formular, Kopfmenü, Board, Sammelbearbeitung, MCP und die Beobachter-Auswahl lesen es;users_with_accessallein kennt deaktivierte Mitglieder noch (es entscheidet auch Benachrichtigungen und was ein Verschieben behält, darum nicht dort). Wer schon zugewiesen ist, bleibt es (Ticket#assignable_user_ids): sonst entfernt jedes Speichern im Formular eine deaktivierte Person still, und das Board lehnt jede weitere Zuweisung ab. „Bleibt" heißt nur Behalten: ein erneutesaddeiner nicht mehr zuweisbaren Person istvalue_not_allowed. Entfernen darf eine Änderung jede Person der Organisation und jede, die auf den Tickets der Änderung zugewiesen ist oder ein Abo hat, auch nach gelöschter Mitgliedschaft (BulkFields::Field#removable, erst bei Bedarf gelesen: ein Status-Zug zahlt nichts dafür). Ein Rückgängig nimmt die Personen seines Laufs an, legt aber nicht mehr Zuweisbare nicht zurück (AddRemoveBase#restorable); der Rest des Tickets wird zurückgesetzt. Titel: höchstensTicket::TITLE_MAX_LENGTH(255), geprüft nur bei geändertem Titel. Unteraufgaben (seit 31.10.2026 in beliebiger Tiefe): die Eltern liegen im selben Projekt und stehen nach dem Anlegen fest (Ticket#parent_unchanged), darum kein Kreis. Vorfahren liest nurTickets::Ancestry. Fortschritt und Spalte „Subs“ zählen nur direkte Kinder; ein Ticket in einem Baum lehntTickets::Moverweiter ab. ⚠️ Wer eine Beziehung SEHEN darf, entscheidet nurTicketRelation.visible_to(user, org, token:): beide Enden lesbar (TicketPolicy::Scope), mit Token zusätzlich in dessen Reichweite. Titel, Nummer und Projekt eines Tickets ohne Leserecht erscheinen nirgends (Plan §4). - Personen (seit 26.10.2026):
person(eine gemeinsame Personenliste je Organisation, Tabellepeople),person_name(der EINE Namens-Normalisierer, auch fürMeetingParticipant.normalize_name). Eine Zeile ist ein Kontakt ohne Konto oder die Zusatzangaben eines Mitglieds (user_id, nur aktive Mitglieder derselben Org, eindeutig je Org);nameist immer gefüllt. Eigenes Recht (Permission::CATEGORIES[:people],view_people/manage_people, gastrollen-tauglich), Kontoadmins ohne Zeile; die Policy prüft die aktive Mitgliedschaft selbst. Lesen überPeople::Directory, Schreiben überActors::SavePerson/DestroyPerson. Sichtbarkeit (Review von S1, 28.10.2026): Die Zeile eines Mitglieds, das der Leser auf der Mitgliederseite nicht sieht, bleibt versteckt, auch wenn die Mitgliedschaft nur deaktiviert ist (PersonPolicy::Scope). Erst nach dem Entfernen ist sie ein Kontakt für alle mit dem Recht. Name, E-Mail und Verknüpfung der Zeile eines aktiven Mitglieds gehören dem Konto:SavePersonnimmt sie aus keiner Anfrage (ACCOUNT_FIELDS). Bei einem deaktivierten Mitglied bleibt nur die Verknüpfung fest (LINK_FIELDS, kein Mitglieder-Select im Formular), Name und E-Mail der Zeile bleiben ihre eigenen. Beide fragenPerson#stored_membership. „Bearbeiten schließt Ansehen ein“ steht einmal inPermission::IMPLIED_BY(gelesen vonPersonPolicyundRolePolicy#change_permission?). ⚠️concerns/person_trackable.rb: Aktivitäten tragen KEINE Personendaten (leere Parameter, bei Änderungen nur Feldnamen),skip_notificationsimmer; ein Löschen hinterlässt genau eine anonymeperson.deleted-Zeile. ⚠️concerns/person_link_release.rbsteht inmembershipUNDadmin/membership: wer eine Mitgliedschaft entfernt, behält die Zeile und verliert nur die Verknüpfung. Darum läufterase_personal_data!in beiden Löschwegen VORmemberships.destroy_all; andersherum findeterase_person_links!nichts mehr. Seit S2a (26.10.2026) zeigtmeeting_participant.person_id(FK, nullt beim Löschen der Person) auf eine Zeile;belongs_to :personsteht VORacts_as_tenant, eine Validierung hält die Person in derselben Org. Ein Mitglied läuft weiter überuser_id. Meetings und „Letzter Kontakt“ einer Person liest nurPeople::Contacts(app/services/CLAUDE.md). Seit S2b (27.10.2026) setztperson_idnurActors::LinkMeetingParticipant(Dialog an den Teilnehmer-Chips,MeetingParticipantLinksController): EIN Schlüssel je Teilnehmer, ein Mitglied überuser_id, ein Kontakt (auch die Zeile eines deaktivierten Mitglieds) überperson_id. Die Regel steht dreifach fest: Validierungone_key, Check-Constraintmeeting_participants_one_key(fängt auchupdate_all), und jeder Schreiber leert den anderen Schlüssel selbst. Der Teilnehmer eines Mitglieds, dessen Mitgliedschaft entfernt ist, ist wieder ein Name: der Dialog verknüpft ihn als Kontakt und leert dieuser_id. Wer über ein Konto verknüpft ist, entscheidet EINE Stelle (Meetings::AccountParticipants): Mitglied peruser_id(aktiv oder nicht) oder Kontakt, dessen Zeile inzwischen einem aktiven Mitglied gehört; den lässt der Dialog in Ruhe. Der Actor sperrt das Meeting (lock_in_project!) und löst Person und Mitglied nur überPeople::Directorydes Schreibenden auf. Das Meeting-Formular kenntperson_idnicht;SaveMeetingbehält die Zeile und damit den Link. Macht das Formular eine Kontakt-Zeile zu der eines Mitglieds, fälltperson_idweg, und das Zuordnen (Scopeexternal) lässt Kontakt-Zeilen aus. Reihenfolge der Chip-Zeile: Scopein_row_order(Seite, Panel und Neuzeichnen). Seit 28.10.2026 trägt eine Person bis zu 10 weitere Angaben (people.additional_details, JSONB-Liste auskind/label/value). Die Regel hat EINEN Besitzer:person_detail(kein AR-Modell): Arten, Grenzen, Normalisierung, Prüfung, Link (#href, nur http(s)) und Suchwerte (nur Werte, nie Bezeichnungen). Formular (Arten, Eingabetyp,MAX), Bahn, Suche und Export fragen dort; der Stimulus-Controller bekommt Arten und Grenze als Values. Das Formular schickt immerperson[additional_details][sent]mit (FORM_MARKER): ohne ihn ließe das Entfernen der letzten Angabe die Liste stehen. Fehlt der Key ganz, bleibt die Liste unberührt. Check-Constraintpeople_additional_details_shapehält Liste und Grenze. - Glossar (K4a, 04.11.2026):
glossary_term(ein Begriff je Organisation, nicht je Projekt; eindeutig nachnormalized_term, Statusproposed/confirmed/rejected),term_correction(eine gehörte Form je Korrektur: Sprecher als Person ODER Mitglied, Checkterm_corrections_one_speaker; Projekt als Herkunft; Stelle im Transkript),glossary_text(der EINE Normalisierer: unsichtbare Zeichen raus, NFC, Leerraum, klein, bewusst OHNE die Umlaut-Umschrift vonPersonName).glossary_termhatlock_versionwieperson: ein Formular über eine fremde Änderung hinweg wird abgelehnt (:stale_object). Verweise auf Zeilen einer Organisation stehen VORacts_as_tenantund werden zusätzlich ohne Mandanten-Scope geprüft (same_organisation_references). Eigenes Recht (Permission::CATEGORIES[:glossary],view_glossary/manage_glossary, gastrollen-tauglich), Kontoadmins ohne Zeile;GlossaryPolicyfür beide Modelle (policy_class). Schreiben nur über die Glossar-Actors. ⚠️ Ein gelöschtes Meeting lässt seine gehörten Formen samt Stelle stehen, nurmeeting_idwird leer (FKon_delete: :nullify, Ausnahme E4, Kommentar anMeeting#purge_fragment_content_embeddings); nie aufcascadestellen. 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, Checkterm_corrections_status_known, Altbestandconfirmed). Ohnemanage_glossaryentsteht sie als Vorschlag, auch an einem bestätigten Begriff. Wirksam ist nurTermCorrection.effective(bestätigte Form an bestätigtem Begriff): K4c und das Gerät lesen dort, nieterm_correctionsdirekt. K4c (06.11.2026): dieser Leser istGlossary::Lookup(REST/termsund MCPget_glossary, Karteapp/services/CLAUDE.md). ⚠️Meeting#invalidate_stale_summaryhat GENAU EINE Ausnahme:keep_summary_for_next_save!(eine Speicherung, eine Instanz), gesetzt nur vonActors::SaveMeetingmitkeep_summary: true, das nurActors::CorrectMeetingTermübergibt (Wächterspec/architecture/meeting_summary_exception_guard_spec.rb). Nicht über „generated_summarymitschreiben“ 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 unterapp/services/notifications/(eigene Karte dort) - Ansichten/SmartFolders:
smart_folder{,_rule,_rule_group,_share},view_configuration,view_state,dashboard_configuration,overview_configuration(+smart_folders/,overview/) - Zeiterfassung:
time_session,time_session_group,time_session_permission(+time_sessions/:list_period, der EINE Besitzer der acht Zeitraum-Keys: Reihenfolge, Labels und Fenster für die Filterzeile UND die Statustabelle. Die vier mitoverview/time_periodgeteilten Fenster werden dorthin delegiert, alsKEYS & Overview::TimePeriod::KEYS, damit ein Widget-Drilldown seine Zahl reproduziert. ⚠️ Liste und Tabelle haben verschiedene Voreinstellungen,this_monthgegenall, undcustomgibt es nur in der Liste.) Danebenlist_filters, die EINE Erklärung der Filter der Zeitenliste (Service-Attribute, Entfernen, Zähler, Zurücksetzen, versteckte Formularfelder). Ein neuer Filter ist ein Eintrag dort;list_filters_spec.rbwird rot, wennTimeSessionFilterServiceein Attribut kennt, das dort fehlt.- ⚠️
time_session_permissionist ein zweites Recht AUF der Projekt-Mitgliedschaft: es endet mit ihr (ProjectPermission-Callbacks,Actors::RevokeProjectMemberbeim Block,Membership#destroy) und zählt nur mit lebenderProjectPermissiondahinter (backed_by_project_access). Ein nacktes Lesen lehntspec/architecture/time_session_permission_guard_spec.rbab (Stand 27.09.2026).
- ⚠️
- Wissen/Kommunikation:
note,note_version,post,post_document,chat,chatpost,prompt_persona,chat_style_preference(+knowledge/)- ⚠️
post(= Kommentar): Wer einen privaten Kommentar lesen darf, entscheidet EINE Regel,Post.readable_by(user, organisation)bzw.#readable_by?(Adressat, Autor, Kontoadmins;PostPolicyfragt sie). Was ALLE Leser des Tickets sehen (Aktivitäts-Auszug, Zusammenfassung, KI-Antwort), nimmtpublic_posts. Ein nacktesticket.postsbeim Lesen lehntspec/architecture/post_visibility_guard_spec.rbab (Stand 27.09.2026). Das älterevisible_to(nur der Adressat) ist gelöscht. chat_style_preferencetraegt seit 30.08.2026 NEBEN den Stil-Stufen die stehende Persona-Wahl einer Person je Org. Welche Persona ueberhaupt angehaengt werden darf, entscheidet EIN Ort:concerns/prompt_persona_selectable.rb, eingebunden vonchatUNDchat_style_preference. Die Aufloesungsreihenfolge im Prompt (Thread-Pin, dann diese Wahl, dannPromptPersona.default_for) steht imChatResponseJob.- ⚠️ Zwei Pools, nicht einer, und sie beantworten verschiedene Fragen.
available_forist die Berechtigungsgrenze (darf diese Org die Zeile ueberhaupt halten) und traegt die VALIDIERUNG; sie muss die weitere bleiben, sonst wird eine Zeile mit ueberschriebener Persona unspeicherbar.pickable_forfaltet je Schluessel zusammen, die Org-Zeile gewinnt, und beantwortet "welche gilt gerade" -- daran haengen der Picker, der Schreibpfad UND#resolved_persona. Wer eine gespeicherte Persona gegenavailable_foraufloest, zeigt in der Oberflaeche das eine und schickt dem Modell das andere, ohne dass irgendetwas es sagt. - ⚠️
chatpost#broadcast_completed(S3a T4): der Abschluss einer Antwort verzweigt nach Thread-Art. Projekt-Threads bekommen wie bisher einenbroadcast_refresh_to, also einen SEITEN-Refresh, der auf der Chat-Seite dank Morph-Meta harmlos ist. Org-Threads dürfen das nicht: ihr Abonnent ist das Begleit-Panel, und das reitet auf einer beliebigen Seite ohne Morph-Meta mit, wo aus dem Refresh ein voller Replace-Visit würde. Dort wird stattdessen gezielt die VORHERIGE Antwort ersetzt (Regenerier-Pille). Wer diesen Zweig anfasst, prüft beide Seiten. ⚠️ Bilder im Rich-Text: jedeshas_rich_text :content(Ticket, Post, Note) bindetconcerns/rich_text_embed_guard.rbein (Guard-Spec erzwingt das). Der Validator prüft nur das Delta eines Speicherns (neue Blobs, neue totesgids), identifiziert den Typ selbst, streichturl/hrefaus den Attachment-Knoten (war ein unbefristeter Link) und reiht je neuem BlobRichTextEmbedVariantJobein. Zahlen und Typliste besitzt alleinrich_text_embeds.rb. Plan:doc/inline_bilder_spike_plan.md(E1, D2 bis D10). ⚠️ Sein Auslöserrich_text_content_changing?antwortet aus dem SPEICHER (association_cached?), nie per Query:content.present?lud den Text bei jedem Save jedes Trägers (N+1 bei Massen-Updates), undassociation(...)instanziiert die Assoziation, die Rails' Autosave-Validierung dann selbst nachlädt. Pin:spec/models/action_text/rich_text_embed_guard_query_spec.rb. ⚠️ Seit Rails 8.1 hängt der RichText seineembedsbei JEDER Validierung im Speicher um. Das Delta liest deshalb die gespeicherten Anhänge aus der Datenbank (persisted_embed_blob_ids), niecontent.embeds: sonst läuft ein Blob, den das erstevalid?abgelehnt hat, beim zweiten durch (PDF, fremde Organisation). Die Prüfung steht mitprepend: truevor der Autosave-Validierung, weil ein Blob ohne Datei dort schonFileNotFoundErrorwirft, und hält dann perthrow :abortan. ⚠️ Jede Bild- und Erwähnungs-Kennung im Text ist mitsecret_key_basesigniert (diesgidim<action-text-attachment>, ohne Ablauf). Bekommt eine Instanz einen neuen Schlüssel (Umzug auf einen neuen Server oder Klon mit eigenem Schlüssel), geht keine mehr auf: Rails zeigt☒, und beim Speichern baut esembedsnur aus den Kennungen, die aufgehen, hängt also jedes Bild ab und löscht die Datei per Purge-Job.concerns/rich_text_embed_retention.rb(aufActionText::RichText, eingebunden per Initializer) behält deshalb die gespeicherten Anhänge, solange der Text eine tote Kennung trägt. Nach jedem Schlüsselwechsel einmalrich_text_embeds:resign_sgidslaufen lassen (zuerstDRY_RUN=1, braucht keinen alten Schlüssel): er signiert neu, wenn die Daten neben dem Text dasselbe Ziel nennen (Bild:embedsdieses Textes, Erwähnung:outgoing_referencesder Notiz), liest die Kennung nur als JSON, nie Marshal, und listet den Rest. Eine Selbst-Erwähnung hat keinen Verweis und bleibt liegen. Specs:spec/models/action_text/rich_text_embed_key_rotation_spec.rb,spec/services/rich_text_sgid_resign_spec.rb.
- ⚠️
- Dokumente/Doku/Codebase:
document,document_version,documentation_*(documentation_asset= ein Bild einer synchronisierten Doku, aus dem Repository kopiert; die gecachte Seite zeigt per ID darauf, ausgeliefert nur überFileDownloadsController),codebase_*,code_symbol,project_index{,_run},project_repository,project_capability,project_layer4_vision,reference,fragment,imported_object,product_knowledge_entry(Lalabases eigene Hilfetexte als Suchtabelle, tenant-frei, siehe Falle 3) - Meetings:
meeting,meeting_participant,meeting_participant_claim_rejection,meeting_analysis(Post-Sichtbarkeitsmuster:is_private+visible_to_user),analysis_prompt(org-weite Prompt-Bibliothek) ⚠️ Ein Meeting kann das Projekt wechseln (Actors::MoveMeeting). Jeder Schreibweg, der gegen ein Projekt geprüft wurde, sperrt überMeeting#lock_in_project!und gibt beifalseauf; eine nackte Sperre auf einem Meeting lehntspec/architecture/meeting_lock_guard_spec.rbab (Stand 24.10.2026, Abschnitt in der Wurzel-CLAUDE.md). - Kein AR-Modell, liegt aber hier:
acquisition_source— Value Object überaccounts.acquisition(Herkunft eines Neukunden). Besitzt die Kanal-Priorität ref > utm_source > referrer_host > direct an genau EINER Stelle (doc/akquise_herkunft.md). Ebensoassistant_panel_state(S3a T4) — Value Object über das Panel-Cookie des Assistenten. Besitzt Format, Breitengrenzen und die Sidebar-Breite an EINER Stelle; der Stimulus-Controller bekommt MIN/MAX von dort, statt eigene Zahlen zu führen. ⚠️ Die Sidebar-Breite ist der Zwilling vonw-64/lg:ms-64im Application-Layout. Ebensolegal_identity— Betreiber und Rechtsseiten der Instanz über vierSystemSetting-Zeilen (legal_*). Einziger Leser und Schreiber dieser Zeilen, prüft die URLs beim Speichern;LegalIdentity.currentmerkt sich den Stand je Anfrage inCurrent. Ebensoprovisioning/request_context— Wertobjekt in Anfrage-Form fürUserActivity.track!, wenn die getrennte Website ein Konto anlegt: es trägt den BESUCHER (Adresse, Programm), nicht den Website-Server. Kein Service, darum hier und nicht unterapp/services. - AI/Billing:
ai_credential,ai_usage,system_setting,personal_access_token{,_organisation,_project}(personal_access_token/reach.rb= der Token-Vertrag als Wertobjekt, gegen#accessible_project?gepinnt; welche Organisationen ein Token erreicht, beantwortet NUR#organisation_scopes, auch fürall_organisations, nie die Verknüpfungszeilen selbst;#deactivated_member_of?(K4c) öffnet nichts, es sagt einer Tür nur, dass eine genannte Organisation wegen deaktivierter Mitgliedschaft fehlt, damit das Glossar sie als fehlendes Recht ablehnt, 403 statt 404),content_embedding(Sidecar-Vektor je Record je Raum),embedding_space(ein von der Org GEHALTENER Vektorraum: Tripel + verschlüsselter Credential-Snapshot; welcher davon die Suche bedient, sagtorganisations.active_embedding_space_id),price_list+price_tier(EIN veröffentlichter Preisstand + seine Seat-Staffel: Zeitfenster hängt an der Liste, Staffelung an den Stufen),account_discount(Prozent-Rabatt je Account, ausschließlich im Adminbereich vergeben; genau EINER aktiv, ein laufender ist nur BEENDBAR statt änderbar).EffectiveDating(Zeitfenster + Überlappungsregel) teilen sichprice_listundaccount_discount—price_tierNICHT, eine Stufe erbt das Fenster ihrer Liste.founder_signupist der Antrag auf den Neugründer-Rabatt, nicht seine Bewilligung: er entsteht bei der Registrierung, blockiert nichts und wird nach einem Telefonat von Hand entschieden — der Rabatt selbst bleibt einaccount_discount. Von seinen Feldern hat nurphoneeine Frist (gelöscht nach der Entscheidung, spätestens nach 3 Monaten); Firmenname und Sitz stehen ohnehin am Account. S.doc/billing_preisliste_rabatt_plan.md,ai_usage_rollup(ein Monat quota-relevanter KI-Verbrauch je Org, gebucht am ACCOUNT — die einzige Kopie, die die Löschung der Org überlebt;ai_usageshängt andependent: :destroy. Zeilen sind write-once,organisation_idträgt bewusst KEINEN FK, der Name steht als Snapshot daneben. Geschrieben vonSubscriptions::AiUsageAggregatoraus zwei Einstiegen: Monatsjob undbefore_destroy-Flush. S.doc/billing_agentur_konto_plan.md§17.3b),seat_event+seat_snapshot(Grundlage der Platz-Abrechnung,doc/abrechnungsmodell_plan.md; die vier Dienste darüber stehen inapp/services/CLAUDE.mdunter „Die Seat-Kette").seat_eventist append-only und erzwingt das (readonly?+before_destroy { throw :abort }); Organisation, User und Rolle sind Herkunftsangaben ohne FK, der Organisationsname steht eingefroren daneben, weil das Verschwinden der Org der Normalfall ist.seat_snapshotist umgekehrt abgeleitet und überschreibbar — die beiden Regeln nie aneinander angleichen: die Quelle eines Rollups wird gelöscht,seat_eventsnie. ⚠️ Beide sind bewusst NICHTacts_as_tenant(Falle 3 unten): sie werden von Batch-Läufen ohne Tenant gelesen, ein Default-Scope würde dort still jede Zeile wegfiltern statt zu werfen. - Sonstiges:
org_color,personal_task,user_data_export,user_deletion,mcp_idempotency_key,beuser(Admin-Login, NICHT tenant-gebunden)
Fallen:
- Ticket-
statusist KEINE Spalte — lebt imcustom_attributes-JSONB (CustomAttributable+TicketAttributeDefinition+SystemFunctions). Schreibpfad istActors::SaveTicket, nichtticket.update!(status: …). - Updates an Trackable-Modellen lösen implizit die Notification-Kette aus — vor Änderungen
an Ticket/Project/Document/Note-Writes:
docs/architektur/seiteneffekt_ketten.mdlesen. acts_as_tenantauf fast allen Modellen — in Tests den Tenant VOR der Model-Erzeugung setzen. Plain.findin Jobs ist kein Tenant-Bug (Tenant wird in Jobs serialisiert). Bewusst tenant-FREI:account+account_discount+price_list/price_tier(Billing liegt über den Orgs, und/pricingliest ohne Tenant),ai_usage_rollup(überlebt die Org, deren Verbrauch es zählt — ein Tenant-Scope würde genau die Zeilen wegfiltern, für die es existiert),seat_event+seat_snapshot(dieselbe Begründung, gelesen von Batch-Läufen ohne Tenant),beuser,system_setting,ai_package*,product_knowledge_entry(Lalabases eigene Texte, für jede Org gleich und vom Assistenten aus jedem Tenant gelesen; eine abgeleitete Kopie der Hilfedateien,doc/product_knowledge_plan.md). Dort einacts_as_tenantnachzurüsten filtert still alles weg, ohne einen Fehler zu werfen. ⚠️ Umgekehrt gilt: eine Organisation lässt sich nur MIT gesetztem Tenant zerstören — ihre tenant-gescopten Kaskaden werfen sonstNoTenantSet(gemessen beim Bau von T17; einen Org-Löschpfad gibt es in der App bis heute nicht).- Boy-Scout-Regel: flaches Modell einer Namespace-Domäne wird substanziell angefasst →
in den Namespace ziehen (
self.table_namebehalten, keine Migration nötig). admin/*sind Zwillinge auf denselben Tabellen ohne gemeinsamen Save-Zyklus — ein Callback oder Concern nur auf der Tenant-Seite wirkt im Adminbereich still nicht (spec/models/admin_twin_concern_parity_guard_spec.rbprüft die Includes). Die Kontolöschung hat deshalb ZWEI Implementierungen (user/deletion_lifecycle.rb,admin/user.rb, Trennung bewusst); was ein Konto an Datensätzen BESITZT (Export-Archive, private Analysen und Ticket-Posts, persönliche Aufgaben, eigene Chats, Token-Widerruf), löscht alleinconcerns/personal_data_erasure.rbfür beide. Neue Datensorte → dort ergänzen, nie in einer der Methoden.spec/models/user_erasure_path_parity_spec.rbpinnt beide Pfade und die Zeile danach.
Sammeländerung (08.09.2026, doc/ticket_bulk_edit_plan.md)
ticket_bulk_run.rb: ein Durchlauf (Änderungenchange_list, nichtchanges: das ist ActiveRecords eigenes; Ergebnisse je Ticket mit Vorher-Werten;undone_at,undo_of;UNDO_WINDOW24 h;undoable_by?= Ausführender oder Account-Admin).Trackable#activity_context: der EINE generische Haken der Sammeländerung, siehedocs/architektur/seiteneffekt_ketten.mdunten. nil = heutiges Verhalten.Activity.feed: Feed ohne die Ticket-Aktivitäten eines Durchlaufs; der Ticket-Verlauf liest ohne den Scope.- Scheibe 7:
ticket_bulk_run.kind(change/move/delete, nurchangeist rückgängig machbar);Activity.feedfiltertbulk_run_memberan JEDEM Trackable (Verschieben schreibt Projekt-Aktivitäten);ProjectTrackable#track_tickets_bulk_moved/_moved_in/_deleted, die Lösch-Zeile trägtfollower_ids, weil die Abos mit den Tickets gehen.