How jhonjoel/ytrackwebsocket works
Project type and purpose
• YtrackWebSocket is a backend Node.js/TypeScript microservice. It exposes REST endpoints, WebSocket channels for real-time updates, runs scheduled ETL jobs (eggRows, nanoEggRows), integrates with Azure Blob Storage, an electronic-document provider, and two databases (Azure SQL and GrupoMaehara).
File structure
• Top-level: Dockerfile (containerized), src/ (all code).
• src/routes: HTTP routing.
• src/controllers → src/services → src/models (ORM) → src/database: standard layered API architecture.
• src/websocket: WebSocket server and handlers.
• src/services/eggRowsETL & cronProcedimientos.ts: scheduled ETL pipelines.
• src/services/uploadImage: Azure Blob upload.
• src/config/swaggerConfig.ts: OpenAPI docs.
README
• General project template; no architecture details.
Elements
• Green for services/business logic
• Orange for databases/storage
• Purple for external services
Detail is crucial
• Domain module as a sub-component.
• Dual database connections (Azure vs GrupoMaehara).
• CronProcedimientos.ts invoking ETL modules.