Product-UI

Hoe onze producten eruitzien, werken en praten. Eén standaard voor elk scherm, zodat een knop er in elke app die we bouwen hetzelfde uitziet en hetzelfde doet.

De standaard: shadcn/ui, onze kleuren en ons lettertype

Lay-out, componenten en interactie volgen shadcn/ui (new-york-stijl): de maten, afstanden, afrondingen, toestanden en opbouw van de componenten. Kleur en letter blijven van ons: de merktokens en Murecho. Eén afwijking, uit onze designfilosofie: geen schaduwen, diepte maak je met een rand van 1px.

Waarom shadcn/ui: het is gebouwd op Tailwind, net als onze apps; het is monochroom, net als onze interface; het gedrag (toetsenbord, focus, Escape) volgt de WAI-ARIA-patronen; en het is de look die mensen al kennen van tools als Vercel en Supabase.

In code: bouw met de gedeelde componentbibliotheek van de app (in Odoo MCP Pro: templates/_ui.html), nooit met losse knop- of badgeklassen. Zoek componenten op met de shadcn-MCP-server; vertaal ze, installeer nooit React-bestanden in een Jinja- of Odoo-app.

Paginatypes

Elk scherm is een van vijf types. Kies eerst het type; de lay-out volgt daaruit.

Lijst

Een titel, één primaire actie rechtsboven, één tabel. De hele rij opent het ding. Eén statuskolom. Voorbeeld: Odoo instances.

Overzicht

Eén ding in één oogopslag: titel, de status en een Open-actie, daarna een kaart met regels (label, waarde, hooguit één actie per regel). Voorbeeld: een Odoo instance.

Instellingen

Secties met een korte kop, elk een kaart met regels. Wijzig een waarde in-place op die regel. Destructieve acties als laatste, ingeklapt onder Danger zone.

Flow

Iets aanmaken dat een formulier met controles vraagt, krijgt een eigen pagina (/new): een terug-link, één titel, het formulier. De keuze hoe je iets toevoegt komt daarvoor, in het menu op de knop.

Leeg

Eén gedempte regel en hooguit één actie, binnen een gestippelde rand. Geen illustratie nodig, geen uitleg van de functie.

Welk element, wanneer

Element Gebruik het voor Niet voor
Primaire knop De ene hoofdactie van de pagina (Add Odoo instance, Save). Twee op één scherm; bijzaken.
Outline-knop Elke andere actie op de pagina. De hoofdactie.
Ghost-knop Een actie binnen een regel of tabelcel. Losse acties.
Destructieve knop Verwijderen, opzeggen; alleen in de danger zone, altijd met bevestiging. Alles wat terug te draaien is.
Badge De status van één ding, in één of twee woorden. Meldingen, uitleg, aantallen die een zin nodig hebben.
Alert Een melding over deze pagina of de laatste actie: opgeslagen, mislukt, vraagt aandacht. Vaste uitleg over hoe het product werkt.
Tabel Een lijst van dingen van één soort. De eigenschappen van één ding.
Kaart met regels De eigenschappen van één ding, elk met hooguit één actie. Een lijst van veel dingen.
Dialoog Eén korte stap die geen bewerking is van een waarde op het scherm: bevestigen, een plan kiezen, iets nieuws een naam geven. Flows met controles; een getoonde waarde bewerken.
In-place Een waarde wijzigen die al op het scherm staat (hernoemen, adres wijzigen), op die regel. Iets nieuws aanmaken.
Uitklap Secundaire secties: recente fouten, danger zone, geavanceerde opties. De hoofdinhoud of de hoofdactie.
Schakelaar Aan of uit, direct van kracht. Een keuze in een formulier dat later wordt opgeslagen (gebruik een checkbox).

Kleur betekent status

Groen: werkt. Amber: vraagt iets van de gebruiker. Rood: kapot. Grijs: uit of nog niet begonnen. Paars (accent) is voor de primaire actie en links, nooit voor een status. De rest is neutraal.

Interactieregels

  1. Eén actie per doel per scherm. Starten een banner en een knop hetzelfde, houd er één.
  2. Een klik op een actie opent de actie, niet een pagina die om nog een klik vraagt.
  3. Zeg elk feit één keer per scherm.
  4. Toon toestand, geen opties: de status staat in de lijst, zonder iets te openen.
  5. Stil als het goed gaat: toon alleen waar de gebruiker iets mee moet.
  6. Klap nooit een formulier of paneel open onder een lijst; het oog blijft bij de knop.
  7. Eén soort ding heeft één lijstcomponent, overal hergebruikt.
  8. Klaar betekent geklikt: voer elke gewijzigde actie uit en beoordeel het scherm direct na de klik, op desktop en op telefoon.
  9. Meerdere manieren voor één actie (een bestaande koppelen of een nieuwe maken) zijn een menu op de knop van die actie, nooit een pagina die alleen vraagt welke manier. Een manier die niet beschikbaar is, blijft in het menu staan, uitgeschakeld, met de reden.

Snelheid

Een scherm voelt goed als het direct reageert. Deze getallen zijn de grens, gemeten op een telefoon uit het middensegment (4x CPU-vertraging, trage 4G).

  1. Elke klik geeft binnen 100 ms zichtbaar antwoord: de knop drukt in, de rij licht op, de dialoog opent. Het volgende beeld staat er binnen 200 ms (INP).
  2. Duurt laden langer dan 300 ms, toon dan een skelet in de vorm van wat komt: dezelfde regels, kaarten en kolommen, gedempt. Daaronder geen skelet, dat flitst alleen. Geen spinner over een hele pagina.
  3. Duurt iets langer dan 10 seconden, zeg dan wat er gebeurt en hoe ver het is: "Installing apps, 3 of 7".
  4. Beweging loopt op 60 fps en duurt 150 tot 200 ms. Animeer alleen transform en opacity. Bij prefers-reduced-motion: geen beweging.
  5. Geen taak blokkeert de pagina langer dan 50 ms. Een lijst van honderden regels pagineert of virtualiseert.

Schrijven voor de interface

Product-UI volgt onze tone of voice, maar strakker: de lezer zit midden in een taak. Productschermen zijn in het Engels.

  • Overal alleen een hoofdletter aan het begin: titels, knoppen, labels, koppen.
  • Knoppen zijn een werkwoord en het ding: "Add Odoo instance", "Remove", "Back up now". Nooit "Click here" of een kale "OK".
  • Schrijf klein. Zeg wat te doen, niet hoe het systeem werkt. Titel één regel, geen uitlegregel eronder; uitleg hooguit één zin. Halveer je eerste versie. Heeft het scherm daarna nog meer woorden nodig, dan is het scherm fout, niet de tekst.
  • Statuswoorden noemen een toestand, kort: Connected, No key, Off, Running, Stopped, Down.
  • Foutmeldingen zeggen wat er gebeurde en wat te doen, in één of twee zinnen, zonder codes: "Our server did not answer. Try again in a minute."
  • Bevestigingen: de titel stelt de vraag met het ding ("Remove this Odoo instance?"), de tekst noemt het gevolg, de knop herhaalt het werkwoord ("Remove").
  • Tijd en getallen zoals mensen ze lezen: "2 Oct, 03:00 UTC", "3 of 50 calls today".
  • Geen em-dashes. Geen buzzwords. Lees nieuwe teksten één keer terug op AI-taal voor livegang.

Vaste termen

Zeg Betekent Nooit
Odoo instance Eén Odoo (een adres en een database) die een workspace koppelt of die wij hosten. an Odoo, Odoos, database, connection
Odoo Het product of de app zelf: "Open Odoo", "Apps in Odoo". het ding dat een gebruiker toevoegt
Server Draagt Odoo instances. Van ons: "Pantalytics server" (shared of yours). De rest: "Other hosting". host, machine, VM
Workspace De teamruimte die Odoo instances, leden en facturatie bezit. team, organisation, tenant
Member, Administrator Een persoon in een workspace, en de rol die dingen mag wijzigen. user (als rolnaam), owner
AI connector De koppeling tussen een AI-client (Claude, ChatGPT) en Odoo MCP Pro. integration, plugin
Key De eigen API-sleutel van een lid op een Odoo instance. token, credential, password (voor een API-sleutel)
Agent Een AI-identiteit in Odoo: draait als de persoon die vraagt, of als een eigen gebruiker met eigen rechten. bot, assistent (als productnaam), AI-gebruiker

Voorbeeld

Niet zoAdd Odoo
Wel zoAdd Odoo instance
Niet zoOur servers could not process your request (error 503). Please contact support if the issue persists.
Wel zoOur server did not answer. Try again in a minute.

Minder is meer: de luie gebruiker

AI voegt standaard toe: nog een titel, een ondertitel, een uitleg, een tweede knop, nog een feature. Wij halen weg. Elk scherm beantwoordt in één blik "waar tik ik?", en het antwoord is een actie.

De poort voor livegang is een luie gebruiker: half dronken, of vier jaar oud. Hij ziet alleen een screenshot, op desktop- en telefoonbreedte, en een taak van één regel. Hij noemt zijn eerste tik. Een verkeerde tik, twee kandidaten of een zin die hij moest lezen betekent dat het scherm fout is, niet de gebruiker. Wat hij negeerde en geen taak nodig had, halen we weg.

Binnen Odoo

In een Odoo-module leeft de gebruiker de hele dag in Odoo, dus onze schermen zien eruit en werken als Verkoop en CRM. Odoo's frame, onze terughoudendheid: onze smaak zit in wat we weglaten, niet in hoe we Odoo verven.

Zone Wat Regel
Native Navbar, app-menu, breadcrumbs, control panel, zoeken, chatter, settings-layout, thema, telefoonschil. Nooit restylen, patchen of vervangen.
Terughoudend Formulieren, lijsten, kanban, wizards, velden, knoppen, badges, inhoud van settings. Odoo's widgets, onze regels: één primaire actie, kleur betekent status, korte tekst, zo min mogelijk velden.
Van ons Schermen waar Odoo geen patroon voor heeft, zoals een inbox of een setup-checklist. Onze layoutregels, gebouwd uit Odoo's onderdelen en kleuren, binnen Odoo's frame.

Niet in de Odoo-backend: onze accentkleur, Murecho, shadcn/ui-componenten of labels in zinsnotatie. Labels volgen Odoo's Title Case naast Odoo's eigen labels.

Hoe de interface van Odoo in elkaar zit, scherm voor scherm, met geannoteerde screenshots: Odoo UI.

De volledige regels voor AI en developers: de skill pantalytics-odoo-ui.

Voor livegang

  • De pagina is een van de vijf types, met één primaire actie.
  • Elk element wordt gebruikt waarvoor de tabel hierboven het noemt.
  • Kleur alleen voor status; accent alleen voor de primaire actie en links.
  • Tekst: alleen beginhoofdletter, werkwoord plus ding, vaste termen, geen uitleg, niets dat korter kan.
  • Elke gewijzigde actie geklikt en direct erna beoordeeld, op desktop en 390px.
  • De luie gebruiker slaagt: één screenshot en een taak van één regel, eerste tik goed zonder een zin te lezen.