Web Server Requirements

This document specifies component-level requirements for the web server functionality, enabling user interface, configuration, and WiFi setup capabilities.

Document Version: 2.0 Last Updated: 2025-11-12

Component Overview

The web server component provides HTTP-based user interface and configuration capabilities. These requirements refine the high-level system requirement Web-based Configuration (REQ_SYS_WEB_1).

Functional Requirements

Requirement: Real-time Status Display REQ_WEB_1

status: approved tags: web, ui, monitoring priority: mandatory links outgoing: REQ_SYS_WEB_1 links incoming: US_SETUP_1, REQ_LED_5, REQ_WEB_NF_1, REQ_WEB_NF_2, SPEC_DEV_GUIDE_QEMU_WEB, SPEC_WEB_ARCH_1, SPEC_WEB_STATIC_1, SPEC_WEB_REST_HEALTH_1, API_COMP_WEB_SERVER, API_FUNC_WEB_INIT, API_FUNC_WEB_STATIC_FILE

Description: The system SHALL provide a web page that displays current system status with real-time updates for user monitoring. Rationale: Users need to monitor the device’s operation remotely via web interface without requiring physical access. Acceptance Criteria: AC-1: Main page SHALL display current system status AC-2: Status values SHALL update with reasonable responsiveness AC-3: Page SHALL indicate system state (normal, error, warning) AC-4: Page SHALL be accessible via web browser on mobile and desktop devices

Requirement: Configuration Interface REQ_WEB_2

status: approved tags: web, ui, configuration priority: mandatory links outgoing: REQ_SYS_WEB_1, REQ_CFG_JSON_7 links incoming: US_SETUP_1, REQ_WEB_NF_1, REQ_WEB_NF_2, SPEC_WEB_ARCH_1, SPEC_WEB_STATIC_1, API_COMP_WEB_SERVER, API_FUNC_WEB_INIT, API_FUNC_WEB_STATIC_FILE

Description: The system SHALL provide a web page for configuring device parameters as defined in the configuration management requirements. Rationale: Users need to adjust device settings remotely without firmware recompilation or physical access. Acceptance Criteria: AC-1: Settings page SHALL display all user-configurable parameters AC-2: Settings page SHALL validate user input ranges before submission AC-3: Settings page SHALL provide immediate feedback on invalid inputs AC-4: Settings page SHALL confirm successful parameter updates AC-5: Settings page SHALL handle configuration save errors gracefully

Requirement: WiFi Setup Interface REQ_WEB_3

status: approved tags: web, wifi, network priority: mandatory links outgoing: REQ_SYS_NET_1 links incoming: US_SETUP_1, REQ_WEB_NF_2, SPEC_WEB_ARCH_1, SPEC_WEB_STATIC_1, SPEC_WEB_REST_WIFI_1, SPEC_WEB_INTEGRATION_WIFI_1, SPEC_WEB_CAPTIVE_1, API_COMP_WEB_SERVER, API_FUNC_WEB_INIT, API_FUNC_WEB_START, API_COMP_WIFI_MGR, API_FUNC_WIFI_INIT, API_FUNC_WIFI_START, API_FUNC_WIFI_GET_STATUS, API_FUNC_WIFI_SET_CRED, API_FUNC_WIFI_CLEAR_CRED, API_FUNC_WIFI_SWITCH_AP

Description: The system SHALL provide a captive portal WiFi setup page for initial network configuration. Rationale: Users need an intuitive method to configure WiFi credentials without serial console access or hardcoded credentials. Acceptance Criteria: AC-1: Device SHALL start in AP mode when WiFi credentials are not configured AC-2: WiFi setup page SHALL display available WiFi networks (SSID scan) AC-3: WiFi setup page SHALL accept SSID and password input AC-4: WiFi credentials SHALL be saved to NVS and validated on next boot AC-5: WiFi setup page SHALL provide feedback on save success/failure AC-6: Device SHALL switch to STA mode after successful WiFi configuration on next boot

Requirement: Configuration REST API REQ_WEB_CONF_1

status: approved tags: web, api, config priority: mandatory links outgoing: REQ_SYS_WEB_1, REQ_SYS_CFG_1 links incoming: US_SETUP_1, REQ_WEB_SCHEMA_1, SPEC_CFG_WEB_ARCH_1, SPEC_WEB_ARCH_1, SPEC_WEB_REST_CFG_1, SPEC_WEB_INTEGRATION_CFG_1, API_COMP_WEB_SERVER, API_FUNC_WEB_INIT

Description: The web server SHALL provide REST API endpoints for device configuration management. Rationale: Web interface needs standardized API to read and modify device configuration values stored in NVS. Acceptance Criteria: AC-1: GET /api/config SHALL return all current configuration values as JSON AC-2: POST /api/config SHALL accept configuration updates as JSON payload AC-3: POST /api/config/reset SHALL trigger factory reset of configuration AC-4: API SHALL integrate with configuration manager component AC-5: API SHALL return appropriate HTTP status codes (200 OK, 400 Bad Request, 500 Internal Server Error) AC-6: Configuration changes SHALL be persisted to NVS immediately AC-7: Device SHALL restart after configuration changes for consistency

Requirement: Schema-Driven Configuration Form REQ_WEB_SCHEMA_1

status: approved tags: web, ui, config priority: optional links outgoing: REQ_WEB_CONF_1, REQ_SYS_WEB_1 links incoming: US_SETUP_1, SPEC_WEB_REST_CFG_1, API_COMP_WEB_SERVER, API_FUNC_WEB_STATIC_FILE

Description: The web interface SHOULD dynamically generate configuration forms from schema definition. Rationale: Dynamic generation eliminates manual HTML maintenance and ensures UI stays in sync with configuration structure. Acceptance Criteria: AC-1: Web server SHALL serve configuration schema as static file (e.g., /config_schema.json) AC-2: Browser JavaScript SHALL fetch schema and generate form fields dynamically AC-3: Form fields SHALL match parameter types from schema (text, password, number, checkbox) AC-4: Browser SHALL validate inputs based on schema constraints before submission AC-5: Invalid inputs SHALL display clear error messages to user

Requirement: Web Interface Navigation REQ_WEB_4

status: approved tags: web, ui, navigation priority: mandatory links outgoing: REQ_SYS_WEB_1 links incoming: US_SETUP_1, SPEC_WEB_ROUTES_1, SPEC_WEB_EXTEND_1, API_COMP_WEB_SERVER, API_FUNC_WEB_INIT, API_FUNC_WEB_STATIC_FILE

Description: The system SHALL provide navigation between multiple web pages (status, settings, WiFi setup). Rationale: Users need to access different functionality areas without memorizing URLs. Acceptance Criteria: AC-1: All pages SHALL include navigation menu or links AC-2: Navigation SHALL clearly indicate current page AC-3: Navigation SHALL be accessible on mobile devices AC-4: Page URLs SHALL be intuitive and RESTful (e.g., /, /settings, /wifi)

Requirement: HTTP Server Concurrency REQ_WEB_5

status: approved tags: web, performance priority: mandatory links outgoing: REQ_SYS_WEB_1 links incoming: US_SETUP_1, SPEC_WEB_ROUTES_1, SPEC_WEB_CONFIG_1, SPEC_WEB_SECURITY_1, SPEC_WEB_TEST_1, API_COMP_WEB_SERVER, API_FUNC_WEB_INIT, API_FUNC_WEB_STOP, API_FUNC_WEB_IS_RUNNING, API_FUNC_WEB_GET_PORT, API_STRUCT_WEB_CONFIG, API_COMP_WIFI_MGR

Description: The web server SHALL handle multiple simultaneous HTTP connections without blocking. Rationale: Multiple users or browser tabs may access the device simultaneously. Acceptance Criteria: AC-1: Web server SHALL support at least 4 concurrent connections AC-2: Server SHALL respond to new connections within 2 seconds under load AC-3: Server SHALL not crash or hang under concurrent access AC-4: Connection handling SHALL not interfere with real-time system operation

Requirement: LED State API Endpoint REQ_WEB_LED_1

status: approved tags: web, api, led, visualization priority: important links outgoing: REQ_SYS_WEB_1, REQ_LED_5 links incoming: US_SETUP_1, SPEC_WEB_REST_LED_1, API_COMP_WEB_SERVER

Description: The web server SHALL provide a REST API endpoint to retrieve current LED strip state for real-time visualization in the web interface. Rationale: Users viewing the web interface should see real-time visual representation of the LED strip state, enabling remote monitoring without physical line-of-sight to the device. Acceptance Criteria: AC-1: GET /api/led/state SHALL return JSON with LED count and color array AC-2: Response SHALL include all LED colors as hex RGB strings (e.g., “FF0000” for red) AC-3: Endpoint SHALL use thread-safe LED state read API (REQ_LED_5) AC-4: Response SHALL set CORS headers for cross-origin access AC-5: Endpoint SHALL return 500 Internal Server Error if LED controller not initialized AC-6: Response time SHALL be under 200ms for 40 LEDs AC-7: Memory SHALL be properly freed after response (no leaks) Verification: Call endpoint from browser, verify JSON format, test with LED animations, check memory usage over time, verify CORS headers allow cross-origin requests.

Non-Functional Requirements

Requirement: Web UI Responsiveness REQ_WEB_NF_1

status: approved tags: web, performance, ux priority: optional links outgoing: REQ_WEB_1, REQ_WEB_2 links incoming: US_SETUP_1, SPEC_WEB_STATIC_1, SPEC_WEB_NF_1

Description: Web pages SHOULD load and render within 3 seconds on typical mobile/desktop browsers. Rationale: Responsive UI improves user experience and reduces perceived latency. Acceptance Criteria: AC-1: Initial page load SHALL complete within 3 seconds (excluding network latency) AC-2: Navigation between pages SHALL feel instantaneous (<500ms) AC-3: AJAX updates SHALL not cause page flickering or layout shifts

Requirement: Mobile-First Design REQ_WEB_NF_2

status: approved tags: web, ui, mobile priority: optional links outgoing: REQ_WEB_1, REQ_WEB_2, REQ_WEB_3 links incoming: US_SETUP_1, SPEC_WEB_NF_1

Description: Web interface SHOULD be optimized for mobile devices with responsive design. Rationale: Many users will access the device from smartphones in the field. Acceptance Criteria: AC-1: UI SHALL be usable on screens as small as 320px width AC-2: Touch targets SHALL be at least 44x44px for mobile usability AC-3: Text SHALL be readable without zooming on mobile devices

Traceability

All traceability is automatically generated by Sphinx-Needs based on the :links: attributes in each requirement.

ID	Title	Status	Tags
API_COMP_CERT_HANDLER	Certificate Handler	implemented
API_COMP_CONFIG_MANAGER	Config Manager	implemented
API_COMP_DISPLAY_LOGIC	Display Logic	implemented
API_COMP_DISTANCE_SENSOR	Distance Sensor	implemented
API_COMP_LED_CONTROLLER	LED Controller	implemented
API_COMP_NETIF_TUNNEL	Network Tunnel	implemented
API_COMP_STARTUP_TESTS	Startup Tests	implemented
API_COMP_WEB_SERVER	Web Server	implemented
API_COMP_WIFI_MGR	WiFi Manager	implemented
API_FUNC_CERT_HANDLER_GET_CA_CERT	cert_handler_get_ca_cert	implemented
API_FUNC_CERT_HANDLER_GET_INFO	cert_handler_get_info	implemented
API_FUNC_CERT_HANDLER_GET_SERVER_CERT	cert_handler_get_server_cert	implemented
API_FUNC_CERT_HANDLER_GET_SERVER_KEY	cert_handler_get_server_key	implemented
API_FUNC_CERT_HANDLER_INIT	cert_handler_init	implemented
API_FUNC_CONFIG_COMMIT	config_commit	implemented
API_FUNC_CONFIG_FACTORY_RESET	config_factory_reset	implemented
API_FUNC_CONFIG_GET_ALL_AS_JSON	config_get_all_as_json	implemented
API_FUNC_CONFIG_GET_BOOL	config_get_bool	implemented
API_FUNC_CONFIG_GET_INT16	config_get_int16	implemented
API_FUNC_CONFIG_GET_INT32	config_get_int32	implemented
API_FUNC_CONFIG_GET_SCHEMA_JSON	config_get_schema_json	implemented
API_FUNC_CONFIG_GET_STRING	config_get_string	implemented
API_FUNC_CONFIG_INIT	config_init	implemented
API_FUNC_CONFIG_SET_ALL_FROM_JSON	config_set_all_from_json	implemented
API_FUNC_CONFIG_SET_BOOL	config_set_bool	implemented
API_FUNC_CONFIG_SET_BOOL_NO_COMMIT	config_set_bool_no_commit	implemented
API_FUNC_CONFIG_SET_INT16	config_set_int16	implemented
API_FUNC_CONFIG_SET_INT16_NO_COMMIT	config_set_int16_no_commit	implemented
API_FUNC_CONFIG_SET_INT32	config_set_int32	implemented
API_FUNC_CONFIG_SET_STRING	config_set_string	implemented
API_FUNC_CONFIG_SET_STRING_NO_COMMIT	config_set_string_no_commit	implemented
API_FUNC_CONFIG_WRITE_FACTORY_DEFAULTS	config_write_factory_defaults	implemented
API_FUNC_DISPLAY_LOGIC_START	display_logic_start	implemented
API_FUNC_DISTANCE_SENSOR_GET_LATEST	distance_sensor_get_latest	implemented
API_FUNC_DISTANCE_SENSOR_GET_QUEUE_OVERFLOWS	distance_sensor_get_queue_overflows	implemented
API_FUNC_DISTANCE_SENSOR_HAS_NEW_MEASUREMENT	distance_sensor_has_new_measurement	implemented
API_FUNC_DISTANCE_SENSOR_INIT	distance_sensor_init	implemented
API_FUNC_DISTANCE_SENSOR_IS_RUNNING	distance_sensor_is_running	implemented
API_FUNC_DISTANCE_SENSOR_MONITOR	distance_sensor_monitor	implemented
API_FUNC_DISTANCE_SENSOR_START	distance_sensor_start	implemented
API_FUNC_DISTANCE_SENSOR_STOP	distance_sensor_stop	implemented
API_FUNC_LED_CLEAR_ALL	led_clear_all	implemented
API_FUNC_LED_CLEAR_PIXEL	led_clear_pixel	implemented
API_FUNC_LED_COLOR_BRIGHTNESS	led_color_brightness	implemented
API_FUNC_LED_COLOR_RGB	led_color_rgb	implemented
API_FUNC_LED_CONTROLLER_DEINIT	led_controller_deinit	implemented
API_FUNC_LED_CONTROLLER_INIT	led_controller_init	implemented
API_FUNC_LED_GET_ALL_COLORS	led_get_all_colors	implemented
API_FUNC_LED_GET_COUNT	led_get_count	implemented
API_FUNC_LED_GET_PIXEL	led_get_pixel	implemented
API_FUNC_LED_IS_INITIALIZED	led_is_initialized	implemented
API_FUNC_LED_SET_PIXEL	led_set_pixel	implemented
API_FUNC_LED_SHOW	led_show	implemented
API_FUNC_NETIF_TUNNEL_DEINIT	netif_uart_tunnel_deinit	implemented
API_FUNC_NETIF_TUNNEL_GET_HANDLE	netif_uart_tunnel_get_handle	implemented
API_FUNC_NETIF_TUNNEL_INIT	netif_uart_tunnel_init	implemented
API_FUNC_STARTUP_TESTS_MULTIPLE_CYCLES	led_running_test_multiple_cycles	implemented
API_FUNC_STARTUP_TESTS_RAINBOW	led_running_test_rainbow	implemented
API_FUNC_STARTUP_TESTS_SINGLE_CYCLE	led_running_test_single_cycle	implemented
API_FUNC_WEB_GET_PORT	web_server_get_port	implemented
API_FUNC_WEB_INIT	web_server_init	implemented
API_FUNC_WEB_IS_RUNNING	web_server_is_running	implemented
API_FUNC_WEB_START	web_server_start	implemented
API_FUNC_WEB_STATIC_FILE	static_file_handler	implemented
API_FUNC_WEB_STOP	web_server_stop	implemented
API_FUNC_WIFI_CLEAR_CRED	wifi_manager_clear_credentials	implemented
API_FUNC_WIFI_GET_IP	wifi_manager_get_ip_address	implemented
API_FUNC_WIFI_GET_STATUS	wifi_manager_get_status	implemented
API_FUNC_WIFI_INIT	wifi_manager_init	implemented
API_FUNC_WIFI_MONITOR	wifi_manager_monitor	implemented
API_FUNC_WIFI_SET_CRED	wifi_manager_set_credentials	implemented
API_FUNC_WIFI_START	wifi_manager_start	implemented
API_FUNC_WIFI_STOP	wifi_manager_stop	implemented
API_FUNC_WIFI_SWITCH_AP	wifi_manager_switch_to_ap	implemented
API_STRUCT_DISTANCE_SENSOR_ERROR	distance_sensor_error_t	implemented
API_STRUCT_DISTANCE_SENSOR_MEASUREMENT	distance_measurement_t	implemented
API_STRUCT_DISTANCE_SENSOR_RAW_MEASUREMENT	distance_raw_measurement_t	implemented
API_STRUCT_LED_COLOR	led_color_t	implemented
API_STRUCT_NETIF_TUNNEL_CONFIG	netif_uart_tunnel_config_t	implemented
API_STRUCT_WEB_CONFIG	web_server_config_t	implemented
API_STRUCT_WIFI_CRED	wifi_credentials_t	implemented
API_STRUCT_WIFI_MODE	wifi_manager_mode_t	implemented
API_STRUCT_WIFI_STATUS	wifi_status_t	implemented
REQ_CFG_JSON_1	JSON Schema as Configuration Source of Truth	implemented	config; schema; architecture
REQ_CFG_JSON_10	Web Interface Integration Support	approved	config; integration
REQ_CFG_JSON_11	NVS Error Graceful Handling	implemented	config; error-handling; reliability
REQ_CFG_JSON_12	Configuration Initialization on Boot	implemented	config; boot
REQ_CFG_JSON_13	Simple Process to Add Configuration Fields	implemented	config; extensibility; developer-experience
REQ_CFG_JSON_14	Type Safety via Optional Static Validation	implemented	config; validation; developer-experience
REQ_CFG_JSON_15	Configuration Schema Versioning and Migration	open	config; versioning; migration; future
REQ_CFG_JSON_2	Parameter Grouping for UI Organization	implemented	config; ui; schema
REQ_CFG_JSON_3	Parameter Type System	implemented	config; types
REQ_CFG_JSON_4	Build-Time Factory Defaults Generation	implemented	config; build; code-generation
REQ_CFG_JSON_5	No Runtime JSON Parsing in C Code	implemented	config; performance; memory
REQ_CFG_JSON_6	Key-Based NVS Storage	implemented	config; storage; nvs
REQ_CFG_JSON_7	Type-Safe Configuration API	implemented	config; api; type-safety
REQ_CFG_JSON_8	Persistent Configuration Storage	implemented	config; storage; nvs
REQ_CFG_JSON_9	Factory Reset Capability	implemented	config; reset
REQ_DEV_DOC_1	Supporting Documentation Traceability	implemented	developer; documentation; traceability
REQ_DEV_ENV_1	Supported Development Environments	implemented	developer; devcontainer; codespaces
REQ_DEV_GUIDE_DEBUG_1	Debugging Guide Content	implemented	developer; documentation; debugging
REQ_DEV_GUIDE_FLASH_1	Web Flasher Guide Content	implemented	developer; documentation; flasher
REQ_DEV_GUIDE_MODES_1	Switching Dev Modes Guide Content	implemented	developer; documentation; devmodes
REQ_DEV_GUIDE_QEMU_1	QEMU Emulator Guide Content	implemented	developer; documentation; qemu
REQ_DEV_LIMITS_1	Known Limitations Documentation	implemented	developer; limitations; known-issues
REQ_DEV_OV_HW_1	Hardware Specifications Content	implemented	developer; documentation; hardware
REQ_DEV_OV_INDEX_1	Overview Index Content	implemented	developer; documentation; overview
REQ_DEV_OV_QS_1	Quick Start Content	implemented	developer; documentation; quickstart
REQ_DEV_README_1	README Content Scope	implemented	developer; documentation; readme
REQ_DSP_1	Hardware Platform	approved	display; hardware; integration
REQ_DSP_2	Configuration Integration	approved	display; configuration; integration
REQ_DSP_3	Core Visualization Concept	approved	display; ux; visualization
REQ_DSP_4	Below Minimum Distance Warning	approved	display; ux; safety
REQ_DSP_5	Out of Range Display	approved	display; ux; error-handling
REQ_LED_1	WS2812 LED Strip Support	approved	led; hardware; ws2812
REQ_LED_2	Individual Pixel Control	approved	led; control; api
REQ_LED_3	Configurable LED Count	approved	led; configuration; flexibility
REQ_LED_4	Accurate Color Display	approved	led; quality; color-accuracy
REQ_LED_5	LED State Read API	approved	led; api; monitoring; web-interface
REQ_NETIF_TUNNEL_1	QEMU UART Network Bridge	approved	emulation; network; qemu; uart
REQ_NETIF_TUNNEL_2	Packet Encapsulation	approved	emulation; protocol
REQ_NETIF_TUNNEL_3	Host-Side Bridge Script	approved	emulation; tooling; host
REQ_NETIF_TUNNEL_4	DHCP Client Support	approved	emulation; network; dhcp
REQ_NETIF_TUNNEL_5	Conditional Compilation	approved	emulation; build
REQ_NETIF_TUNNEL_DOC_1	Emulation Setup Documentation	approved	emulation; documentation
REQ_NETIF_TUNNEL_NF_1	Tunnel Throughput	approved	emulation; performance
REQ_NETIF_TUNNEL_NF_2	Packet Loss Handling	approved	emulation; reliability
REQ_SNS_1	Component Initialization	approved	sensor; initialization; gpio
REQ_SNS_10	Timing and Performance	approved	sensor; performance; timing
REQ_SNS_11	Accuracy and Calibration	approved	sensor; accuracy; calibration
REQ_SNS_12	Timeout Error Handling	approved	sensor; error-handling; timeout
REQ_SNS_13	Range Validation	approved	sensor; error-handling; validation
REQ_SNS_14	Queue Overflow Management	approved	sensor; error-handling; queue
REQ_SNS_2	Trigger Pulse Generation	approved	sensor; trigger; timing
REQ_SNS_3	Real-Time Timestamp Capture	approved	sensor; isr; timing; real-time
REQ_SNS_4	Measurement Processing	approved	sensor; processing; filtering
REQ_SNS_5	Blocking API Access	approved	sensor; api; synchronization
REQ_SNS_6	Task Lifecycle Management	approved	sensor; lifecycle; freertos
REQ_SNS_7	Health Monitoring	approved	sensor; monitoring; diagnostics
REQ_SNS_8	Real-Time ISR Constraints	approved	sensor; performance; real-time; isr
REQ_SNS_9	Memory Resource Limits	approved	sensor; memory; resource
REQ_STARTUP_1	LED Controller Initialization	approved	startup; initialization; led
REQ_STARTUP_2	Visual Boot Sequence	approved	startup; ux; validation
REQ_STARTUP_3	Timing Performance	approved	startup; performance; timing
REQ_SYS_1	Garage Parking Assistance System	approved	system; parking; garage
REQ_SYS_ARCH_1	Component-based Architecture	approved	architecture; modularity
REQ_SYS_CFG_1	Non-volatile Configuration Storage	approved	storage; nvs; configuration
REQ_SYS_HW_1	ESP32 Hardware Platform	approved	hardware; platform
REQ_SYS_NET_1	WiFi Connectivity	approved	network; wifi
REQ_SYS_PERF_1	Memory Management	approved	performance; memory
REQ_SYS_REL_1	Error Handling and Recovery	approved	reliability; error-handling
REQ_SYS_SEC_1	HTTPS Support	open	security; https; future
REQ_SYS_SIM_1	Emulator Support	approved	emulator; qemu; testing
REQ_SYS_SIM_2	Emulator Network Connectivity	approved	emulator; qemu; network; development
REQ_SYS_TIME_1	System Time and NTP Support	open	time; ntp; future
REQ_SYS_WEB_1	Web-based Configuration	approved	web; configuration
REQ_WEB_1	Real-time Status Display	approved	web; ui; monitoring
REQ_WEB_2	Configuration Interface	approved	web; ui; configuration
REQ_WEB_3	WiFi Setup Interface	approved	web; wifi; network
REQ_WEB_4	Web Interface Navigation	approved	web; ui; navigation
REQ_WEB_5	HTTP Server Concurrency	approved	web; performance
REQ_WEB_CONF_1	Configuration REST API	approved	web; api; config
REQ_WEB_LED_1	LED State API Endpoint	approved	web; api; led; visualization
REQ_WEB_NF_1	Web UI Responsiveness	approved	web; performance; ux
REQ_WEB_NF_2	Mobile-First Design	approved	web; ui; mobile
REQ_WEB_SCHEMA_1	Schema-Driven Configuration Form	approved	web; ui; config
SPEC_ARCH_BUILD_1	ESP-IDF CMake Integration	approved	build; cmake
SPEC_ARCH_CERT_1	Certificate Handler Component Design	draft	component; security
SPEC_ARCH_CODESPACES_1	GitHub Codespaces Integration	approved	development; devcontainer
SPEC_ARCH_COMM_1	Component Communication Pattern	approved	dataflow; communication
SPEC_ARCH_CONFIG_1	Configuration Manager Component Design	approved	component; config
SPEC_ARCH_CONFIG_FLOW_1	Configuration Data Flow	approved	dataflow; config
SPEC_ARCH_ERROR_RECOVERY_1	Error Recovery and Reset Strategy	approved	error-handling; reliability; reset
SPEC_ARCH_FLASH_1	Flash Memory Configuration	approved	flash; memory
SPEC_ARCH_HTTP_1	HTTP Server Architecture Details	approved	network; http; web
SPEC_ARCH_LAYERS_1	ESP32 Distance Sensor Layered Architecture	approved	architecture; layering
SPEC_ARCH_LOGGING_1	Logging and Diagnostics Strategy	approved	logging; diagnostics; debugging
SPEC_ARCH_MEMORY_1	Memory Management Strategy	approved	memory; performance
SPEC_ARCH_NETIF_1	Network Tunnel Component Design	approved	component; qemu; network
SPEC_ARCH_PERF_1	System Performance Requirements	approved	performance; requirements
SPEC_ARCH_QEMU_1	QEMU Hardware Abstraction	approved	qemu; emulation
SPEC_ARCH_QEMU_BUILD_1	QEMU Component Selection	approved	qemu; build
SPEC_ARCH_TASKS_1	FreeRTOS Task Organization	approved	threading; rtos
SPEC_ARCH_WEB_1	Web Server Component Design	approved	component; web; network
SPEC_ARCH_WIFI_1	WiFi Manager Design Details	approved	network; wifi
SPEC_CFG_JSON_API_1	Type-Safe Configuration API	approved	api; interface; c-api
SPEC_CFG_JSON_ARCH_1	JSON Schema-Driven Architecture	draft	architecture; config; json-schema
SPEC_CFG_JSON_BULK_1	Bulk JSON Configuration API	approved	api; json; bulk-operations
SPEC_CFG_JSON_CODEGEN_1	Factory Reset via Bulk JSON Update	approved	build-process; code-generation; factory-reset
SPEC_CFG_JSON_EXTEND_1	Adding New Configuration Fields	approved	development; guide; extensibility
SPEC_CFG_JSON_SCHEMA_1	Configuration Schema Structure	approved	data-structure; schema
SPEC_CFG_JSON_SOURCE_1	JSON Schema as Single Source of Truth	approved	architecture; schema; design-pattern
SPEC_CFG_JSON_STORAGE_1	NVS Storage Format	approved	storage; nvs
SPEC_CFG_JSON_TYPESAFETY_1	Type Safety Without Code Generation	approved	type-safety; best-practices
SPEC_CFG_JSON_UI_1	JSON Schema for UI Generation	approved	web; ui; javascript
SPEC_CFG_WEB_ARCH_1	Configuration Webpage Architecture	implemented	frontend; javascript; ui
SPEC_CFG_WEB_COUNTDOWN_1	Device Reset Countdown Interface	implemented	ui; countdown; reset
SPEC_CFG_WEB_ERROR_1	Error Handling and User Feedback	implemented	error-handling; feedback
SPEC_CFG_WEB_FLOW_1	Configuration Data Flow	implemented	data-flow; json; api
SPEC_CFG_WEB_FORM_1	Dynamic Form Generation from Schema	implemented	form-generation; schema; javascript
SPEC_CFG_WEB_INIT_1	Complete Page Initialization Flow	implemented	initialization; lifecycle
SPEC_CFG_WEB_MAPPING_1	JSON Array to Form Field Mapping	implemented	data-mapping; json; form
SPEC_CFG_WEB_STATE_1	UI State Management	implemented	ui-state; javascript
SPEC_DEV_ENV_OPTIONS	Supported Development Environments — Options	implemented	developer; devcontainer; codespaces
SPEC_DEV_ENV_USAGE	Supported Development Environments — Setup Steps	implemented	developer; devcontainer; codespaces
SPEC_DEV_GUIDE_DEBUG_FEATURES	Debugging Guide — Debugging Features	implemented	developer; documentation; debugging
SPEC_DEV_GUIDE_DEBUG_START	Debugging Guide — Quick Start in QEMU	implemented	developer; documentation; debugging
SPEC_DEV_GUIDE_FLASH_OVERVIEW	Web Flasher Guide — Overview and Browser Requirements	implemented	developer; documentation; flasher
SPEC_DEV_GUIDE_FLASH_STEPS	Web Flasher Guide — Flash Procedure	implemented	developer; documentation; flasher
SPEC_DEV_GUIDE_MODES_DIFF	Dev Modes Guide — What Changes Between Modes	implemented	developer; documentation; devmodes
SPEC_DEV_GUIDE_MODES_HOW	Dev Modes Guide — How to Switch	implemented	developer; documentation; devmodes
SPEC_DEV_GUIDE_QEMU_START	QEMU Guide — Starting QEMU	implemented	developer; documentation; qemu
SPEC_DEV_GUIDE_QEMU_STOP	QEMU Guide — Stopping QEMU	implemented	developer; documentation; qemu
SPEC_DEV_GUIDE_QEMU_WEB	QEMU Guide — Accessing the Web Interface	implemented	developer; documentation; qemu
SPEC_DEV_LIMITS_STRUCTURE	Known Limitations File Structure and Process	implemented	developer; limitations; known-issues
SPEC_DEV_OV_HW_COMPONENTS	Hardware Components Listing	implemented	developer; documentation; hardware
SPEC_DEV_OV_HW_PINS	Hardware Pin Assignment Table	implemented	developer; documentation; hardware
SPEC_DEV_OV_INDEX_NAV	Overview Index — Navigation Section	implemented	developer; documentation; overview
SPEC_DEV_OV_INDEX_WHAT	Overview Index — Project Description	implemented	developer; documentation; overview
SPEC_DEV_OV_INDEX_WHO	Overview Index — Audience Section	implemented	developer; documentation; overview
SPEC_DEV_OV_QS_HW	Quick Start — Hardware Path	implemented	developer; documentation; quickstart; hardware
SPEC_DEV_OV_QS_QEMU	Quick Start — QEMU Path	implemented	developer; documentation; quickstart; qemu
SPEC_DEV_README_INTRO	README Introduction and Project Link	implemented	developer; documentation; readme
SPEC_DEV_README_META	README Metadata Section	implemented	developer; documentation; readme
SPEC_DSP_ALGO_1	Distance-to-Visual Mapping Algorithm	approved	display; algorithm; mapping
SPEC_DSP_ALGO_3	Embedded Arithmetic Architecture	approved	display; performance; arithmetic
SPEC_DSP_API_1	Public Display API	approved	display; api; interface
SPEC_DSP_ARCH_1	Task-Based Architecture	approved	display; freertos; task
SPEC_DSP_ARCH_2	Configuration Integration	approved	display; configuration
SPEC_DSP_OVERVIEW_1	WS2812 Hardware Integration	approved	display; hardware; integration
SPEC_LED_API_1	Pixel-Level Control API	approved	led; api; control
SPEC_LED_API_2	Batch Operations API	approved	led; api; batch
SPEC_LED_API_3	LED State Read API	approved	led; api; monitoring; thread-safety
SPEC_LED_ARCH_1	RMT Peripheral Hardware Abstraction	approved	led; rmt; hardware
SPEC_LED_ARCH_2	RAM Buffer Architecture	approved	led; memory; buffer
SPEC_LED_DATA_1	Color Representation and Conversion	approved	led; color; conversion
SPEC_LED_ERR_1	Error Handling and Validation	approved	led; error-handling; validation
SPEC_LED_MEM_1	Dynamic Memory Management	approved	led; memory; resource
SPEC_LED_SIM_1	LED Controller Simulator	approved	led; simulator; qemu
SPEC_LED_TIMING_1	WS2812 Timing Specification	approved	led; timing; ws2812
SPEC_NETIF_UART_ARCH_1	UART Tunnel Component Architecture	implemented	netif; qemu; uart; architecture
SPEC_NETIF_UART_BRIDGE_1	Host-Side Serial-TUN Bridge Script	implemented	netif; qemu; python; bridge; tooling
SPEC_NETIF_UART_COND_1	Conditional Compilation — QEMU-Only Build Guard	implemented	netif; qemu; build; kconfig
SPEC_NETIF_UART_DHCP_1	IP Configuration and DHCP Client Integration	implemented	netif; qemu; dhcp; ip
SPEC_NETIF_UART_DOC_1	Emulation Setup Documentation	implemented	netif; qemu; documentation
SPEC_NETIF_UART_PERF_1	Performance Characteristics and Known Limitations	implemented	netif; qemu; performance; limitations
SPEC_NETIF_UART_PROTO_1	UART Wire Protocol — Length-Prefix Framing	implemented	netif; qemu; protocol; framing
SPEC_SNS_ALGO_1	Distance Calculation Algorithm	approved	sensor; algorithm; calibration
SPEC_SNS_ALGO_2	EMA Smoothing Filter Design	approved	sensor; algorithm; filtering
SPEC_SNS_API_1	Public API Design	approved	sensor; api; interface
SPEC_SNS_ARCH_1	Dual-Queue Real-Time Architecture	approved	sensor; architecture; real-time
SPEC_SNS_ARCH_2	GPIO Interface Design	approved	sensor; gpio; hardware
SPEC_SNS_ERR_1	Error Handling Design	approved	sensor; error-handling; robustness
SPEC_SNS_ISR_1	Interrupt Service Routine Design	approved	sensor; isr; real-time
SPEC_SNS_SIM_1	Distance Sensor Simulator Design	approved	sensor; simulator; qemu
SPEC_SNS_TASK_1	Sensor Task Design	approved	sensor; freertos; task
SPEC_STARTUP_1	LED Controller Dependency Design	approved	startup; initialization; dependency
SPEC_STARTUP_2	Sequential LED Pattern Algorithm	approved	startup; algorithm; visual
SPEC_STARTUP_3	Startup Integration and Cleanup	approved	startup; integration; cleanup
SPEC_STARTUP_4	Component Architecture	approved	startup; architecture; component
SPEC_WEB_ARCH_1	Web Server Architecture	approved	web; architecture
SPEC_WEB_CAPTIVE_1	Captive Portal Design	approved	web; captive-portal; wifi
SPEC_WEB_CONFIG_1	HTTP Server Configuration	approved	web; config; performance
SPEC_WEB_EXTEND_1	Extension Guide for Web Pages	approved	web; extensibility; guide
SPEC_WEB_INTEGRATION_CFG_1	Config Manager Integration Pattern	approved	web; integration; config
SPEC_WEB_INTEGRATION_WIFI_1	WiFi Manager Integration Pattern	approved	web; integration; wifi
SPEC_WEB_NF_1	Mobile-First Responsive Design	approved	web; ui; mobile; responsive
SPEC_WEB_REST_CFG_1	Configuration API Endpoints	approved	web; api; config; schema
SPEC_WEB_REST_HEALTH_1	System Health API Endpoint	approved	web; api; diagnostics
SPEC_WEB_REST_LED_1	LED State API Endpoint	approved	web; api; led; visualization
SPEC_WEB_REST_WIFI_1	WiFi Management REST API Endpoints	approved	web; api; wifi
SPEC_WEB_ROUTES_1	URI Routing Table	approved	web; routing
SPEC_WEB_SECURITY_1	CORS Configuration	approved	web; security; cors
SPEC_WEB_STATIC_1	Static File Embedding Strategy	approved	web; build; embedding
SPEC_WEB_TEST_1	Web Server Testing Strategy	approved	web; testing
US_DEV_1	Modular Firmware Extensibility	implemented	developer; firmware; extensibility
US_DEV_2	Traceable Supporting Documentation	implemented	developer; documentation; traceability
US_DISPLAY_1	Visual Distance Feedback for Parking	approved	display; sensor; garage-user
US_RELIABLE_1	Appliance Reliability - Just Works on Power	approved	reliability; startup; garage-user
US_SETUP_1	Device Setup via Web Interface	approved	setup; wifi; web; maker

REQ_WEB_1