Varför behöver ett internt system designprinciper, och vad ska de säga?
Olle Krantz
Designprinciper är skrivna regler för hur ett system ser ut, beter sig och är uppbyggt, till exempel hur knappar placeras, hur felmeddelanden skrivs och hur data namnges. De gör att kvaliteten blir densamma oavsett vem som skriver koden, och att nya funktioner känns igen av användarna. De blir särskilt viktiga när flera personer, eller en AI, bygger i samma system.
Utan regler byggs varje funktion på sitt sätt
I ett system som växer under flera år bygger många personer. Utan gemensamma regler får varje funktion sin egen känsla: spara-knappen sitter på olika ställen, datum skrivs på tre sätt och felmeddelanden säger olika saker. Användarna märker det som att systemet är krångligt, och den som ska underhålla det märker det som att allt måste läsas om från början.
Designprinciper löser det genom att besluta saker en gång. Då behöver ingen fundera på dem igen, och resultatet beror inte på vem som råkade bygga just den delen.
Sex områden som principerna bör täcka
- Utseende och placering. Färger, avstånd, var de vanligaste knapparna sitter och hur listor och formulär ser ut.
- Språk. Hur felmeddelanden och knappar formuleras. ”Kunde inte spara, kontrollera org.nummer” är bättre än ”Fel 500”.
- Namn. Samma sak heter samma sak överallt, både på skärmen och i databasen. Det som kallas kund på ett ställe ska inte heta klient på ett annat.
- Beteende. Vad som händer när man sparar, avbryter eller tar bort. Ska man bekräfta en borttagning? Svaret ska vara detsamma i hela systemet.
- Behörigheter. Hur man avgör vem som får se och göra vad, och att det görs på samma sätt överallt.
- Hur koden skrivs. Struktur och regler som gör att en ny person kan läsa vilken del som helst. Det ger också ett bättre underlag för tester.
Varför det spelar ännu mer roll med AI
När delar av koden skrivs av ett AI-verktyg blir principerna det som styr resultatet. AI:n följer de regler den får, och kontrollerna kan avgöra om den gjort det. Utan principer får ni kod som fungerar men ser olika ut överallt, vilket gör den dyrare att ändra. Se Test-robotar som klickar igenom systemet för hur kontrollerna kan göras automatiska.
Hur man får principerna att hålla
- Skriv dem kort. Några sidor som någon faktiskt läser, inte en bok.
- Visa exempel. En bild eller ett kodstycke säger mer än en beskrivning.
- Kontrollera automatiskt där det går. Regler som bara finns på papper glöms.
- Uppdatera dem. När ni bestämmer något nytt skrivs det in, annars lever ni med två regler.
Frågor att ställa till en leverantör
- Finns skrivna designprinciper för det ni bygger åt oss?
- Får vi läsa dem, och äger vi dem?
- Hur kontrolleras att nya funktioner följer dem?
- Vad händer med dem om ni byts ut? Se Kan vi äga ett eget system utan en egen utvecklare?.
Nästa steg
Altu bygger skräddarsydda system med tydliga designprinciper, så att kvaliteten inte hänger på en enskild person. Hör av er om ni vill se hur det kan se ut.