Le pagine principali del sito spiegano perché esiste Fliclic e quale valore offre. La documentazione ha un compito diverso: definire i termini, descrivere il comportamento atteso delle funzioni e rendere visibili condizioni e limiti utili prima di un'operazione.
Questa sezione non replica l'intero racconto di Fliclic DEV e Fliclic Server. Organizza le informazioni in forma più asciutta e consultabile.
La documentazione è divisa in cinque percorsi:
La documentazione non include ancora procedure complete per installare un nodo, intervenire come root, migrare stati del database centrale o distribuire una release. Fliclic Server non è oggi presentato come software pubblico per l'installazione autonoma.
Per evitare ambiguità, le informazioni tecniche vanno lette secondo quattro categorie:
Il comportamento è presente nel codice operativo corrente analizzato. Non prova da solo che ogni nodo remoto esegua esattamente la stessa build.
Il progetto conserva una prova documentata su un ambiente, una build e uno scenario definiti. Il risultato non va generalizzato oltre quel perimetro.
Il comportamento è approvato come regola da preservare. Può avere parti ancora da completare, che devono restare visibili.
Il tema è stato analizzato o scelto come direzione, ma non è una funzione disponibile. Una pagina pubblica non deve trasformarlo in implementazione.
Il database centrale è la fonte autorevole per stato delle richieste e parametri gestiti del servizio. Il codice del nodo descrive il comportamento operativo effettivamente implementato. Lo snapshot di un backup è la fonte storica per la fotografia selezionata. Le evidenze runtime documentano ciò che è stato provato, non ciò che può essere dedotto soltanto dal codice.
Se documentazione e codice divergono, il comportamento corrente va verificato sul codice e la divergenza deve essere dichiarata. Non si modifica automaticamente il software per adattarlo a un testo.
Fliclic DEV è il servizio utilizzato dallo sviluppatore: ambienti, file, PHP, database, WordPress, duplicazioni, backup e ciclo di vita.
Fliclic Server è il motore tecnico che esegue queste azioni attraverso controllo centrale, nodi, workflow e verifiche. Non è un secondo prodotto e non richiede all'utente DEV di conoscere stati interni, path amministrativi o comandi di sistema.
Nella documentazione i due livelli sono separati per rendere più facile trovare la risposta corretta. Le pagine DEV descrivono cosa accade dal punto di vista dell'utente; le pagine Server spiegano perché e con quali limiti l'operazione viene eseguita.
Le azioni distruttive vengono descritte in modo esplicito. In particolare:
Le condizioni commerciali e di accesso non vengono dedotte dall'architettura.
Le funzioni possono evolvere. Un backup nuovo può contenere metadati che un reader precedente non conosce; una semantica degli stati richiede consumer allineati; una versione PHP disponibile su un ambiente può non esserlo su un altro.
Non usare vecchie copie, report storici o esempi di configurazione come procedure correnti senza confrontarli con la documentazione aggiornata e il codice distribuito.
Se la domanda riguarda il valore o i casi d'uso, torna alle pagine Fliclic DEV. Se riguarda cosa succede durante un'azione, consulta la documentazione DEV. Se riguarda isolamento, stati, backup o quote, passa alla documentazione Server. Per disponibilità, condizioni e dati legali, usa le pagine dedicate del sito: la documentazione tecnica non le sostituisce.
