Playbook¶
I playbook sono procedure operative guidate. Servono per passare da un problema o obiettivo a un risultato verificabile.
Usarli quando il caso è abbastanza concreto da richiedere una sequenza di controlli. Per concetti generali usare prima le pagine operative.
Come leggere un playbook
Un playbook parte da un caso pratico e deve chiudersi con una verifica. Se il problema diventa ricorrente, collegarlo a una known issue o a uno standard.
Quando usare quale playbook¶
| Necessità operativa | Playbook | Prima pagina di contesto |
|---|---|---|
| creare un simbolo custom riutilizzabile | Creare un simbolo custom | Simboli custom |
| validare un simbolo prima del riuso | Validare un simbolo custom | Checklist validazione simbolo |
| diagnosticare pin che non aggancia | Diagnosticare pin non agganciato | Attributi e pinatura |
| pulire entità residue o comportamenti anomali | Pulire oggetti residui | Troubleshooting |
| gestire accessori, contatti o bobine | Gestire accessori e bobine | Multifilare |
| verificare il dato mostrato da un morsetto | Verificare rappresentazione morsetti | Rimandi e morsetti |
| diagnosticare rimandi di alimentazione | Diagnosticare rimandi alimentazione | Rimandi e morsetti |
| associare materiali e controllare la distinta | Associare materiali | Archivi materiali custom |
aggiornare DbCables.db in modo reversibile |
Aggiornare Archivio Cavi DbCables | Archivio Cavi DbCables |
Playbook disponibili¶
| Playbook | Obiettivo |
|---|---|
| Creare un simbolo custom | Creare un simbolo riutilizzabile e riconoscibile da SPAC |
| Validare un simbolo custom | Verificare attributi, pinatura, inserimento e riuso |
| Diagnosticare pin non agganciato | Capire perché un filo non si collega al pin del simbolo |
| Gestire cartiglio e logo | Ridurre problemi con immagini e riferimenti nei cartigli |
| Gestire accessori e bobine | Governare elementi associati a un componente principale |
| Verificare rappresentazione morsetti | Capire quale dato viene mostrato dal simbolo morsetto |
| Diagnosticare rimandi alimentazione | Analizzare selezioni non valide e riferimenti non coerenti |
| Associare materiali | Associare materiali evitando duplicazioni e ambiguità |
| Aggiornare Archivio Cavi DbCables | Sostituire controllatamente il database cavi e validare l'allineamento |
| Pulire oggetti residui | Gestire residui grafici o intelligenti che alterano i riferimenti |
Regola playbook¶
Ogni playbook deve terminare con una verifica finale. Una procedura senza verifica non è ancora una procedura stabile.
flowchart LR
A[Pagina generale]:::info --> B[Playbook]:::process
B --> C[Verifica finale]:::warn
C --> D{Ricorrente?}:::warn
D -->|Sì| E[Known issue]:::danger
D -->|No| F[Caso pratico]:::todo
E --> G[Standard o gate]:::ok
classDef ok fill:#e6f4ea,stroke:#2e7d32,color:#1b5e20;
classDef warn fill:#fff4e5,stroke:#ef6c00,color:#5d4037;
classDef danger fill:#fdecea,stroke:#c62828,color:#7f1d1d;
classDef info fill:#e8f0fe,stroke:#1565c0,color:#0d47a1;
classDef todo fill:#f3e8ff,stroke:#7b1fa2,color:#4a148c;
classDef process fill:#f5f5f5,stroke:#757575,color:#212121;