# Registro delle prove di assemblaggio robotizzato dei cablaggi: campi e calcoli

Versione: 2026-09-23. File associati: robot-trial-template.csv e robot-trial-demo.csv.
I CSV usano UTF-8 con BOM e delimitatori a virgola. Apriteli con «Da testo/CSV» in Excel oppure con LibreOffice. I nomi dei campi restano in inglese per consentire ai gruppi multilingue di unire le registrazioni. La tabella seguente spiega ogni campo.

Ogni riga rappresenta un tentativo di processo completo su un cablaggio a partire dal punto concordato. Definite unit_definition prima della prova. Nell'esempio, il confine va dall'inizio dell'alimentazione fino all'accettazione/scarto e alla disponibilità della cella per l'unità successiva. Le ripetizioni restano nella stessa riga e non contano come nuove unità. Create un altro batch_id quando cambiano pezzo, attrezzatura, programma, condizione o confine temporale. Usate un lotto separato per prove della sola fase di inserimento, anche sullo stesso pezzo; non includetele nel denominatore del processo completo. Aggiungete a questo registro suggerito i metodi di accettazione effettivi secondo i requisiti del prodotto del progetto.

| Campo | Significato e istruzioni |
| --- | --- |
| data_kind | Usare measured per misure reali; il file dimostrativo usa synthetic_example e non deve entrare nei riepiloghi dei dati misurati |
| batch_id / trial_id | Lotto di prove con condizioni coerenti / ID univoco del tentativo nel lotto |
| unit_definition | Unità del pezzo, inizio e fine; inclusione di alimentazione, ispezione e ripristino |
| drawing_revision / component_lot | Revisione del disegno del cablaggio / riferimenti dei lotti di terminali, alloggiamenti e cavi |
| fixture_program_revision / condition_id | Revisioni di attrezzatura e programma / riferimento della registrazione della condizione |
| first_pass_ok | 1 se tutti i controlli di accettazione del lotto sono completati senza ripetizioni; 0 se il mancato superamento al primo passaggio è confermato; vuoto se ignoto |
| final_ok | Esito di accettazione dopo le ripetizioni consentite: 1 o 0; vuoto se non determinato |
| retry_count | Numero di ripetizioni automatiche aggiuntive nello stesso tentativo; indicare esplicitamente 0 se assenti; vuoto se ignoto |
| human_recovery | 1 se è avvenuto ripristino manuale, 0 se non è avvenuto, vuoto se ignoto; non indica il numero di persone |
| occupancy_seconds | Secondi di occupazione, inclusi fallimenti e ripristino del tentativo; lasciare vuoti i dati mancanti anziché inserire 0 |
| first_failed_stage | Prima fase fallita, ad esempio feed, alignment, insertion, locking o inspection; none se nessuna fase è fallita |
| lock_check / electrical_check | Stato del controllo secondo il metodo del progetto: pass, fail, not_measured o not_applicable; riportare metodi e limiti in evidence_ref |
| evidence_ref | Posizione di log originali, metodi e criteri di ispezione, immagini/video con lo stesso ID; i dati dimostrativi non hanno evidenze di misurazione |
| notes | Registrazioni di danni, arretramento dei terminali, sequenza dei fili, ripristino anomalo o controlli aggiuntivi |

## Ricalcolare i record dimostrativi

Tutte le 6 righe di robot-trial-demo.csv sono dati fittizi che illustrano il metodo di registrazione. Non è stata eseguita alcuna prova fisica. Condividono unit_definition, condizioni e revisioni, con esiti al primo passaggio, esiti finali e tempi di occupazione completi:

- Tentativi avviati N = 6.
- 4 righe hanno first_pass_ok = 1; resa al primo passaggio = 4 / 6 = 66.7%.
- 5 righe hanno final_ok = 1; percentuale finale accettata = 5 / 6 = 83.3%.
- Totale occupancy_seconds = 30 + 30 + 50 + 70 + 30 + 30 = 240 secondi; occupazione media di 40 secondi per tentativo.
- 1 riga ha human_recovery = 1; retry_count totalizza 2 ripetizioni.
- T004 fallisce durante l'inserimento; i successivi controlli di bloccaggio ed elettrici sono quindi not_measured. Questo non impedisce di decidere il fallimento finale dell'unità completa.

Prima di riepilogare dati reali, verificate coerenza delle condizioni del lotto, unicità dei trial_id e completezza delle registrazioni per ciascun indicatore. Se manca 1 esito finale su 6 tentativi avviati, riportate «successi noti, fallimenti noti, 1 record mancante, 6 tentativi avviati» senza dichiarare ancora la percentuale finale accettata di tutti i tentativi. Segnalate anche i tempi mancanti; non dividete la parte registrata per il numero totale di tentativi. Un controllo elettrico non eseguito non può essere indicato come pass. La necessità dei controlli elettrici dipende dall'obiettivo della prova e dai requisiti di accettazione del prodotto.

Il registro non contiene macro di calcolo automatico né fornisce forza di contatto, limite di ripetizioni, dimensione del campione o parametri di sicurezza universali. Inserite i limiti reali prima dell'esecuzione. Le proporzioni sono risultati descrittivi del campione e non dimostrano capacità produttiva.


## Valori originali dei CSV e significato

I file originali mantengono valori inglesi stabili. La tabella ne spiega il significato; gli identificativi dimostrativi non identificano parti o prove reali.

| Valore originale | Significato |
| --- | --- |
| `measured` | Misure reali ottenute da una prova eseguita. |
| `synthetic_example` | Dati dimostrativi fittizi; escluderli dai riepiloghi delle misure. |
| `DEMO_ONLY` | Identificativo di lotto esclusivamente dimostrativo. |
| `T001–T006` | I sei identificativi individuali dei tentativi dimostrativi. |
| `one harness; feed start to accept/reject and cell ready` | Un cablaggio, cronometrato dall'inizio dell'alimentazione fino all'accettazione o scarto e al ripristino della disponibilità della cella. |
| `DEMO-D1` | Revisione fittizia del disegno. |
| `DEMO-L1` | Lotto fittizio di componenti. |
| `DEMO-F1-P1` | Revisione fittizia di attrezzatura e programma. |
| `DEMO-C1` | Condizione di prova fittizia. |
| `feed` | Fase di alimentazione del pezzo. |
| `alignment` | Fase di allineamento. |
| `insertion` | Fase di inserimento. |
| `locking` | Fase di bloccaggio. |
| `inspection` | Fase di ispezione. |
| `none` | Nessuna fase fallita, quando usato in first_failed_stage. |
| `pass` | Il controllo specificato è superato. |
| `fail` | Il controllo specificato è fallito. |
| `not_measured` | Il controllo non è stato eseguito; non equivale a superamento. |
| `not_applicable` | Il controllo non si applica alla prova. |
| `none; synthetic data` | Non esistono evidenze di prova fisica; i dati sono fittizi. |
| `Illustration only; no physical test` | La riga illustra la registrazione e non descrive una prova fisica. |
