Files
boc/docs/design/LANDVEX_DESIGN_CONSTITUTION.md
T
Bernt 5beb8fb640 docs: Capability Parity Principle + Definition of Done update
- LANDVEX_DESIGN_CONSTITUTION.md:
  - Added §0a: Capability Parity Principle
  - All user functions must work on smartphone
  - Desktop may enhance, never require
  - Two-question rule for every new feature
  - Desktop as enhancer (not exclusive)
  - Examples: Payments, History, KYC
  - Verification checklist for every new feature

- RFC_DEFINITION_OF_DONE.md:
  - Added criterion #3: Capability Parity
  - Can be used on smartphone; desktop is enhancement
  - Total criteria: 14 (was 13)
  - Exit criteria: must pass all 14

Rationale: quiXzoom targets field workers. Phone is primary or only
computer. Phone must always be a full client. Desktop is a more
comfortable workspace for some tasks, not a prerequisite. This is a
constitutional principle, not implementation.
2026-07-02 11:40:57 +00:00

8.5 KiB
Raw Blame History

LANDVEX DESIGN CONSTITUTION

DEL 1.4 — ENTERPRISE UX DOCTRINE

"Designing for Professionals, Not Visitors"

Version 1.0
Status LOCKED
Scope Landvex Enterprise Platform
Authority Highest authority for UX, UI, Design System, Interaction Design, Visual Language, Information Architecture

0. FROM REALITY → DECISION

Landvex har ett enda syfte: omvandla verklighet till handling.

De fem stegen:

  1. Du har en fråga — Vad vill du veta?
  2. Vi samlar verkligheten — Mobiler, drönare, kameror
  3. Vi analyserar — Vi hittar det som inte stämmer
  4. Vi räknar om — Allt blir ett betyg (0100)
  5. Du får ett beslutsunderlag — Inom 2472 timmar

Tresekundersregeln:

  • 3 sekunder: Förstå vad systemet gör
  • 10 sekunder: Förstå processen från fråga till beslut
  • 60 sekunder: Förstå varför resultatet är användbart

Mätaren: Video → AI → Betyg. På en sekund: "Video blir ett betyg." Det är Landvex.


0a. CAPABILITY PARITY PRINCIPLE

Alla användarfunktioner ska kunna utföras från en smartphone.

Desktop får utöka upplevelsen, men aldrig vara ett krav.

The Rule

Varje ny funktion måste besvara två frågor:

Fråga Krav
Går detta att göra i appen? Ja (obligatoriskt)
Kan desktop göra det bekvämare? Ja (valfritt)

Om svaret på första frågan är nej ska funktionen inte godkännas.

Desktop as Enhancer

Desktop kan vara bättre på:

  • Längre historik
  • Avancerad filtrering
  • Export till PDF/CSV
  • Utskrifter
  • Stora tabeller
  • Bokföringsunderlag
  • Flera fönster samtidigt

Men det är en förbättring av användarupplevelsen — inte en exklusiv funktion.

Examples

Utbetalningar:

  • 📱 App: Se saldo, se kommande utbetalning, ladda ned PDF, dela PDF, exportera CSV, skicka till e-post, visa årsöversikt
  • 🖥 Desktop: Samma funktioner, men dessutom större tabeller, flera rapporter samtidigt, bekvämare utskrift

Historik:

  • 📱 App: Filtrera datum, sök, exportera, visa kvitton
  • 🖥 Desktop: Exakt samma funktioner, men fler rader på skärmen

KYC:

  • 📱 App: Kamera, NFC, Face ID, biometrisk verifiering — bättre i mobilen
  • 🖥 Desktop: Visa status

Verification

För varje ny funktion:

  • Kan en användare utföra hela arbetsflödet i appen?
  • Kräver ingen del en dator?
  • Om desktop erbjuder mer, är det en produktivitetsförbättring och inte en exklusiv funktion?

1. INTRODUKTION

Landvex är inte en traditionell webbplats.

Den är inte byggd för att konsumera innehåll.

Den är inte byggd för att sälja en produkt.

Den är byggd för att människor ska kunna fatta beslut snabbare, säkrare och med högre precision.

Det innebär att UX-designen måste utgå från professionellt arbete.

Målet är inte "en trevlig upplevelse".

Målet är:

  • snabbare beslut
  • färre misstag
  • högre precision
  • mindre mental belastning
  • bättre situationsförståelse

2. DEN PROFESSIONELLA ANVÄNDAREN

Vi designar inte för en genomsnittlig internetanvändare.

Vi designar för personer som arbetar.

Exempel:

  • analytiker
  • kommuner
  • entreprenörer
  • fastighetsägare
  • infrastrukturförvaltare
  • driftorganisationer
  • beslutsfattare
  • operatörer
  • projektledare
  • inspektörer

De använder systemet under längre arbetspass.

De kommer tillbaka dag efter dag.

UX ska därför bli bättre ju mer systemet används.


3. MENTAL ENERGI ÄR DEN VIKTIGASTE RESURSEN

Varje onödigt beslut kostar energi.

Exempel på onödiga beslut:

  • "Var finns knappen?"
  • "Är detta klickbart?"
  • "Vad betyder den här ikonen?"
  • "Vilken sida är jag på?"
  • "Vad händer om jag klickar?"

Designens uppgift är att eliminera dessa frågor.


4. LANDVEX SKA ALDRIG KÄNNAS SOM EN WEBBPLATS

När användaren arbetar ska känslan vara:

"Jag arbetar i ett professionellt system."

Inte:

"Jag surfar runt."

Det påverkar:

  • navigation
  • layout
  • komponenter
  • animationer
  • laddning
  • återkoppling
  • arbetsflöden

5. DEVICE ADAPTIVE — INTE DESKTOP FIRST ELLER MOBILE FIRST

Landvex är Device Adaptive.

Samma identitet. Olika optimeringar.

Enhet Fokus
Telefon Touch-first, snabb navigering, förenklade arbetsflöden
Surfplatta Hybrid, balans mellan översikt och detalj
Desktop Hög informationsdensitet, multitasking, avancerade paneler

Konflikt mobil/desktop: kontexten bestämmer, inte enhetsförsta princip.


6. KONTINUITET

När användaren går mellan:

Dashboard → Kartor → Objekt → Rapporter → Inställningar → Administration

ska hjärnan aldrig behöva "ställa om".

Det ska kännas som samma arbetsyta.


7. INFORMATION HAR HÖGST STATUS

Information ska alltid dominera designen.

Design ska aldrig dominera informationen.

Om något konkurrerar med datan ska det reduceras.


8. VISUELL TYSTNAD

Landvex ska kännas lugnt.

Det betyder inte tomt.

Det betyder kontrollerat.

Undvik:

  • blinkande element
  • starka gradients
  • färgexplosioner
  • stora illustrationer
  • marknadsföringsgrafik

Eftersträva:

  • lugn
  • precision
  • rytm
  • balans

9. ANVÄNDAREN SKA ALDRIG TVEKA

Varje arbetsflöde ska vara självförklarande.

Om en användare behöver fundera på nästa steg har designen misslyckats.


10. KARTAN ÄR EN DEL AV IDENTITETEN

Landvex arbetar med geodata.

Det ska märkas.

Men subtilt.

Kartlagren ska fungera som ett visuellt DNA.

Inte som innehåll.

Mapbox används för att skapa:

  • geometrier
  • koordinater
  • topografi
  • lågmälda vägnät
  • diskreta höjdlinjer

Allt med mycket låg visuell intensitet.


11. MIKROINTERAKTIONER

Mikrointeraktioner ska ge användaren trygghet.

Exempel:

Hover → Visuell respons → Klick → Omedelbar återkoppling → Laddning → Slutfört

Användaren ska aldrig undra om systemet registrerade en handling.


12. FEL SKA VARA PEDAGOGISKA

Felmeddelanden ska:

  • förklara problemet
  • förklara varför
  • förklara lösningen
  • undvika teknisk jargong när den inte behövs

Fel ska hjälpa användaren vidare.

Inte stoppa användaren.


13. TOMMA LÄGEN ÄR PRODUKTEN

En tom lista är inte ett undantag.

Den är en designad upplevelse.

Varje tom vy ska:

  • förklara varför den är tom
  • visa nästa steg
  • inte kännas trasig

14. LADDNING ÄR EN DESIGNUPPGIFT

Visa aldrig:

  • vit sida
  • tom sida
  • hoppande layout

I stället:

  • Skeletons
  • Placeholder-data
  • Progress
  • Stegindikatorer
  • Mjuk övergång

15. HASTIGHET ÄR EN UX-FUNKTION

All design ska stödja upplevd snabbhet.

Målet är inte bara hög teknisk prestanda.

Målet är att användaren upplever systemet som omedelbart.


16. FOKUS

Varje sida ska ha ett primärt syfte.

Om användaren öppnar en vy ska det vara uppenbart:

  • Vad är huvuduppgiften?
  • Vad är sekundärt?
  • Vad är historik?
  • Vad kräver handling?

17. DASHBOARDS SKA BERÄTTA EN HISTORIA

Dashboarden ska inte vara en samling widgets.

Den ska guida användaren genom:

Situation → Analys → Prioritering → Beslut → Åtgärd → Resultat


18. AI SKA KÄNNAS NATURLIG

AI ska förstärka arbetsflödet. Inte dominera det.

AI ska:

  • föreslå
  • sammanfatta
  • prioritera
  • flagga avvikelser
  • identifiera risker

AI ska aldrig ta över användarens kontroll utan tydlig återkoppling.


19. INGEN SIDAS DESIGN ÄR "KLAR"

Varje release ska innehålla:

  • UX-review
  • Design-review
  • Screenshot-review
  • Regression-review
  • Accessibility-review
  • Performance-review

Varje förbättring ska göra hela systemet mer sammanhållet.


20. ENTERPRISE DEFINITION

Landvex uppnår enterprise-nivå när användaren:

  • inte tänker på designen
  • inte letar efter funktioner
  • inte tvekar
  • inte tvivlar på systemets stabilitet

utan kan fokusera helt på sitt arbete.

Det är den högsta formen av användarupplevelse.


21. DOKTRIN

Landvex ska inte imponera genom effekter.

Landvex ska imponera genom att upplevas:

  • genomtänkt
  • pålitligt
  • konsekvent
  • snabbt
  • precist
  • och självklart.

När användaren glömmer att gränssnittet finns och enbart fokuserar på uppgiften har designen uppnått sitt syfte.


ÄNDRINGSHISTORIA

Version Datum Beskrivning
1.0 2026-07-02 Ursprunglig version, baserad på Erik Svensson Design Constitution DEL 1.4

STATUS

LOCKED

  • Mindre revideringar: 1.x-serien
  • Brytande ändringar: Kräver Architecture Review, ny major-version (2.0+)