Webbplatsplanen

PLAN.md skrivs i samma stund som ett projekts första byggning är klar, och den är avsedd att alltid beskriva webbplatsen så som den är just nu — inte en logg över allt som någonsin hänt med den (det är vad fliken Versioner och ändringsloggen är till för). Skärmen Webbplatsplan tolkar den Markdown-texten till riktigt gränssnitt: en tabell för sidor, en lista för moduler, en checklista för öppna frågor och vanlig löpande text för affärsfakta, varumärke och beslut.

Innan någon byggning är klar finns det inget att läsa än: skärmen visar "Ingen plan ännu", förklarar tydligt att planen skrivs av projektets första byggning, och länkar tillbaka till projektets egen sida i stället för att visa en tom tabell.

En webbplats vars filer kom in utan plan (publicerad från ett annat AI-verktyg via kopplingen, importerad eller uppladdad) får ändå en plan: skärmen startar planen från projektunderlaget, de valda kit-delarna och de uppmätta sidorna, och en banderoll, Den här planen startades åt dig, erbjuder Spara den här planen, vilket gör den till projektets riktiga plan så att varje avsnitt kan redigeras. Läs hela webbplatsplanen går tillbaka till plandokumentet på fliken Plan & underlag.

Verktyg som läggs till senare från Kit (Lägg till i planen) går med i listan Moduler som Planerad med en länk Visa i Kit, även när planens text skrevs innan de lades till.

Under titeln visar en rad när planen senast uppdaterades: "Plan uppdaterad 2 okt., 15:04". Tiden kommer från den senaste gången aiKit mätte webbplatsens riktiga filer, vilket sker efter varje ändring (en chattredigering, en fästning, ett kit-tillägg, en återställning, en manuell redigering av planen, en publicering från ett annat AI-verktyg).

Överst, när en plan finns: en övergripande förloppsindikator i procent och tre rutor under den: Byggda sidor (av planerade sidor), Byggda moduler (av valda moduler) och Besvarade frågor (av planens öppna frågor). Varje ruta är en knapp som rullar till avsnittet den räknar. Inget av detta rapporteras av planens text själv: en sida räknas som byggd först när aiKit har hittat den i webbplatsens riktiga filer; en modul räknas som byggd endast utifrån den verifierade byggrapporten eller modulen som hittats i filerna; och en fråga räknas som besvarad när raden är bockad i planen eller kunden har svarat på den på sin sida Frågor.

Två saker gör att planen hamnar efter, och skärmen visar vilken: AI-steget som skriver om planen efter en ändring blev inte klart ("Den skrivna planen uppdaterades inte efter den senaste ändringen", med orsaken), eller så har webbplatsen en nyare version än den plan mättes mot ("Webbplatsen ändrades efter att den här planen senast uppdaterades"). I båda fallen visas en knapp "Uppdatera plan". Sidan kör den aldrig av sig själv när du öppnar den (att öppna en sida använder aldrig AI); motorn lägger redan in varje ändring i planen i bakgrunden, och knappen finns där för när det inte hann med. Uppdatera plan lägger in den senaste ändringen i den skrivna planen och mäter webbplatsen igen. Om det fortfarande inte går igenom ligger bannern kvar med vad som gick fel, och du kan trycka på Uppdatera plan igen eller redigera planen för hand.

Hälsokortet ger webbplatsen ett poäng av 100 utifrån regler som aiKit kontrollerar i de riktiga filerna, aldrig utifrån AI:ns åsikt: en saknad eller upprepad sidtitel eller sökbeskrivning, en sida utan huvudrubrik eller med fler än en, en länk till en sida som inte finns, en sida som ingen länkar till och som menyn inte tar med, bilder utan beskrivning för skärmläsare, mycket korta sidor, ett formulär utan mottagare, och en modul som briefen begärde men som inte finns på webbplatsen. Varje problem anger vilken sida det gäller och varför det spelar roll, och har en knapp Åtgärda: Åtgärda skickar problemets färdiga instruktion som en begäran och lämnar den till AI. Knappen visar "Åtgärd begärd" medan det pågår, och poängen mäts om när ändringen har landat. Filtrera listan efter allvarlighetsgrad med antalen Hög, Medel och Låg, och "Visa alla" tar bort filtret.

Webbplatskartan ritar webbplatsen som ett träd: startsidan överst, sedan menyn i ordning, och sedan sidor som nås från dem. Sidor som ingen länkar till ligger i en egen grupp. Sidor som planen listar men som inte är byggda ännu ritas streckade och märks Planerad. Byggda sidor som planen inte nämner märks "Inte i planen" med en knapp "Lägg till i plan" som lägger till dem i avsnittet Sidor.

Tryck på valfri sida (i webbplatskartan eller listan Sidor) för att öppna dess information bredvid planen. Adressfältet ändras till ?page=/about, så länken öppnar samma sida för alla i teamet. Informationen visar hur sidan ser ut i Google (titel, adress, beskrivning), dess avsnitt och huvudrubriker, antal ord, bilder och hur många som saknar beskrivning, dess formulär och vilken kitmodul som kör dem, om kunden godkände sidan, och den senaste ändringen: när, vem som bad om den och vad som efterfrågades.

Historik visar de versioner aiKit sparar (originalet och de 10 senaste), nyast först: versionsnumret, vilken typ av ändring det var (Första byggnation, Chatt, Fäst, Kit, Publicerad, Återställ eller Planändring), när, vad som begärdes, vem som begärde det, och vilka sidor som ändrades (tryck på en sida för att öppna dess information). Den nyaste märks Aktuell version. Alla äldre har "Återställ den här versionen", som frågar först och sparar det aktuella läget innan webbplatsen återställs, så en återställning kan ångras. De tre första visas; "Visa alla" listar resten.

Avsnittet Företagsuppgifter jämför telefon, e-post, adress och öppettider i kundfilen med texten på de byggda sidorna (startsidan och kontakt först). Varje uppgift visar "På webbplatsen" eller "Hittades inte på webbplatsen" (med hur många sidor som kontrollerats, eftersom webbplatsen kan visa ett gammalt värde), och en länk "Redigera i kundfilen" gör att kundfilen förblir den källa som gäller.

• Sidor — en tabell med Sida, Sökväg, Syfte och Status (Byggd eller Planerad), med en riktig länk "Visa" till den publicerade sidan när den är både byggd och webbplatsen är live.
• Moduler och verktyg — varje modul planen listar, var och en med en etikett Byggd eller Planerad och en egen anteckning.
• Företagsuppgifter — öppettider, adress, tjänster, priser och allt annat sakligt om företaget, skrivet som vanlig text.
• Varumärke — färgpaletten, tonen och eventuella stilanteckningar som planen har sparat.
• Beslut — verkliga beslut som har fattats och inte ska ifrågasättas igen i nästa redigering.
• Öppna frågor — en checklista över sådant som verkligen fortfarande är obestämt, där varje fråga visar besvarad eller fortfarande öppen.

Varje avsnittskort har samma två knappar. "Redigera" öppnar avsnittets råa Markdown i en enkel textruta och sparar det direkt tillbaka i PLAN.md. Det är en verklig, omedelbar skrivning (via projektets egna PUT-slutpunkt), men den startar medvetet inte någon byggnation eller publicering; den ändrar bara vad planens dokument säger, precis som att redigera vilken annan anteckning som helst.

"Begär en ändring" är avsiktligt något annat: det öppnar ett litet formulär ("Vad vill du ändra i <avsnitt>?"), och när du skickar det skapas en riktig begäran på projektets fliken Feedback. Den märks "Webbplatsplan – <Avsnitt>: …" precis som vilken pin eller snabbredigeringsbegäran som helst, med egen statusordning och en länk "Visa begäran" när den har skickats. Använd Redigera när du själv vill rätta eller skriva om planens egen text. Använd Begär en ändring när du vill att själva webbplatsen, och därmed planen, ska uppdateras så att de stämmer överens.

Planen har två lager. Mätningarna (sidor, titlar, avsnitt, länkar, formulär, moduler, hälsa) tas av kod från de riktiga filerna efter varje ändring, så de kan inte glida isär. Den skriftliga planen (mål, affärsfakta, varumärke, beslut, öppna frågor) hålls uppdaterad av ett AI-steg som körs efter varje ändring och bara skriver om de delar som ändringen berörde. Den lägger aldrig till någon ändringslogg eller daterade poster; Historik är där ändringarna dokumenteras.

Om AI-steget misslyckas lämnas den skriftliga planen oförändrad i stället för att skrivas om halvvägs, misslyckandet loggas, och skärmen visar Uppdatera plan (se ovan) i stället för att tyst visa en föråldrad plan.

En panel bredvid planen innehåller åtgärderna (på telefon blir panelen en knapp i full bredd, "Kopiera kundlänken", direkt under förloppsfältet, med resten dolt under "Fler åtgärder (3)"). "Dela med kunden" kopierar en skrivskyddad länk (aikit.ai/p/<project>/plan) – inga personalverktyg, inga redigeringsknappar, inget internt. "Öppna den publicerade sajten" är en direktlänk till den publicerade sajten, eller så säger panelen tydligt "Inte publicerad än" om den inte är det. "Filer" visar det verkliga antalet filer med en utfällbar lista över varje fils sökväg och storlek. "Ladda ner planen" laddar ner den aktuella PLAN.md som en riktig .md-fil, exakt byte för byte det skärmen läser – inte en genererad sammanfattning.

Kundens sida öppnas på fliken Plan. Det är samma webbplansdokument som personalen ser på fliken Plan & underlag (översikt och mål, målgrupp, strategi, webbplatskarta, varje verktyg med vad det gör för deras företag och dess status, innehållsplan, tidslinje, beslut och öppna frågor), utan de interna delarna: inga anteckningar som skrevs när ett verktyg lades till, inga namn på vem som lade till vad, inga länkar till aiKits Kit och ingen knapp Skriv planen. En andra flik, Sidor & godkännanden, visar den sida-för-sida-vyn nedan.

På Sidor & godkännanden, skyddat av samma åtkomstkod som de redan använder för att lämna feedback (ingen separat inloggning), ser kunden samma förloppsfält, en webbplatskarta över deras sidor, sidlistan med länkarna "Visa", modulerna, affärsfakta, varumärke, beslut och öppna frågor, samt en rad "Plan uppdaterad". De får inte Hälsa, åtgärdsanvisningar, Historik, vem som bett om vad, fillistan eller några knappar för Redigera eller Begär en ändring.

Allt som personalen markerar för egen del tas bort på servern innan sidan skickas, i alla avsnitt: en rad som innehåller "(internal)", "[internal]" eller "(staff only)", en rad som börjar med "Internal:" eller "Staff only:", varje avsnitt vars rubrik säger Internal eller Staff only, samt dolda kommentarer. Dessa rader når aldrig kundens webbläsare, inte ens i sidans nätverksdata.

Varje byggd sida har en knapp Godkänn. Kunden skriver sitt namn (och en valfri kommentar) och godkänner; godkännandet kopplas till sidans exakta innehåll, så om sidan ändras senare visas "Ändrad sedan du godkände" och frågan ställs igen. Bara någon som använder kundens åtkomstkod kan godkänna. Om du öppnar kundlänken när du är inloggad som personal ser du varje sidas godkännandestatus men ingen knapp Godkänn, så att ingen kan godkänna åt kunden. På personalens Webbplansöversikt visar godkända sidor "Godkänd av kund" och ändrade sidor "Ändrad sedan godkännande."

En knapp "Skicka feedback" finns längst ned: om sajten är publicerad öppnas den riktiga publicerade sajten med feedbackverktyget redan påslaget (med kundens egen åtkomstkod); om den inte är publicerad än visas i stället kundens sida Senaste uppdateringar.