Cleared Server

While working for cleared I was tasked with developing the backend for their main services from scratch.

The codebase architecture was based on Santiago Quinteros’ Bulletproof Node, while also borrowing principles from Clean Architecture by making use of mappers, entities and DTOs to separate domains.

The server supported multiple services:

• The quiz builder
• Cleared patient portal
• Cleared website store

One interesting challenge we had was that we needed to be notified when the status of a case changed, but the related third party API didn’t provide webhooks. So I “emulated” webhooks by polling their API at a regular interval. With this came the added benefit of using /events over /webhooks - we can view a record of past events by hitting the endpoint, and avoid the risk of lost webhooks. This all makes achieving idempotency easier.

The server handled many functions, each requiring its own planning - dynamic product recommendations, PDF generation, payment processing, processing quiz machine submissions and processing EHR cases from trained physicians.