Traceability

UUID: 2A4E1306-71B5-4D29-82AE-0138479CCBF6

Traceability IDs link requirements and design claims to source files, test artifacts, and physical optics artifacts. Source code uses DOC-UUID comments only at major files or major behavior blocks.

UUID	Area	Requirement Or Claim	Source / Evidence
`0F0D41FE-6F7B-4A3E-A8DD-3C1F7DCE2481`	Optics	Czerny-Turner reflective layout disperses 400-1000 nm light onto the TCD1304DG active pixels.	Design document optics sections; future optical layout diagram, BOM, alignment procedure, and wavelength-map test data.
`9F6C2C68-53B8-4B6B-BB9F-42068A583BF3`	Embedded	STM32F411 firmware captures 3694-sample frames and streams `CCD1` packets over USB CDC.	`CCD-Driver-Code/STM32F411_Basic/Core/Src/main.c` and firmware notes.
`2BD0CC64-CA9B-4886-BE5C-970D86E21283`	Host PC	Python parser validates `CCD1` binary frames and produces structured frame packets for the app.	`PythonGUI/backend/device/protocol.py`.
`552FD33D-F11F-41B7-B520-81E940994448`	Calibration	Host processing applies dark/bias, wavelength, intensity, and response corrections before live display/export.	`PythonGUI/backend/processing/spectrum_builder.py` and calibration config models.
`76A44D70-6073-458A-A7D6-5AC9AF4E7B77`	Calibration	Host PC captures `B_p` from buffered covered frames, estimates `beta_f` from shielded pixels 16 through 28, preserves raw counts, and records applied dark/bias terms in export artifacts.	`PythonGUI/frontend/kivy_app.py`, `PythonGUI/backend/processing/calibration_manager.py`, `PythonGUI/backend/processing/dark_subtraction.py`, `PythonGUI/backend/processing/spectrum_builder.py`, `PythonGUI/backend/storage/export_csv.py`, and `PythonGUI/backend/storage/binary_capture.py`.
`70686C4A-AEE9-44A6-8B28-D74FD756FCD6`	Export	CSV export writes raw and derived spectrum columns.	`PythonGUI/backend/storage/export_csv.py`.
`C6B4929A-5CFB-46E8-A592-FD75E67ED745`	Integration	Standalone COM inspector validates USB CDC stream rate and frame integrity.	`Spectrometer-COM-Inspector/spectrometer_com_inspector.py` and README.

Future optics-only artifacts should reuse the optics UUID above until separate requirements need their own IDs. Examples include optical CAD, grating angle notes, long-pass filter measurements, breadboard photos, enclosure drawings, and reference-comparison datasets.