big refactoring and features added

App/Devices/board_handles.h

@@ -0,0 +1,22 @@
+/**
+ * @file board_handles.h
+ * @brief Extern declarations for CubeMX-generated peripheral handles.
+ *
+ * Architectural note:
+ * Device and service modules depend on hardware handles owned by `Src/main.c`.
+ * This header isolates those extern declarations so the App layer never has to
+ * pull application types back into the CubeMX-generated file.
+ */
+
+#ifndef BOARD_HANDLES_H
+#define BOARD_HANDLES_H
+
+#include "main.h"
+
+extern ADC_HandleTypeDef hadc1;
+extern ADC_HandleTypeDef hadc3;
+extern SD_HandleTypeDef hsd1;
+extern TIM_HandleTypeDef htim1;
+extern UART_HandleTypeDef huart8;
+
+#endif /* BOARD_HANDLES_H */