Hoppa till innehållet

Visionssidan

Yta

Förklarar varför startsidan och ekosystemet finns, vart de ska, och vilka principer som ska hålla när många bygger samtidigt.

källa: apps/projekt/src/app/vision/page.tsxuppdaterad:

Ansvar

  • Säga syftet med Min startsida – en väg in till rätt stöd när det behövs, för varje medarbetare – i kort form och i sin helhet, direkt efter inledningen. Samma text visas i målbilden på /kravbild och i presentationen.
  • Bära visionen och det övergripande målet i klartext, hämtade ur beslutsunderlaget för initiativet – inte omskrivna. Nuläge, problembild och mål står som tre kort bredvid varandra, med punkter i stället för löptext.
  • Visa målbilden som fyra förflyttningar från nuläge till önskat läge, så att den går att mäta mot.
  • Lista grundprinciperna visuellt och pedagogiskt: en regel att pröva ett bygge mot, skälet bakom, och ett exempel på hur principen redan syns i prototypen.
  • Vara publik. Sidan ligger utanför spärren och får därför inte nämna interna namn, kostnader eller riktiga personer.
  • Aldrig innehålla produktlogik. Det är en textsida, hårdkodad, utan data och utan roll.

Filer

Tabell: Sökväg, Roll
SökvägRoll
app/vision/innehall.tsAllt innehåll: vision, nuläge, problembild, mål, förflyttningar, lösningen, strategisk betydelse, utgångspunkter, arbetssätt, konsekvenser, principer. En källa för sidan och presentationen.
app/vision/page.tsxSidan: byggstenarna överst, de sju kapitlen under. I huvudmenyn direkt efter Start.
app/vision/Undermeny.tsxUndermenyn med länkar till kapitlen. Klistrar under toppraden och sätter sin höjd som --undermeny-hojd.
app/vision/StartaPresentation.tsxKnappen som begär helskärm på klicket och sedan navigerar till presentationen i samma dokument.
app/vision/presentation/page.tsxPresentationsrutten. Ingen topprad, inget skal.
app/vision/presentation/Presentation.tsxBildvisaren: bilderna ur innehållet, tangentbord, helskärm, förlopp och ?bild= per bild.
app/vision/presentation/vision2022.pngKommunkoncernens målbild från 2022, chefens översikt. Visas inramad på bilden Varför nu.
atkomst/kod.ts/vision står i listan över öppna vägar.

Kontrakt

  • Utgångspunkterna är två, i samma kortform och med en bild var i presentationen: AI för allt (AI används i allt vi gör tills vi stöter på en gräns, och begränsningar firas) och Byggt för att delas (en produkt andra kommuner och organisationer kan installera och använda, öppen källkod under MIT). Under den tretton principer i tre grupper: för den som använder den (4), för det som byggs (5), för hur vi arbetar (4). Numreringen är löpande 1–13. Principerna visas inte just nu: de ligger kvar i innehall.ts och renderas av PrincipKort bakom flaggan VISA_TRETTON_PRINCIPER i page.tsx, och ingår inte i presentationen. Utgångspunkten är det man ska ta med sig från sidan; principerna publiceras när de är förankrade. Delbarheten mellan kommuner (princip 6) är en bärande princip för den tekniska lösningen: grundtjänster som e-post, SMS och grunddata får vara externa beroenden, tjänster med mycket egen logik får det inte.
  • Varje princip har fyra fält: titel, regel, text och exempel. Exemplet ska peka på något som finns i prototypen i dag – ändras prototypen så att exemplet inte längre stämmer, ändras exemplet i samma commit.
  • Källorna är beslutsunderlaget för initiativet (vision, mål, förflyttningar, arbetssätt), docs/plan.md (skal och moduler, faser, risker) och besluten i docs/beslut/. Principer som inte har stöd i någon av dem hör inte hemma här.
  • Konsekvenserna är ett eget kapitel sist: tre områden att se över (designsystemet och UX-processerna, tekniska ramverk, AI-native integrationsmöjligheter), hållna öppna, med frågan som ska besvaras, punkter att se över och påverkan, och landningen i en gemensam devportal med testet att en agent ska kunna bygga en modul utan att fråga en människa. Fem bilder i presentationen.
  • Arbetssättet är prototypdriven utveckling ur kommunens AI-drivna utvecklingsprocess: idé vid samma bord, fungerande prototyp inom en timme på syntetisk data, iteration med verksamheten tills det känns rätt, sedan spec och långsiktig funktion med prototypen som förlaga. Eget kapitel på sidan och egen bild i presentationen.
  • Lösningen är ett eget kapitel efter Målbilden, ritat som två lager: Startsidan som ytan med det användaren möter, Ekosystemet som plattformen under med skal, moduler, flödesmotor, AI-lager, designsystem, devportal och integrationer. Två bilder i presentationen.
  • Den strategiska betydelsen är ett eget mörkblått kapitel efter Lösningen, och två bilder i presentationen: arbetet är formgivande för all utveckling framåt, AI-native i grunden, mindre kod men mer värde, ett designsystem på AI:s villkor, och nästa projekt avgör i stället för arvet.
  • Presentationen på /vision/presentation följer sidan kapitel för kapitel, i samma ordning och med samma kapitelmarkör överst på varje bild. Den bygger sina bilder ur samma innehåll som sidan, utom de tretton principerna som avsiktligt utelämnas. Den lägger inte till egna påståenden; en ny formulering skrivs i innehall.ts och syns på båda ställena.
  • Sidan är fem kapitel med var sin botten och en kapitelmarkör överst (01 Visionen på --color-page, 02 Målbilden på --color-page-deep, 03 Lösningen på --color-page, 04 Strategisk betydelse på --color-sidebar, 05 Utgångspunkter på --color-page-deep, 06 Arbetssättet på --color-page, 07 Konsekvenser på --color-page-deep), följt av ett ljust avslut. Direkt under toppraden ligger visionens undermeny med länkar till kapitlen, på samma --color-page-deep som den aktiva fliken Vision så att den läses som flikens fortsättning, och i huvudmenyns typografi. Från sm och uppåt klistrar den under toppraden och syns hela tiden; dess höjd ingår i scroll-padding (--undermeny-hojd), så att ett kapitel som en länk leder till hamnar under den och inte bakom. På smal skärm radbryts den och klistrar inte. Knappen till presentationen står bara i första kapitlet, inte i undermenyn. Innehållet ligger innanför max-w-[104rem].

Beroenden och beslut

Inga – delen är fristående.

Beslut: ADR-012

Levererar: /vision, /vision/presentation, lösningen i två lager, den strategiska betydelsen, exempel på AI som hjälpreda mot AI-native, i en modal, målbildens fyra förflyttningar, arbetssättet: prototypdriven utveckling, konsekvenserna och landningen i devportalen, utgångspunkterna: AI för allt, byggt för att delas

Kvarstår

  • Första utkast, inte förankrat med programmets styrgrupp. Formuleringarna ska stämmas av med produktansvarig innan sidan visas utåt.
  • Går det att slå ihop två principer utan att förlora något ska de slås ihop.
  • Ingen bild. Målbilden skulle tjäna på en enkel illustration av en yta framför många system.

15 delar i projektportalen · gemensamma i devportalen: ai-adapter, anthropic, bygge, designsystem, dokploy, dokumentation, gemensamt, tokens, ui