update documentation

services/api-gateway/README.md

@@ -1,12 +1,13 @@
 # API Gateway Service
 
-The core API gateway for LabFusion, built with Java Spring Boot.
+The core API gateway for LabFusion, built with Java Spring Boot following clean code principles.
 
 ## Purpose
 - Central API endpoint for all frontend requests
 - User authentication and authorization
 - Dashboard and widget management
 - Event and device state storage
+- System metrics and health monitoring
 
 ## Technology Stack
 - **Language**: Java 17
@@ -14,13 +15,34 @@ The core API gateway for LabFusion, built with Java Spring Boot.
 - **Port**: 8080
 - **Database**: PostgreSQL
 - **Message Bus**: Redis
+- **Documentation**: OpenAPI/Swagger
+- **Testing**: JUnit 5, Mockito
+- **Quality**: SpotBugs, Checkstyle, PMD, JaCoCo
 
 ## Features
-- JWT-based authentication
-- RESTful API endpoints
+- JWT-based authentication framework
+- RESTful API endpoints with comprehensive documentation
 - WebSocket support for real-time updates
 - Dashboard CRUD operations
 - Event and device state management
+- System health monitoring
+- OpenAPI documentation generation
+- Comprehensive error handling
+- Clean code architecture with layered design
+
+## Architecture
+- **Controller Layer**: REST endpoints with validation
+- **Service Layer**: Business logic and orchestration
+- **Repository Layer**: Data access abstraction
+- **Model Layer**: JPA entities and DTOs
+- **Configuration**: Spring Boot auto-configuration
+
+## API Endpoints
+- `GET /actuator/health` - Health check
+- `GET /swagger-ui.html` - API documentation
+- `GET /api/dashboards` - Dashboard management
+- `GET /api/system/metrics` - System metrics
+- `POST /api/events` - Event publishing
 
 ## Development Status
-✅ **Complete** - Core functionality implemented
+✅ **Complete** - Core functionality implemented with clean code principles

services/api-gateway/src/main/java/com/labfusion/controller/SystemController.java

@@ -4,12 +4,6 @@ import com.labfusion.model.DeviceState;
 import com.labfusion.model.Event;
 import com.labfusion.repository.DeviceStateRepository;
 import com.labfusion.repository.EventRepository;
-import io.swagger.v3.oas.annotations.Operation;
-import io.swagger.v3.oas.annotations.Parameter;
-import io.swagger.v3.oas.annotations.media.Content;
-import io.swagger.v3.oas.annotations.media.Schema;
-import io.swagger.v3.oas.annotations.responses.ApiResponse;
-import io.swagger.v3.oas.annotations.responses.ApiResponses;
 import io.swagger.v3.oas.annotations.tags.Tag;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.http.ResponseEntity;