Il piano del sito

PLAN.md viene scritto nel momento in cui termina la prima creazione di un progetto, e deve descrivere sempre il sito così com'è in questo momento — non un registro di tutto ciò che gli è mai accaduto (a questo servono la scheda Versioni e il Registro modifiche). La schermata Piano del sito interpreta quel Markdown e lo trasforma in un'interfaccia reale: una tabella per le pagine, un elenco per i moduli, una lista di controllo per le domande aperte e testo semplice per i dati di business, il brand e le decisioni.

Prima che sia terminata una qualsiasi creazione, non c'è ancora nulla da leggere: la schermata mostra "Nessun piano ancora", spiega chiaramente che il piano viene scritto dalla prima creazione del progetto e rimanda alla pagina del progetto, invece di mostrare una tabella vuota.

Un sito i cui file sono arrivati senza piano (pubblicato da un altro strumento AI tramite il connettore, importato o caricato) ne riceve comunque uno: la schermata parte dal brief del progetto, dalle scelte del kit e dalle pagine rilevate, e un banner, Questo piano è stato avviato per te, propone "Salva questo piano", che lo rende il vero piano del progetto così che ogni sezione possa essere modificata. "Leggi il piano completo del sito" rimanda al documento del piano nella scheda Piano e brief.

I moduli aggiunti in seguito dal Kit (Aggiungi al piano) entrano nell'elenco Moduli come Pianificato con un link Vedi nel Kit, anche quando il testo del piano è stato scritto prima che fossero aggiunti.

Sotto il titolo, una riga indica quando il piano è stato aggiornato l'ultima volta: "Piano aggiornato 2 ott, 15:04". Quell'orario deriva dall'ultima volta in cui aiKit ha misurato i file reali del sito, cosa che avviene dopo ogni modifica (una modifica in chat, un pin, un'aggiunta dal Kit, un ripristino, una modifica manuale del piano, una pubblicazione da un altro strumento AI).

In alto, una volta che esiste un piano: una barra della percentuale complessiva di completamento e sotto tre riquadri: Pagine create (su quelle pianificate), Moduli creati (su quelli scelti) e Domande risposte (su quelle aperte nel piano). Ogni riquadro è un pulsante che scorre fino alla sezione che conta. Nulla di tutto questo è dichiarato dal testo del piano: una pagina risulta creata solo quando aiKit la trova nei file reali del sito; un modulo risulta creato solo dal rapporto di creazione verificato o dal modulo trovato nei file; una domanda risulta risposta quando la sua riga è spuntata nel piano o il cliente ha risposto nella sua pagina Domande.

Due cose possono far rimanere indietro il piano, e la schermata indica quale: l'elaborazione AI che riscrive il piano dopo una modifica non è terminata ("Il piano scritto non si è aggiornato dopo l'ultima modifica", con il motivo), oppure il sito ha una versione più recente di quella su cui il piano era stato misurato ("Il sito è cambiato dopo l'ultimo aggiornamento di questo piano"). In entrambi i casi compare un pulsante "Aggiorna piano". La pagina non lo esegue da sola all'apertura (aprire una pagina non usa mai l'AI); il motore integra già ogni modifica nel piano in background, e il pulsante serve quando questo processo è rimasto indietro. Aggiorna piano integra la modifica più recente nel piano scritto e misura di nuovo il sito. Se non va ancora a buon fine, il banner resta con il problema riscontrato, e puoi premere di nuovo Aggiorna piano oppure modificare il piano a mano.

La scheda Salute assegna al sito un punteggio su 100 in base a regole che aiKit verifica nei file reali, mai in base all'opinione dell'AI: un titolo della pagina o una descrizione per i motori di ricerca mancanti o ripetuti, una pagina senza titolo principale o con più di uno, un link a una pagina inesistente, una pagina che nessuno collega e che il menu non include, immagini senza descrizione per i lettori di schermo, pagine troppo brevi, un modulo senza destinazione per l'invio e un modulo richiesto nel brief che non è presente nel sito. Ogni problema indica la pagina, spiega perché è importante e ha un pulsante Correggi: Correggi invia l'istruzione pronta per il problema come richiesta e la affida all'AI; il pulsante mostra "Correzione richiesta" mentre lavora, e il punteggio viene misurato di nuovo quando la modifica è applicata. Filtra l'elenco per gravità con i conteggi Alta, Media e Bassa, e "Mostra tutto" rimuove il filtro.

La Mappa del sito disegna il sito come un albero: la home in alto, poi il menu in ordine, poi le pagine raggiunte da quelle pagine. Le pagine che nessuno collega stanno in un gruppo a parte; le pagine elencate nel piano ma non ancora create sono disegnate tratteggiate e contrassegnate come Pianificata; le pagine create che il piano non menziona sono contrassegnate "Non nel piano" con un pulsante "Aggiungi al piano" che le aggiunge alla sezione Pagine.

Premi una pagina (nella mappa del sito o nell'elenco Pagine) per aprirne i dettagli accanto al piano. La barra degli indirizzi cambia in ?page=/chi-siamo, quindi il link apre la stessa pagina per chiunque nel team. I dettagli mostrano come appare la pagina su Google (titolo, indirizzo, descrizione), le sue sezioni e i titoli principali, il numero di parole, le immagini e quante sono prive di descrizione, i suoi moduli e quale modulo del kit li gestisce, se il cliente l'ha approvata e l'ultima modifica: quando, chi l'ha richiesta e cosa è stato chiesto.

La Cronologia elenca le versioni che aiKit conserva (l'Originale e le ultime 10), dalla più recente: il numero, il tipo di modifica (Prima creazione, Chat, Puntina, Kit, Pubblicazione, Ripristino, Modifica del piano), quando, cosa è stato chiesto, chi l'ha chiesto e quali pagine sono cambiate (premi una pagina per aprirne i dettagli). La più recente è contrassegnata come Versione attuale; ogni versione precedente ha "Ripristina questa versione", che chiede prima conferma e salva lo stato attuale prima di riportare indietro il sito, così un ripristino può essere annullato. Le prime tre sono visibili; "Mostra tutto" elenca le altre.

La sezione Dati aziendali confronta telefono, email, indirizzo e orari presenti nel File cliente con il testo delle pagine create (prima la home e il contatto). Ogni dato mostra "Sul sito" oppure "Non trovato sul sito" (con il numero di pagine controllate, perché il sito potrebbe mostrare un valore vecchio), e un link "Modifica nel File cliente" mantiene il File cliente come fonte di riferimento.

• Pagine — una tabella con Pagina, Percorso, Scopo e Stato (Creata o Pianificata), con un link "Visualizza" alla pagina online non appena è sia creata sia il sito è online.
• Moduli e strumenti — ogni modulo elencato nel piano, con una etichetta Creato o Pianificato e la sua nota.
• Dati aziendali — orari, indirizzo, servizi, prezzi e qualsiasi altra informazione concreta sull'attività, scritti come testo semplice.
• Brand — la tavolozza, il tono e le eventuali note di stile registrate nel piano.
• Decisioni — scelte concrete già prese che la modifica successiva non deve rimettere in discussione.
• Domande aperte — un elenco di controllo delle questioni davvero ancora da decidere, ognuna con l'indicazione risposta o ancora aperta.

Ogni scheda di sezione ha gli stessi due pulsanti. "Modifica" apre il Markdown grezzo della sezione in un'area di testo semplice e lo salva direttamente in PLAN.md: è una scrittura reale e immediata (tramite l'endpoint PUT del progetto), ma non avvia volutamente una creazione né una pubblicazione; cambia solo ciò che dice il documento del piano, come modificare una qualsiasi altra nota.

"Richiedi una modifica" è volutamente diverso: apre un piccolo modulo ("Quale modifica vorresti in <sezione>?") e, quando lo invii, crea una vera richiesta nella scheda Feedback del progetto, con etichetta "Piano del sito — <Sezione>: …", proprio come qualsiasi richiesta da pin o Modifica rapida, con il proprio ciclo di stato e un link "Visualizza la richiesta" una volta inviata. Usa Modifica quando correggi o riscrivi tu stesso il testo del piano; usa Richiedi una modifica quando vuoi che il sito vero (e di conseguenza il piano) venga aggiornato di conseguenza.

Il piano ha due livelli. Le misurazioni (pagine, titoli, sezioni, link, moduli, form, stato di salute) vengono rilevate dal codice sui file reali dopo ogni modifica, quindi non possono discostarsi dalla realtà. Il piano scritto (obiettivi, dati dell'attività, brand, decisioni, domande aperte) viene tenuto aggiornato da un passaggio di IA che si esegue dopo ogni modifica e riscrive solo le parti toccate dalla modifica. Non aggiunge mai un registro delle modifiche né voci datate; la Cronologia è dove si conserva la storia delle modifiche.

Se questo passaggio di IA non riesce, il piano scritto resta com'era invece di essere riscritto a metà, l'errore viene registrato e la schermata mostra Aggiorna piano (vedi sopra) invece di mostrare in silenzio un piano non aggiornato.

Una barra laterale accanto al piano contiene le azioni (su telefono la barra diventa un pulsante "Copia il link per il cliente" a larghezza piena subito sotto la barra di avanzamento, con le altre azioni raccolte sotto "Altre azioni (3)"). "Condividi con il cliente" copia un link di sola lettura (aikit.ai/p/<project>/plan): nessuno strumento per il personale, nessun pulsante di modifica, nulla di interno. "Apri il sito online" è un link diretto al sito online; se il sito non è ancora online, la barra lo indica chiaramente con "Non ancora online". "File" mostra il numero reale di file con un elenco espandibile del percorso e della dimensione di ogni file. "Scarica il piano" scarica il PLAN.md attuale come file .md vero, identico byte per byte a quello letto dalla schermata, non un riepilogo rigenerato.

La pagina del cliente si apre sulla scheda Piano: lo stesso documento del piano del sito che lo staff vede nella scheda Piano e brief (panoramica e obiettivi, pubblico, strategia, mappa del sito, ogni strumento con a cosa serve per la sua attività e il suo stato, piano dei contenuti, tempistica, decisioni e domande aperte), senza le parti riservate allo staff: nessuna nota scritta quando è stato aggiunto uno strumento, nessun nome di chi ha aggiunto cosa, nessun collegamento al Kit di aiKit e nessun pulsante Scrivi il piano. Una seconda scheda, Pagine e approvazioni, mantiene la vista pagina per pagina qui sotto.

In Pagine e approvazioni, protetta dallo stesso codice di accesso che il cliente usa già per lasciare feedback (senza accesso separato), il cliente vede la stessa fascia di avanzamento, una Mappa del sito delle sue pagine, l'elenco delle Pagine con i link "Visualizza", i moduli, i dati dell'attività, il brand, le decisioni e le domande aperte, più una riga "Piano aggiornato". Non vede Stato di salute, istruzioni di correzione, Cronologia, chi ha chiesto cosa, l'elenco dei file né alcun pulsante Modifica o Richiedi una modifica.

Tutto ciò che lo staff contrassegna per uso interno viene rimosso sul server prima che la pagina venga inviata, in ogni sezione: una riga che contiene "(internal)", "[internal]" o "(staff only)", una riga che inizia con "Internal:" o "Staff only:", qualsiasi sezione il cui titolo dice Internal o Staff only, e i commenti nascosti. Queste righe non raggiungono mai il browser del cliente, nemmeno nei dati di rete della pagina.

Ogni pagina creata ha un pulsante Approva. Il cliente scrive il proprio nome (e una nota facoltativa) e approva; l'approvazione è legata al contenuto esatto di quella pagina, quindi se la pagina cambia in seguito compare "Modificata dopo la tua approvazione" e viene chiesta di nuovo. Solo chi usa il codice di accesso del cliente può approvare. Se apri il link del cliente mentre sei connesso come staff, vedi lo stato di approvazione di ogni pagina ma non il pulsante Approva, così nessuno può approvare per conto del cliente. Nel Piano del sito dello staff, le pagine approvate mostrano "Approvato dal cliente" e quelle modificate "Modificato dopo l'approvazione".

In fondo c'è un pulsante "Invia feedback": se il sito è online, apre il sito reale con la sovrapposizione dei feedback già attiva (usando il proprio codice di accesso); se non è ancora online, ripiega sulla pagina Aggiornamenti recenti.