Skip to content

Multi-Tenant Best Practices Can Backfire

You have a multi-tenant system, but you discover a pretty horrible bug. How can that be? You followed all the best practices! Your HTTP API places a message on a queue to generate an invoice. A background process picks up that message and executes it. Everything looks like it worked. There were no exceptions, no failed database calls, and no errors in your logs. However, something went horribly wrong. The request was supposed to execute for tenant A, but what actually happened is that it executed for tenant B. The wrong tenant. YouTube Check out my YouTube channel, where I post all… Read More »Multi-Tenant Best Practices Can Backfire

Avoid API Breaking Changes

Have you ever changed your backing data model and then all of a sudden all your clients explode? It’s not because you broke your code. You broke your contract. Most times API breaking changes occur because you’re exposing your domain model or data model. You’re not just sharing data. You’re leaking implementation details. What you can do instead is start treating your API like an anti-corruption layer. That does not mean making seven different layers of DTOs. YouTube Check out my YouTube channel, where I post all kinds of content on Software Architecture & Design, including this video showing everything in this… Read More »Avoid API Breaking Changes

Domain Events Are NOT Your Public API

You finally did it. You stopped publishing CRUD events and started broadcasting domain events. Instead of publishing ShipmentStatusChanged, ShipmentUpdated, or EstimatedDeliveryDateChanged, you started publishing more meaningful domain events like DeliveryAttemptFailed, ETARecalculated, and ShipmentDelayed. And apparently that was supposed to be better, right? Wrong. YouTube Check out my YouTube channel, where I post all kinds of content on Software Architecture & Design, including this video showing everything in this post. You’re publishing domain events now rather than CRUD events. But you still feel all the pain when you need to change one of those events. You’re breaking consumers, sometimes consumers you didn’t even… Read More »Domain Events Are NOT Your Public API