Plan stranice

PLAN.md se piše čim je prva izrada projekta završena i namijenjen je tome da uvijek opisuje stranicu onakvom kakva je upravo sada, a ne kao dnevnik svega što se ikad dogodilo (za to su kartica Verzije i Dnevnik promjena). Ekran Plan stranice raščlanjuje taj Markdown u stvarno sučelje: tablica za stranice, popis za module, popis za otvorena pitanja i običan tekst za poslovne činjenice, brend i odluke.

Dok nijedna izrada nije završena, nema što čitati: ekran prikazuje "Još nema plana", jasno objašnjava da plan piše prva izrada projekta i vodi natrag na stranicu samog projekta umjesto da prikazuje praznu tablicu.

Stranica čije su datoteke stigle bez plana (objavljene iz drugog AI alata putem konektora, uvezene ili učitane) i dalje dobiva plan: ekran započinje plan iz sažetka projekta, odabranih komponenti kita i izmjerenih stranica, a traka Ovaj plan je započet za tebe nudi Spremi ovaj plan, što ga čini stvarnim planom projekta pa se svaki odjeljak može uređivati. Pročitaj cijeli plan stranice vodi do dokumenta plana na kartici Plan i sažetak.

Alati dodani kasnije iz kita (Dodaj u plan) pridružuju se popisu Moduli kao Planirano s poveznicom Pogledaj u kitu, čak i kad je tekst plana napisan prije nego što su dodani.

Ispod naslova jedan redak pokazuje kada je plan zadnji put ažuriran: "Plan ažuriran 2. lis, 15:04". To vrijeme dolazi iz zadnjeg puta kad je aiKit izmjerio stvarne datoteke stranice, što se događa nakon svake promjene (uređivanje u chatu, oznaka, dodavanje iz kita, vraćanje, ručno uređivanje plana, objava iz drugog AI alata).

Na vrhu, kada plan postoji: traka ukupnog napretka u postocima i tri pločice ispod nje: Izrađene stranice (od planiranih stranica), Izrađeni moduli (od odabranih modula) i Odgovorena pitanja (od otvorenih pitanja iz plana). Svaka pločica je gumb koji se pomiče do odjeljka koji broji. Ništa od toga ne određuje sam tekst plana: stranica se smatra izrađenom samo kada je aiKit pronašao u stvarnim datotekama web-mjesta; modul se smatra izrađenim samo iz provjerenog izvješća o izradi ili modula pronađenog u datotekama; a pitanje se smatra odgovorenim kada je njegov redak označen u planu ili je klijent odgovorio na njega na svojoj stranici Pitanja.

Dvije stvari uzrokuju zaostajanje plana, a na zaslonu piše koja: AI korak koji ponovno piše plan nakon promjene nije završio ("Napisani plan nije ažuriran nakon posljednje promjene", s razlogom), ili web-mjesto ima noviju verziju od one na koju je plan bio izmjeren ("Web-mjesto se promijenilo nakon što je ovaj plan posljednji put ažuriran"). U oba slučaja pojavljuje se gumb "Osvježi plan". Stranica ga nikada ne pokreće sama kada je otvorite (otvaranje stranice nikada ne koristi AI); mehanizam svaku promjenu već u pozadini ugrađuje u plan, a gumb postoji za slučaj da to zaostane. Osvježi plan unosi najnoviju promjenu u napisani plan i ponovno mjeri web-mjesto. Ako i dalje ne uspije, traka ostaje s opisom što je pošlo po zlu, a možete ponovno pritisnuti Osvježi plan ili ručno urediti plan.

Kartica Zdravlje ocjenjuje web-mjesto od 100 bodova prema pravilima koja aiKit provjerava u stvarnim datotekama, nikada prema mišljenju AI-ja: nedostajući ili ponovljeni naslov stranice ili opis za pretraživače, stranica bez glavnog naslova ili s više od jednog, poveznica na stranicu koja ne postoji, stranica na koju ništa ne upućuje i nije u izborniku, slike bez opisa za čitače zaslona, vrlo kratke stranice, obrazac bez odredišta za slanje i modul koji je sažetak tražio, a nije na web-mjestu. Svaki problem navodi koja je stranica u pitanju, zašto je važan i ima gumb Popravi: Popravi šalje gotovu uputu za taj problem kao zahtjev i predaje je AI-ju, gumb tijekom rada prikazuje "Zahtjev za popravak poslan", a ocjena se ponovno mjeri kada promjena bude spremna. Popis možete filtrirati prema ozbiljnosti brojevima Visoka, Srednja i Niska, a "Prikaži sve" uklanja filter.

Mapa web-mjesta prikazuje stranice kao stablo: početna na vrhu, zatim izbornik redom, pa stranice do kojih se dolazi s tih stranica. Stranice na koje ništa ne upućuje nalaze se u vlastitoj skupini, stranice koje plan navodi, a još nisu izrađene, crtaju se isprekidano i označene su kao Planirano, a izrađene stranice koje plan nikada ne spominje označene su s "Nije u planu" i gumbom "Dodaj u plan" koji ih dodaje u odjeljak Stranice.

Pritisnite bilo koju stranicu (na mapi web-mjesta ili na popisu Stranice) da biste otvorili njezine detalje pored plana. Adresna traka se mijenja u ?page=/about, pa poveznica otvara istu stranicu za svakoga u timu. Detalji pokazuju kako stranica izgleda na Googleu (naslov, adresa, opis), njezine odjeljke i glavne naslove, broj riječi, slike i koliko ih nema opis, njezine obrasce i koji modul ih pokreće, je li klijent odobrio stranicu te posljednju promjenu: kada, tko je tražio i što je traženo.

Povijest prikazuje verzije koje aiKit čuva (Izvornu i najnovijih 10), od najnovije prema starijoj: njezin broj, vrstu promjene (Prva izrada, Chat, Pin, Komplet, Objavljeno, Vraćanje, Izmjena plana), kada je nastala, što je traženo, tko je tražio i koje su stranice promijenjene (pritisnite stranicu da otvorite njezine detalje). Najnovija je označena kao Trenutna verzija; svaka starija ima "Vrati ovu verziju", koji prvo pita, a prije vraćanja web-mjesta sprema trenutno stanje, tako da se vraćanje može poništiti. Prve tri su vidljive; "Prikaži sve" prikazuje ostale.

Odjeljak Poslovni podaci uspoređuje telefon, e-poštu, adresu i radno vrijeme iz Klijentskog dosjea s tekstom izrađenih stranica (prvo početna i kontakt). Svaki podatak prikazuje "Na web-mjestu" ili "Nije pronađeno na web-mjestu" (uz broj provjerenih stranica, jer web-mjesto može prikazivati staru vrijednost), a poveznica "Uredi u Klijentskom dosjeu" održava Klijentski dosje kao izvor istine.

• Stranice — tablica: Stranica, Putanja, Svrha i Status (Izrađeno ili Planirano), s pravom poveznicom "Pogledaj" na živu stranicu kada je izrađena i web-mjesto je objavljeno.
• Moduli i alati — svaki modul koji plan navodi, svaki s oznakom Izrađeno ili Planirano i vlastitom bilješkom.
• Poslovni podaci — radno vrijeme, adresa, usluge, cijene, sve što je činjenično o poslovanju, napisano kao običan tekst.
• Brend — paleta, ton i sve bilješke o stilu koje je plan zabilježio.
• Odluke — stvarne odluke koje su donesene i koje se sljedeća izmjena ne smije ponovno otvarati.
• Otvorena pitanja — popis stvari koje su još stvarno neodlučene, pri čemu svaka prikazuje odgovoreno ili još otvoreno.

Svaka kartica odjeljka ima ista dva gumba. "Uredi" otvara sirovi Markdown tog odjeljka u jednostavnom polju za tekst i sprema ga izravno natrag u PLAN.md. Ovo je stvarno, trenutno spremanje (preko vlastitog PUT krajnjeg puta projekta), ali namjerno ne pokreće izradu ni objavu; mijenja samo ono što dokument plana kaže, kao i uređivanje bilo koje druge bilješke.

„Zatraži izmjenu“ je namjerno drukčije: otvara mali obrazac („Što biste željeli promijeniti u odjeljku <section>?“), a slanjem se stvara pravi zahtjev na kartici Povratne informacije projekta, označen kao „Plan stranice — <Section>: …“, baš kao svaka oznaka ili brzo uređivanje, sa svojim životnim ciklusom statusa i poveznicom „Pogledaj zahtjev“ nakon slanja. Koristite Uredi kad sami ispravljate ili prepisujete vlastiti tekst plana; koristite Zatraži izmjenu kad želite da se stvarna stranica (a time i plan) ažurira u skladu s tim.

Plan ima dva sloja. Mjerenja (stranice, naslovi, odjeljci, poveznice, obrasci, moduli, stanje) uzima kod iz stvarnih datoteka nakon svake promjene, pa ne mogu odstupiti. Pisani plan (ciljevi, poslovne činjenice, brend, odluke, otvorena pitanja) održava AI korak koji se pokreće nakon svake promjene i prepisuje samo dijelove na koje je promjena utjecala. Nikada ne dodaje dnevnik promjena ni datirane unose; Povijest je mjesto gdje se čuva zapis o promjenama.

Ako taj AI korak ne uspije, pisani plan ostaje kakav je bio, umjesto da bude napola prepisan, neuspjeh se bilježi, a na ekranu se prikazuje Osvježi plan (vidi gore) umjesto da se tiho prikazuje zastarjeli plan.

Uz plan se nalazi traka s radnjama (na telefonu traka postaje gumb pune širine "Kopiraj poveznicu za klijenta" odmah ispod trake napretka, a ostale radnje su sažete pod "Više radnji (3)"). "Podijeli s klijentom" kopira poveznicu samo za čitanje (aikit.ai/p/<project>/plan) — bez internih alata, bez gumba za uređivanje, ništa interno. "Otvori live stranicu" izravna je poveznica na objavljenu stranicu, ili traka jasno piše "Još nije objavljeno" ako nije. "Datoteke" prikazuje stvarni broj datoteka s proširivim popisom putanje i veličine svake datoteke. "Preuzmi plan" preuzima stvarni trenutni PLAN.md kao pravu .md datoteku, bajt po bajt ono što ekran čita — ne regenerirani sažetak.

Klijentova stranica se otvara na kartici Plan: isti dokument plana stranice koji osoblje vidi na kartici Plan i brief (pregled i ciljevi, publika, strategija, mapa stranica, svaki alat s onim što znači za njihov posao i njegovim statusom, plan sadržaja, vremenski okvir, odluke i otvorena pitanja), bez dijelova namijenjenih samo osoblju: bez bilješki upisanih kad je alat dodan, bez imena onih koji su što dodali, bez poveznica u aiKitov Kit i bez gumba Napiši plan. Druga kartica, Stranice i odobrenja, zadržava prikaz stranica po stranicu u nastavku.

Na Stranicama i odobrenjima, zaštićeno istim pristupnim kodom koji već koriste za slanje povratnih informacija (bez zasebne prijave), klijent vidi istu traku napretka, Mapu stranica s popisom njihovih stranica, popis Stranica s poveznicama "Pogledaj", module, poslovne činjenice, brend, odluke i otvorena pitanja te redak "Plan ažuriran". Ne dobivaju Zdravlje, upute za popravke, Povijest, tko je što tražio, popis datoteka ni bilo koji gumb Uredi ili Zatraži promjenu.

Sve što osoblje označi samo za sebe uklanja se na poslužitelju prije slanja stranice, u svakom odjeljku: redak koji sadrži "(internal)", "[internal]" ili "(staff only)", redak koji počinje s "Internal:" ili "Staff only:", svaki odjeljak čiji naslov kaže Internal ili Staff only te skrivene komentare. Ti reci nikada ne dospijevaju u klijentov preglednik, čak ni u mrežnim podacima stranice.

Svaka izrađena stranica ima gumb Odobri. Klijent upisuje svoje ime (i izbornu napomenu) i odobrava; odobrenje je vezano uz točan sadržaj te stranice, pa ako se stranica kasnije promijeni, prikazuje se "Promijenjeno od vašeg odobrenja" i traži se ponovno odobrenje. Odobriti može samo netko s klijentovim pristupnim kodom. Ako otvorite klijentovu poveznicu dok ste prijavljeni kao osoblje, vidite stanje odobrenja svake stranice, ali ne i gumb Odobri, pa nitko ne može odobriti u ime klijenta. Na internom Planu stranice odobrene stranice prikazuju "Klijent odobrio", a promijenjene "Promijenjeno od odobrenja."

Na dnu se nalazi gumb "Pošalji povratne informacije": ako je stranica objavljena, otvara stvarnu objavljenu stranicu s već uključenim slojem za povratne informacije (koristeći njihov vlastiti pristupni kod); ako još nije objavljena, umjesto toga otvara njihovu stranicu Nedavne promjene.