28. Nov. 2025·7 Min. Lesezeit

Benennungsregeln für Admin‑Panel‑Datenbanken, die lesbar bleiben

Verwende Benennungsregeln für Admin‑Panel‑Datenbanken, damit automatisch erzeugte Screens lesbar bleiben: klare Regeln für Tabellen, Felder, Enums, Relationen und eine schnelle Checkliste.

Benennungsregeln für Admin‑Panel‑Datenbanken, die lesbar bleiben

Warum Namen entscheiden, ob ein Admin‑Panel klar oder chaotisch wirkt

Die meisten Admin‑Panels entstehen aus deinem Datenmodell. Tabellen‑ und Feldnamen werden zu Menüpunkten, Seitentiteln, Spaltenüberschriften, Filterlabels und sogar zu den Wörtern, die Menschen in die Suche tippen.

Wenn Namen klar sind, kann ein Administrator eine Liste überfliegen und sie sofort verstehen. Sind Namen unklar, hält er inne, rät, öffnet einen Datensatz, geht zurück und versucht es erneut. Diese Verzögerung summiert sich. Sie wird zu „Wie finde ich den richtigen Kunden?“‑Supportfragen und zu Schulungsunterlagen, die niemand lesen will.

Entwickler benennen Dinge oft nach dem, was beim Bauen und Debuggen hilft. Operatoren benennen Dinge so, dass sie ihre Arbeit erledigen können. Ein Entwickler ist vielleicht mit acct, addr1 oder stat zufrieden, weil er weiß, was gemeint ist. Ein Operator braucht „Account“, „Address line 1“ und „Status“, ohne dekodieren zu müssen.

In einem Admin‑Screen bedeutet „lesbar“ meist:

  • Du kannst eine Tabelle überfliegen und jede Spalte ohne Öffnen einer Zeile verstehen.
  • Du kannst mit den gleichen Worten suchen und filtern, die du im Alltag verwendest.
  • Du kannst sortieren und Werte vergleichen, ohne Überraschungen (z. B. dass Daten, die eigentlich Datumswerte sind, als Text gespeichert sind oder Statuswerte inkonsistent sind).

Wenn du eine Plattform nutzt, die Screens aus dem Modell generiert (zum Beispiel AppMaster’s Data Designer und admin‑ähnliche Views), wird die Benennung Teil des UI‑Designs. Gute Namen liefern saubere Standard‑Screens vom ersten Tag an, bevor du Labels und Layouts verfeinerst.

Eine einfache Benennungsgrundlinie, die dein gesamtes Team befolgen kann

Wenn du möchtest, dass generierte Admin‑Screens vom ersten Tag an sauber aussehen, einigt euch auf eine Grundlinie, bevor jemand die erste Tabelle anlegt. Die meisten Benennungsprobleme sind nicht technisch, sie sind Konsistenzprobleme.

Wähle einen Identifikatorstil und mische ihn nicht. Für Datenbanken ist snake_case in der Regel am einfachsten zu lesen und zu durchsuchen. Wenn dein Stack camelCase erwartet, benutze es überall (Tabellen, Spalten, Fremdschlüssel, Enums). Ein Stilwechsel mitten im Projekt lässt Labels und Filter zufällig wirken.

Eine Grundlinie, die für die meisten Teams funktioniert:

  • Verwende volle Wörter: customer_id, nicht cust_id; description, nicht desc.
  • Verwende klare Substantive für Dinge und klare Verben für Aktionen: invoice, payment, refund_requested.
  • Verwende konsistente Zeitstempelnamen: created_at, updated_at, deleted_at.
  • Vermeide vage Wörter wie data, info, value oder type, außer du gibst Kontext (zum Beispiel shipping_address, payout_method).
  • Halte Singular vs. Plural konsistent (viele Teams nutzen plurale Tabellen wie customers und singuläre Spalten wie customer_id).

Schreibe ein kleines Glossar und halte es sichtbar. Entscheide früh, ob ihr customer, client, account oder user meint, und bleibt bei einem Begriff. Dasselbe gilt für „order“ vs. „purchase“ oder „ticket“ vs. „case“.

Eine schnelle Prüfung: Wenn zwei Personen ohne Nachfrage bei einer Spalte wie account_status übereinstimmen, was gemeint ist, funktioniert die Grundlinie. Wenn nicht, benenne sie um, bevor du Screens und Filter darauf aufbaust.

Tabellenbenennungsregeln, die sich sauber in Menüs und Listen abbilden

Die meisten Admin‑Panels wandeln Tabellennamen in Menüpunkte, Listentitel und Breadcrumbs um. Dein Schema ist nicht nur für Ingenieure. Es ist der erste Entwurf deiner UI.

Wähle einen Stil für Entitätstabellen und bleibe dabei: Singular (user, invoice, ticket) oder Plural (users, invoices, tickets). Singular liest sich oft besser in Formular‑Titeln („Edit Ticket“), während Plural in Menüs besser aussehen kann („Tickets“). Beides ist in Ordnung. Die Mischung beider Stile macht die Navigation inkonsistent.

Benenne Tabellen nach dem, was sie sind, nicht nach dem, was sie tun. Eine Tabelle sollte ein Ding repräsentieren, auf das man zeigen kann. payment ist ein Ding; processing ist eine Aktion. Wenn du später Refunds, Retries und Settlements hinzufügst, wird ein Tabellenname wie „processing“ irreführend.

Regeln, die Menüs und Listen sauber halten:

  • Verwende konkrete Substantive (customer, subscription, invoice, ticket_message).
  • Vermeide Sammel‑Tabellen für permanente Daten (settings, misc, temp, data). Teile sie in echte Entitäten (notification_setting, tax_rate, feature_flag).
  • Bevorzuge kurze, lesbare zusammengesetzte Namen mit Unterstrichen (purchase_order, support_ticket) statt Abkürzungen.
  • Füge ein Modul‑Präfix nur dann hinzu, wenn es Kollisionen verhindert (zum Beispiel billing_invoice vs invoice). Wenn du ein Präfix verwendest, setze es konsistent im ganzen Modul ein.

Wenn du AppMaster verwendest, um Screens direkt aus deinem Schema zu generieren, liefern stabile, nomenbasierte Tabellennamen in der Regel ein sauberes Standardmenü und Listenansicht mit weniger Nacharbeit.

Join‑Tabellen und Bezeichner: Many‑to‑Many lesbar halten

Many‑to‑Many‑Relationen sind häufig der Punkt, an dem Admin‑Panels chaotisch aussehen. Wenn die Join‑Tabelle und ihre Schlüssel gut benannt sind, bleiben generierte Screens lesbar, ohne manuelle Nacharbeit.

Beginne mit einer langweiligen Regel und brich sie nicht: Jede Tabelle hat einen Primärschlüssel namens id. Verwende nicht in einer Tabelle user_id als Primärschlüssel und in einer anderen id. Einheitliche Identifikatoren machen Relationen vorhersehbar und helfen generierten Formularen und Referenzfeldern, konsistent zu bleiben.

Für reine Join‑Tabellen benenne sie nach beiden Entitäten mit einem einheitlichen Muster und Reihenfolge. Gängige Optionen sind alphabetisch (product_tag) oder „Hauptsache zuerst“ (user_role). Wähle eine Reihenfolge und verwende sie überall.

Vermeide vage Namen wie links oder mappings, außer die Tabelle enthält wirklich generische Cross‑Object‑Verknüpfungen. In den meisten Admin‑Panels schlägt Spezifität Cleverness.

Wenn eine Join‑Tabelle zur echten Entität wird

Wenn die Beziehung zusätzliche Felder hat, behandle sie wie ein eigenes Modell und nenne sie wie ein Substantiv, das Menschen verstehen: membership, assignment, subscription. Zum Beispiel: Wenn eine Rolle eines Nutzers starts_at, ends_at und granted_by hat, ist user_role in Ordnung, aber membership liest sich in der UI eventuell besser.

Eine einfache Regelfolge, die Screens professionell hält:

  • Verwende id als Primärschlüssel in jeder Tabelle.
  • Benenne Join‑Tabellen mit beiden Entitäten in konsistenter Reihenfolge (user_role).
  • Nutze klare Fremdschlüssel wie user_id und role_id.
  • Füge eine Einzigartigkeitsregel hinzu, die der Realität entspricht (z. B. ein role_id pro user_id).
  • Wenn du Historie erlaubst, passe die Einzigartigkeitsregel an aktive Datensätze an (z. B. eindeutig, wo ended_at null ist).

Diese Entscheidungen halten, wenn deine Daten wachsen, und funktionieren gut mit AppMaster’s Data Designer, wo Screens direkt aus dem Modell generiert werden können.

Feldbenennungsmuster, die klare Spalten und Filter erzeugen

Ein sauberes Standard‑Admin erhalten
Generiere Listen‑ und Formularansichten aus deinem Schema und passe Labels nur dort an, wo es nötig ist.
Admin erstellen

Feldnamen tun mehr, als Entwicklern zu helfen. Sie bestimmen, was Benutzer als Spaltenüberschriften, Filterlabels und Formularfelder sehen.

Vorhersehbare Suffixe nehmen die Raterei weg:

  • Verwende _id für Fremdschlüssel: customer_id, assigned_agent_id.
  • Verwende _at für Zeitstempel: created_at, paid_at, closed_at.
  • Verwende _count für Zähler: login_count, attachment_count.

Booleans sollten wie einfache Sätze lesbar sein. Bevorzuge is_ und has_, damit Checkboxen auf einen Blick Sinn ergeben: is_active, has_paid, is_verified. Vermeide doppelte Negationen wie is_not_approved. Wenn du ein „nicht“ abbilden musst, modellier das Positive und invertiere die Logik im Code.

Geldfelder sind eine häufige Fehlerquelle in Admin‑Grids. Wähle einen Ansatz und bleibe dabei: minor units (z. B. Cent) als Integer speichern, oder Dezimalwerte mit fester Genauigkeit. Benenne das Feld so, dass niemand raten muss. Zum Beispiel total_amount_cents + currency_code, oder total_amount + currency_code. Mische nicht price, amount und total, außer sie stehen für verschiedene Konzepte.

Textfelder sollten den Zweck klar benennen, nicht nur den Typ. description ist user‑sichtbar. internal_comment ist privat. notes ist ein Auffangbecken und sollte mit Bedacht verwendet werden. Bei mehreren Notizen benenne sie nach Zielgruppe: customer_note, agent_note.

Kontaktfelder sollten wörtlich sein, weil sie oft Schnellfilter werden: website_url, contact_email, billing_email. In AppMaster‑generierten Admin‑Screens werden solche Namen meist zu sauberen Standardlabels.

Relationen und Fremdschlüssel: Namen, die das Datenmodell erklären

Gute Relationen lesen sich wie einfaches Englisch. Wenn ein Admin‑Panel aus der Datenbank generiert wird, werden Fremdschlüssel oft zu Spaltentiteln, Filtern und Formularlabels.

Behalte eine Regel bei: Die Fremdschlüsselspalte ist der referenzierte Tabellenname plus _id. Hast du customer.id, verwende customer_id. Bei order.id nutze order_id. Diese Konsistenz macht sofort klar, worauf eine Spalte verweist.

Selbst‑Relationen brauchen zusätzliche Klarheit, weil sie später leicht missverstanden werden. Vermeide generisches related_id. Nutze Namen, die Richtung und Bedeutung erklären, wie parent_id für Bäume, manager_id für Organisationsdiagramme oder merged_into_id für Deduplizierungen.

Wenn eine Relation eine Join‑Tabelle verwendet, benenne sie so, dass sie wie ein Satz liest. Zum Beispiel ist ticket_assignee.user_id klarer als ticket_user.user_id, wenn die Rolle „assignee“ ist (und nicht „reporter“ oder „watcher").

Praktische Prüfungen, die die meisten Probleme verhindern:

  • Verwende owner_id nicht mit unterschiedlichen Bedeutungen in verschiedenen Tabellen. Bevorzuge created_by_user_id, account_manager_user_id oder billing_contact_id.
  • Wenn du mehrere Relationen zur selben Tabelle hast, nenne die Rolle mit: requested_by_user_id und approved_by_user_id.
  • Wähle einen Soft‑Delete‑Marker und bleibe dabei. deleted_at ist weithin verstanden und funktioniert gut mit Filtern.

Wenn du später Screens in AppMaster baust, erscheinen diese Namen überall—ein wenig Sorgfalt hier spart viel UI‑Nacharbeit.

Enums und Status‑Felder, die über die Zeit verständlich bleiben

Designe dein Admin‑Datenmodell
Erstelle ein Postgres‑bereites Schema im Data Designer und halte Menüs und Bezeichnungen konsistent.
Mit dem Entwurf beginnen

Wenn dein Admin‑Panel aus der Datenbank generiert wird, ist die schnellste Art, Screens unübersichtlich zu machen, deutliches Verhalten über viele kleine Flags zu verstreuen. Bevorzuge ein klares Status‑Enum für den Hauptlebenszyklus eines Datensatzes und behalte zusätzliche Flags nur für wirklich separiertes Verhalten.

Eine nützliche Regel: Wenn Nutzer fragen würden „Wo steht dieses Element in seiner Reise?“, ist das ein Status. Wenn die Frage „Soll es verborgen werden?“ oder „Ist es gesperrt?“ lautet, ist das ein separates Boolean.

Ein Status schlägt fünf Booleans

Statt is_new, is_in_progress, is_done, is_cancelled nutze ein ticket_status. Das liest sich besser in Listen, Filtern und Massenaktionen. Es verhindert auch unmögliche Kombinationen wie „done + in_progress".

Halte Enum‑Werte stabil. Die UI‑Beschriftung kann sich ändern, die gespeicherten Werte sollten das nicht. Speichere pending, nicht waiting_for_review. Speichere rejected, nicht rejected_by_manager. Freundlichere Labels kannst du später ohne Datenmigration anzeigen.

Wenn du Detailinformationen brauchst, füge ein zweites Feld hinzu, statt den Status zu überladen. Beispiel: Behalte payment_status als Lebenszyklus und füge failure_reason (Text) hinzu, wenn nötig.

Enums nach Domäne benennen (damit Filter Sinn machen)

Verwende einen Domain‑Prefix, damit Screens lesbar bleiben, wenn mehrere Modelle ein „status“ haben:

  • payment_status (Checkout)
  • ticket_priority (Support Dringlichkeit)
  • user_role (Zugriffslevel)
  • invoice_status (Billing‑Lebenszyklus)
  • delivery_status (Versand‑Lebenszyklus)

Trenne Lebenszyklus von operativen Flags. Zum Beispiel beschreibt status, wo sich etwas im Workflow befindet, während is_archived bedeutet, dass es aus Alltagslisten verborgen werden sollte.

Schreibe für jeden Enum‑Wert einen Einzeiler in die Team‑Notizen. Dein zukünftiges Ich wird den Unterschied zwischen cancelled und voided vergessen. Wenn du AppMaster nutzt, helfen diese kurzen Definitionen außerdem, generierte Dropdowns und Filter konsistent über Web‑ und Mobile‑Screens zu halten.

Edge Cases: Daten, Audit‑Felder und „type“ Spalten

Benennungsleitfäden decken oft Tabellen und Basisfelder ab, aber Admin‑Panels werden in den Edge Cases unübersichtlich. Daten, Audit‑Felder und type‑Spalten sind Orte, an denen verwirrende Namen zu verwirrenden Screens werden.

Bei Daten und Zeitstempeln sollte der Name die Geschichte erzählen: Ist es geplant, tatsächlich eingetreten oder eine Erinnerung? Ein einfaches Muster ist eine verbähnliche Bedeutung plus klares Suffix. Zum Beispiel due_at (geplante Frist) und completed_at (tatsächliches Ende) erscheinen als verständliche Spalten und Filter. Vermeide vage Paare wie start_date und end_date, wenn du eigentlich scheduled_at und finished_at meinst.

Optionale Relationen sind eine weitere Falle. Erfinde nicht für jede Tabelle neue Muster. Halte den Relationsnamen stabil und drücke „optional“ durch NULL aus, nicht durch Umbenennung. manager_id sollte weiterhin manager_id heißen, auch wenn es optional ist.

Adressen können im Code gut aussehen, aber in Grids hässlich werden. Nummerierte Zeilen sind in Ordnung, nur wenn dein Team überall dasselbe versteht. Halte sie explizit:

  • address_line1, address_line2, city, region, postal_code, country_code
  • Vermeide address1, address2 (schwerer zu lesen, leichter zu duplizieren)

Audit‑Felder sollten absichtlich langweilig sein:

  • created_at, updated_at
  • created_by_id, updated_by_id (nur wenn du wirklich User‑Tracking brauchst)

Sei vorsichtig mit type. Es ist fast immer zu allgemein und altert schlecht. Statt type benenne die Bedeutung: payment_method, ticket_channel, customer_tier. In schema‑gesteuerten Admin‑Screens (inklusive AppMaster) kann diese eine Entscheidung den Unterschied zwischen einem klaren Filter und einem verwirrenden Dropdown ausmachen.

Beispiel: Ein Support‑Ticket‑Modell so benennen, dass es im Admin gut aussieht

Admin auf Mobil erweitern
Nutze dasselbe klare Modell, um mobile Ansichten zu generieren, wenn das Team unterwegs Admin‑Zugriff braucht.
Mobile App erstellen

Ein kleines realistisches Support‑Setup: Kunden schreiben, Mitarbeiter antworten, und Tickets können getaggt werden. Benennungsregeln sorgen dafür, dass automatisch generierte Menüs, Listen und Filter offensichtlich wirken.

Beginne mit Tabellennamen, die sich als Substantive in einer Seitenleiste lesen:

  • customer
  • ticket
  • ticket_message
  • ticket_tag
  • ticket_tag_link

In den meisten Admin‑Panels werden daraus Labels wie „Tickets“ und „Ticket Messages“ und die Join‑Tabelle bleibt im Hintergrund.

Für die Ticket‑Listenansicht wähle Feldnamen, die zu klaren Spaltenüberschriften und Filtern werden:

  • subject, status, priority
  • assigned_to_id (zeigt auf einen Staff‑User)
  • last_message_at (steuert Sortierung nach zuletzt geantwortet)
  • created_at (standardisiert und vorhersehbar)

Enums sind oft der Punkt, an dem Lesbarkeit später kaputtgeht, also halte die Werte stabil und schlicht:

  • ticket_status: new, open, pending_customer, resolved, closed
  • ticket_priority: low, normal, high, urgent

Eine Benennungsentscheidung, die ständige Verwirrung verhindert: Überlade „customer“ nicht. In Support ist der Einreicher nicht immer der Kunde (eine Kollegin kann im Namen einer anderen Person einreichen). Wenn du die Person speicherst, die das Ticket erstellt hat, nenne das requester_id und speichere separat customer_id für das Konto, um das es geht. Diese Unterscheidung hält Formulare und Filter von Anfang an zutreffend.

Schritt‑für‑Schritt: Wie man ein neues Modell benennt, bevor man Screens baut

Eine Funktion schnell prototypen
Teste deine Benennungsgrundsätze an einem kleinen Modul, bevor die Datenbank wächst.
Prototyp erstellen

Der einfachste Weg, Screens lesbar zu halten, ist, Dinge zu benennen, während du noch in klarem, nicht‑technischem Denken bist — nicht, während du bereits baust.

Ein wiederholbarer Prozess für jedes Feature

  1. Beginne mit einem Mini‑Glossar (5 bis 10 Begriffe). Schreibe die Wörter auf, die ein nicht‑technisches Teammitglied in einem Meeting verwenden würde, und wähle für jedes Konzept einen bevorzugten Begriff (z. B. „customer“ vs. „client").

  2. Skizziere die erwarteten Screens: Liste, Detail, Erstellen, Bearbeiten. Für die Listenansicht entscheide, welche 5 bis 8 Spalten sofort als Überschriften klar sein müssen. Wenn ein Feldname als Überschrift komisch klingt, braucht es Arbeit.

  3. Entwirf Tabellen und Relationen und benenne Felder nach den Suffix‑Regeln (*_id, *_at, is_*, *_count). Wenn du später Admin‑Screens generierst (auch in AppMaster), erzeugen diese Muster oft saubere Labels und vorhersehbare Filter.

Bevor du weitermachst: Vergewissere dich, dass du keine Stile mischst (customer_id in einer Tabelle, clientId in einer anderen). Konsistenz schlägt Cleverness.

  1. Definiere Enums früh, nicht nachdem die erste UI existiert. Schreibe für jeden Wert einen Einzeiler, als würdest du ihn dem Support erklären. Bevorzuge Werte, die Änderungen überstehen, wie pending, active, archived (nicht new, newer, newest).

  2. Mache einen „Spaltenüberschriften‑Durchlauf“. Stelle dir vor, du wärst der Admin, der eine Tabelle überfliegt.

  • Würden „Created At“, „Updated At“, „Status“, „Assigned To“, „Total Amount“ ohne Schulung Sinn ergeben?
  • Klingen Felder wie interne Code‑Bezeichnungen (tmp_flag, x_type, data1) fehl am Platz?
  • Sind Einheiten klar (amount_cents vs amount, duration_seconds vs duration)?

Wenn etwas beim Vorlesen unklar klingt, benenne es jetzt um. Umbenennen später ist möglich, aber oft mit Folgen in Reports, Filtern und Gewohnheiten.

Häufige Benennungsfehler, die Admin‑Panels schwer nutzbar machen

Ist das Schema chaotisch, sehen die Screens es auch, egal wie hübsch die UI ist. Benennungsregeln sind weniger Stil als tägliche Nutzbarkeit.

Die erste Falle ist gemischtes Vokabular. Wenn eine Tabelle client heißt und eine andere customer, fühlen sich Menüs, Filter und Suchergebnisse an, als würden sie unterschiedliche Dinge beschreiben. Wähle ein Wort für jedes Kernkonzept und verwende es überall, auch in Relationennamen.

Ein weiterer häufiger Fehler ist Überkürzung. Abkürzungen wie addr, misc oder info sparen ein paar Zeichen, kosten aber viel Klarheit in Tabellen und Exporten.

Ein dritter Fehler ist, UI‑Ablauf in der Datenbank zu verankern. Ein Feld wie new_customer_wizard_step macht beim Start Sinn, wird aber verwirrend, wenn sich der Flow ändert oder ein zweiter Onboarding‑Pfad hinzukommt. Speicher die Geschäfts‑Tatsache (z. B. onboarding_status) und lass die UI entscheiden, wie sie Leute führt.

Achte auch auf Boolean‑Überladung. Mit is_new, is_open und is_closed bekommst du irgendwann Konflikte (zwei true gleichzeitig) und unklare Filter. Bevorzuge ein einzelnes Statusfeld mit einer kleinen, gut benannten Wertemenge.

Warnsignale, die oft zu hässlichen Admin‑Screens führen:

  • Zwei unterschiedliche Namen für dasselbe (client_id an einer Stelle, customer_id an einer anderen)
  • Auffangspalten (notes, misc, extra) die gemischte Daten enthalten
  • Zeitlich gebundene Namen (summer_campaign_*), die die Kampagne überdauern
  • Mehrere Booleans, die einen Zustand beschreiben sollen
  • Unüberlegte Umbenennungen ohne Migrationsplan

Umbenennen ist nicht nur Suchen‑und‑Ersetzen. Wenn du customer_phone in phone_number änderst, plane die Migration, aktualisiere generierte Screens und halte Rückwärtskompatibilität, wo nötig (besonders wenn andere Systeme die API lesen). In AppMaster zahlen sich saubere Namen sofort aus, weil Listen, Formulare und Filter ihre Labels aus deinem Modell ableiten.

Kurze Checkliste, bevor du das Admin‑Panel auslieferst

Den Full‑Stack No‑Code bauen
Nutze AppMaster, um die ganze Lösung zu bauen: Datenbank, Backend und Admin‑UI aus einem Modell.
Loslegen

Bevor du das Schema als „fertig“ deklarierst, mache einen Durchgang aus der Sicht von jemandem, der täglich im Admin‑Panel arbeitet.

  • Tabellen klingen nach echten Dingen. Ein Teammitglied sollte sagen können, was eine Tabelle repräsentiert (ticket, customer, invoice) ohne zu raten.
  • Schlüssel‑Felder folgen vorhersehbaren Suffixen. Verwende Muster, die auf einen Blick erkennbar sind: *_id für Referenzen, *_at für Zeitstempel, *_amount (oder *_amount_cents) für Geld und is_* für True/False‑Flags.
  • Enums sind stabil und schlicht. Speichere Werte wie pending, paid, failed statt UI‑Formulierungen, die sich ändern.
  • Ein neues Teammitglied kann die Bedeutung erschließen. Würden die Felder in einer generierten Listenansicht ohne Hilfetext verständlich bleiben?
  • Mehrdeutige Wörter sind entfernt oder konkretisiert. Ersetze Sammelbegriffe wie data, value, type oder info durch konkrete Namen wie status, source, category, notes oder external_reference.

Wenn du AppMaster’s Data Designer verwendest, um admin‑ähnliche Views aus deinem Schema zu generieren, ist diese Checkliste praktisch: Klare Namen werden zu klaren Spalten und Filtern, und du verbringst weniger Zeit damit, Labels nachträglich zu korrigieren.

Nächste Schritte: Benennung zur Gewohnheit machen (und Screens konsistent halten)

Gute Benennung ist keine einmalige Säuberung. Es ist eine kleine Routine, die deine Admin‑UI lesbar hält, während das Schema wächst.

Beginne mit einem bestehenden Modul und wende die Regeln nur auf die nächste neue Tabelle an, die du hinzufügst. Das vermeidet eine erschreckende Neuordnung und gibt dir einen echten Ort zum Üben. Fügst du als nächstes „returns“ zu einem Orders‑System hinzu, benenne Tabelle, Fremdschlüssel und Status von Anfang an nach deinen Mustern und verwende denselben Ansatz beim nächsten Feature.

Halte eine einseitige Benennungsanleitung neben dem Ort, an dem du Schema‑Arbeit machst. Halte sie kurz: Wie du Tabellen, Primär‑ und Fremdschlüssel, Zeitstempel und Status‑Enums nennst. Ziel sind schnelle Entscheidungen, nicht lange Debatten.

Wenn du mit AppMaster baust, hilft es, diese Muster im Data Designer zu hinterlegen, bevor du UI‑Screens anfasst. Wenn du Tabellen oder Felder umbenennst, regeneriere die App, damit Screens, APIs und Logik synchron bleiben statt auseinanderzudriften.

Eine leichte Review‑Stufe vor jedem Release reicht meist:

  • Lesen sich Tabellen‑ und Feldnamen als Menüpunkte, Spaltenüberschriften und Filter sinnvoll?
  • Sind Status und Enums ohne zusätzliche Erklärung klar?
  • Erklären Relationen und Fremdschlüssel sich selbst (keine mysteriösen Abkürzungen)?
  • Sind ähnliche Modelle konsistent benannt (gleiche Wörter, gleiche Reihenfolge)?

Im Laufe der Zeit ist der echte Gewinn Konsistenz. Wenn jedes neue Modell denselben Regeln folgt, beginnen Admin‑Panels wie gestaltet auszusehen, auch wenn sie generiert sind — weil Labels und Listen wie ein kohärentes Produkt lesen.

FAQ

Warum beeinflussen Datenbanknamen, wie ein Admin‑Panel wirkt?

Verwende Namen, die beschreiben, was der Datensatz ist, nicht was er tut. Eine Tabelle namens ticket oder invoice wird zu einem klaren Menüeintrag, während etwas wie processing schnell verwirrend wird, wenn sich der Workflow ändert.

Sollen wir `snake_case` oder `camelCase` für Tabellen und Spalten verwenden?

Wähle einen Stil und bleibe überall dabei. Für die meisten Datenbanken ist snake_case am leichtesten zu überfliegen und verhindert, dass generierte Labels und Filter zufällig wirken.

Wie entscheiden wir, wann Abkürzungen in Ordnung sind?

Standardmäßig lieber vollständige, offensichtliche Wörter, weil sie zu Spaltenüberschriften und Filterlabels werden. Abkürzungen wie acct oder addr1 erzeugen meist Verunsicherung bei Operatoren, selbst wenn Entwickler sie verstehen.

Sollen Tabellennamen singular oder plural sein?

Wähle eine Variante und sei konsistent: entweder Singular (ticket) oder Plural (tickets). Das wichtigste Ziel ist, dass Navigation und Seitentitel nicht zwischen Modulen wechseln.

Was ist eine einfache Regel für Primär‑ und Fremdschlüssel?

Eine einfache, verlässliche Regel: Der Primärschlüssel jeder Tabelle heißt id, Fremdschlüssel sind etwas_id. Das macht Relationen vorhersehbar und lässt generierte Formulare und Referenzfelder einheitlich aussehen.

Wie sollten Many‑to‑Many Join‑Tabellen genannt werden, damit die UI lesbar bleibt?

Benenne reine Join‑Tabellen nach beiden Entitäten in einer konsistenten Reihenfolge, z. B. user_role oder product_tag. Wenn die Beziehung eigene Felder und Bedeutung hat, gib ihr einen eigenen Namen wie membership oder assignment, damit die UI natürlicher liest.

Welche Feldbenennungs‑Muster erzeugen saubere Spalten und Filter?

Verwende vorhersehbare Suffixe, die Datentyp und Zweck widerspiegeln, z. B. _at für Zeitstempel und _count für Zähler. Für Booleans lieber is_ und has_, damit Checkboxen in generierten Screens wie einfache Sätze lesbar sind.

Ist es besser, ein Status‑Enum zu verwenden oder mehrere Boolean‑Flags?

Bevorzuge ein klares Statusfeld für den Hauptlebenszyklus, z. B. ticket_status oder invoice_status, statt mehrfach überlappender Booleans. Speichere stabile, einfache Werte, damit sich die Anzeige später ändern lässt, ohne Daten migrieren zu müssen.

Wie benennen wir mehrere Relationen zur selben Tabelle, ohne Verwirrung?

Verwende keine wiederverwendeten generischen Namen wie owner_id, wenn sie unterschiedliche Bedeutungen haben. Nutze rollen­spezifische Namen wie created_by_user_id, approved_by_user_id oder payment_method, damit Screens und Filter selbsterklärend sind.

Wann sollten wir eine Tabelle oder Spalte umbenennen und wie vermeiden wir Brüche in AppMaster?

Idealerweise früh umbenennen, bevor Screens, Filter und Reports auf die alte Bezeichnung angewiesen sind. In AppMaster aktualisiere die Namen im Data Designer und regeneriere die App, damit UI und API synchron bleiben und nicht auseinanderdriften.

Einfach zu starten
Erschaffe etwas Erstaunliches

Experimentieren Sie mit AppMaster mit kostenlosem Plan.
Wenn Sie fertig sind, können Sie das richtige Abonnement auswählen.

Starten