boc/docs/design/LANDVEX_DESIGN_CONSTITUTION.md

# 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 (0–100)
5. **Du får ett beslutsunderlag** — Inom 24–72 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+)