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
- Eén actie per doel per scherm. Starten een banner en een knop hetzelfde, houd er één.
- Een klik op een actie opent de actie, niet een pagina die om nog een klik vraagt.
- Zeg elk feit één keer per scherm.
- Toon toestand, geen opties: de status staat in de lijst, zonder iets te openen.
- Stil als het goed gaat: toon alleen waar de gebruiker iets mee moet.
- Klap nooit een formulier of paneel open onder een lijst; het oog blijft bij de knop.
- Eén soort ding heeft één lijstcomponent, overal hergebruikt.
- Klaar betekent geklikt: voer elke gewijzigde actie uit en beoordeel het scherm direct na de klik, op desktop en op telefoon.
- 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).
- 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).
- 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.
- Duurt iets langer dan 10 seconden, zeg dan wat er gebeurt en hoe ver het is: "Installing apps, 3 of 7".
- Beweging loopt op 60 fps en duurt 150 tot 200 ms. Animeer alleen transform en opacity. Bij prefers-reduced-motion: geen beweging.
- 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
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.