Feature/API-59/add-websocket-order-detail

[andres15alvarez]

This pull request introduces WebSocket support to the application, enabling real-time communication for order updates and user management. Key changes include adding WebSocket-related dependencies, implementing WebSocket guards and services for authentication and role-based access control, and creating a WebSocket gateway for managing order updates.

WebSocket Integration

• Added new dependencies: @nestjs/platform-socket.io and @nestjs/websockets to support WebSocket functionality (package.json, package.jsonR34-R37).
• Introduced OrderGateway to handle WebSocket connections, disconnections, and order update messages. It utilizes guards for authentication and role-based access control (src/order/order.gateway.ts, src/order/order.gateway.tsR1-R67).
• Added DTO UpdateOrderStatusWsDTO for validating WebSocket message payloads related to order updates (src/order/dto/order.ts, src/order/dto/order.tsR183-R196).

WebSocket Authentication and Role-Based Access Control

• Created AuthGuardWs to verify JWT tokens in WebSocket connections and attach authenticated user data to the socket (src/auth/auth.guard.ts, src/auth/auth.guard.tsR55-R86).
• Added RolesGuardWs to enforce role-based access control for WebSocket events (src/auth/roles.guard.ts, src/auth/roles.guard.tsR51-R82).

User Management for WebSocket Connections

• Added wsId field to the User entity to track WebSocket connections (src/user/entities/user.entity.ts, src/user/entities/user.entity.tsR92-R94).
• Implemented methods setWsId and removeWsId in UserService to manage WebSocket connection IDs (src/user/user.service.ts, src/user/user.service.tsR373-R390).
• Added a database migration to include the ws_id column in the user table (src/user/migrations/1746249862267-add-ws-id-user-migration.ts, src/user/migrations/1746249862267-add-ws-id-user-migration.tsR1-R13).

Order Management Enhancements

• Updated OrderService to include a method getUserByOrderId for retrieving the user associated with an order, enabling targeted WebSocket notifications (src/order/order.service.ts, src/order/order.service.tsR485-R495).
• Modified the order status update logic to ensure proper state transitions (src/order/order.service.ts, src/order/order.service.tsL218-R221).