# Dziennik prób robotycznego montażu wiązek przewodów: pola i obliczenia

Wersja: 2026-09-23. Pliki towarzyszące: robot-trial-template.csv i robot-trial-demo.csv.
Pliki CSV używają kodowania UTF-8 z BOM i separatora przecinkowego. Otwórz je funkcją „Z tekstu/CSV” w Excelu lub w LibreOffice. Nazwy pól pozostają po angielsku, aby zespoły pracujące w różnych językach mogły łączyć zapisy. Poniższa tabela wyjaśnia każde pole.

Każdy wiersz reprezentuje jedną próbę całego procesu na jednej wiązce od uzgodnionego punktu początkowego. Przed próbą zdefiniuj unit_definition. W przykładzie granice obejmują okres od rozpoczęcia podawania do odbioru/odrzucenia i gotowości celi na następny wyrób. Ponowienia pozostają w tym samym wierszu i nie są liczone jako nowe wyroby. Utwórz nowy batch_id po zmianie elementu, przyrządu, programu, warunku lub granic pomiaru czasu. Dla prób obejmujących tylko etap wsuwania utwórz osobną partię, nawet dla tego samego elementu; nie uwzględniaj ich w mianowniku całego procesu. Dodaj do proponowanego dziennika rzeczywiste metody odbioru zgodnie z wymaganiami produktu w projekcie.

| Pole | Znaczenie i instrukcja wpisu |
| --- | --- |
| data_kind | Dla rzeczywistych pomiarów używaj measured; plik demonstracyjny używa synthetic_example i nie może być uwzględniany w podsumowaniach danych pomiarowych |
| batch_id / trial_id | Partia prób o stałych warunkach / unikalny identyfikator próby w tej partii |
| unit_definition | Jednostka wyrobu, punkt początkowy i końcowy; informacja, czy uwzględniono podawanie, kontrolę i przywracanie pracy |
| drawing_revision / component_lot | Rewizja rysunku wiązki / odniesienia do partii terminali, obudów i kabli |
| fixture_program_revision / condition_id | Rewizje przyrządu i programu / odniesienie do zapisu warunków próby |
| first_pass_ok | 1, jeśli wszystkie kontrole odbiorcze partii zakończono bez ponowienia; 0, jeśli potwierdzono brak powodzenia za pierwszym razem; puste, jeśli wynik jest nieznany |
| final_ok | Wynik odbioru po dozwolonych ponowieniach: 1 lub 0; pozostaw puste, jeśli nie ustalono wyniku |
| retry_count | Liczba dodatkowych automatycznych ponowień w tej próbie; wpisz wyraźnie 0, jeśli ich nie było; pozostaw puste, jeśli liczba jest nieznana |
| human_recovery | 1, jeśli wystąpiło ręczne przywracanie pracy, 0, jeśli nie wystąpiło, puste, jeśli nie wiadomo; nie jest to liczba osób |
| occupancy_seconds | Czas zajęcia w sekundach, obejmujący niepowodzenia i przywracanie pracy w tej próbie; brakujące wartości pozostaw puste, zamiast wpisywać 0 |
| first_failed_stage | Pierwszy etap zakończony niepowodzeniem, np. feed, alignment, insertion, locking lub inspection; wpisz none, jeśli żaden etap nie zakończył się niepowodzeniem |
| lock_check / electrical_check | Status kontroli zgodnie z metodą projektu: pass, fail, not_measured lub not_applicable; wskaż metody i limity w evidence_ref |
| evidence_ref | Lokalizacja surowych logów, metod i kryteriów kontroli oraz obrazów/wideo z tym samym identyfikatorem; dane demonstracyjne nie mają dowodów pomiarowych |
| notes | Zapisy uszkodzeń, cofnięcia terminala, kolejności przewodów, nietypowego przywracania pracy lub dodatkowych kontroli |

## Przelicz zapisy demonstracyjne

Wszystkie 6 wierszy w robot-trial-demo.csv to fikcyjne dane ilustrujące sposób zapisu. Nie wykonano testu fizycznego. Mają one wspólne unit_definition, warunki i rewizje oraz kompletne wyniki pierwszego przejścia, wyniki końcowe i czasy zajęcia:

- Rozpoczęte próby N = 6.
- 4 wiersze mają first_pass_ok = 1; odsetek wyrobów zgodnych za pierwszym razem = 4 / 6 = 66.7%.
- 5 wierszy ma final_ok = 1; odsetek końcowych odbiorów = 5 / 6 = 83.3%.
- Suma occupancy_seconds = 30 + 30 + 50 + 70 + 30 + 30 = 240 sekund; średni czas zajęcia wynosi 40 sekund na próbę.
- 1 wiersz ma human_recovery = 1; suma retry_count wynosi 2 ponowienia.
- T004 kończy się niepowodzeniem podczas wsuwania, więc późniejsze kontrole blokowania i elektryczne mają status not_measured. Nie uniemożliwia to podjęcia końcowej decyzji o niezgodności całego wyrobu.

Przed podsumowaniem rzeczywistych danych sprawdź spójność warunków partii, unikalność wartości trial_id i kompletność zapisów dla każdego wskaźnika. Jeśli wśród 6 rozpoczętych prób brakuje 1 wyniku końcowego, podaj „znane powodzenia, znane niepowodzenia, 1 brakujący zapis, 6 rozpoczętych prób” i nie deklaruj jeszcze odsetka końcowych odbiorów dla wszystkich prób. Zgłoś również brakujące wartości czasu; nie dziel zarejestrowanej części przez całkowitą liczbę prób. Niewykonanej kontroli elektrycznej nie wolno oznaczyć jako pass. Konieczność przeprowadzenia kontroli elektrycznych zależy od celu próby i wymagań odbiorczych produktu.

Dziennik nie zawiera makr do automatycznych obliczeń ani uniwersalnych wartości siły kontaktu, limitu ponowień, liczebności próby czy parametrów bezpieczeństwa sprzętu. Wprowadź rzeczywiste limity przed wykonaniem prób. Proporcje w dzienniku są opisowymi wynikami próby i nie stanowią potwierdzenia zdolności produkcyjnej.


## Oryginalne wartości CSV i ich znaczenie

Oryginalne pliki zachowują stałe wartości angielskie. Poniższa tabela wyjaśnia ich znaczenie; identyfikatory demonstracyjne nie oznaczają rzeczywistych części ani testów.

| Wartość oryginalna | Znaczenie |
| --- | --- |
| `measured` | Rzeczywiste pomiary z wykonanej próby. |
| `synthetic_example` | Fikcyjne dane demonstracyjne; wyklucz je z podsumowań pomiarowych. |
| `DEMO_ONLY` | Identyfikator partii używany wyłącznie do demonstracji. |
| `T001–T006` | Sześć identyfikatorów poszczególnych prób demonstracyjnych. |
| `one harness; feed start to accept/reject and cell ready` | Jedna wiązka, z czasem mierzonym od rozpoczęcia podawania do odbioru lub odrzucenia i przywrócenia gotowości celi. |
| `DEMO-D1` | Fikcyjna rewizja rysunku. |
| `DEMO-L1` | Fikcyjna partia komponentów. |
| `DEMO-F1-P1` | Fikcyjna rewizja przyrządu i programu. |
| `DEMO-C1` | Fikcyjny warunek próby. |
| `feed` | Etap podawania. |
| `alignment` | Etap wyrównywania. |
| `insertion` | Etap wsuwania. |
| `locking` | Etap blokowania. |
| `inspection` | Etap kontroli. |
| `none` | Brak etapu zakończonego niepowodzeniem, gdy wartość jest używana w first_failed_stage. |
| `pass` | Określona kontrola zakończyła się wynikiem pozytywnym. |
| `fail` | Określona kontrola zakończyła się wynikiem negatywnym. |
| `not_measured` | Kontroli nie wykonano; nie oznacza to wyniku pozytywnego. |
| `not_applicable` | Kontrola nie ma zastosowania do tej próby. |
| `none; synthetic data` | Brak dowodów testu fizycznego; dane są fikcyjne. |
| `Illustration only; no physical test` | Wiersz ilustruje sposób zapisu i nie opisuje testu fizycznego. |