Skip to main contentSkip to footer
Sfoglia i principi
Principio 6visibility

Esporre uno stato operativo significativo, non la complessità interna

Presentare lo stato del sistema in linguaggio e strutture rilevanti per l'utente, piuttosto che esporre dettagli interni di basso livello che non supportano l'azione o la comprensione.

Fatti chiave

Cluster
visibility
Rischio principale
Il sistema oscura lo stato importante o sovraccarica l'utente con meccaniche irrilevanti.
Esempi correlati
6 esempi in libreria
Libreria di dottrina
Riferimento interno alla dottrina
Perché questo principio è importante?

Gli utenti hanno bisogno di comprendere la verità operativa, ma non necessariamente i dettagli di implementazione. Un buon design traduce l'attività della macchina in uno stato significativo per l'utente.

Utilizzare stati come attivo, in coda, bloccato, in attesa di approvazione, completo o fallito.
Comunicare le dipendenze quando influenzano il progresso o l'esito.
Descrivere l'attività in termini rilevanti per l'utente.
Riservare dettagli tecnici più profondi per viste specialistiche o diagnostiche dove appropriato.
Quale fallimento previene questo principio?

Il sistema oscura lo stato importante o sovraccarica l'utente con meccaniche irrilevanti.

AI come abbellimento dell'interfaccia: Un prodotto convenzionale è dotato di un input testuale e viene etichettato come intelligente, senza alcun cambiamento significativo nel modello operativo.
Autonomia simulata: Il sistema appare autonomo nel linguaggio o nella presentazione ma non può agire con un'indipendenza significativa.
Esecuzione opaca: Il lavoro avviene in background senza uno stato adeguato, responsabilità o recuperabilità.
Come applico questo principio in pratica?

La libreria di implementazione contiene esempi ispezionabili e rieseguibili che mostrano questo principio applicato in codice reale. Studia i source path, le librerie scelte e le dipendenze di runtime, non solo il nome del pattern.

Esempio di implementazione

Ottieni una singola pagina

Esempio rieseguibile intermediate di tipo script che usa docling, openai. (script · intermediate)

Ispeziona l'implementazione

Esempio di implementazione

Ricerca web

Esempio rieseguibile intermediate di tipo script che usa docling, openai. (script · intermediate)

Ispeziona l'implementazione

Esempio di implementazione

Cerca nel manuale

Esempio rieseguibile intermediate di tipo script che usa docling, openai. (script · intermediate)

Ispeziona l'implementazione

Esempi correlati