Skip to Content

/ Here be dragons / - Map out your microservices to navigate complexity

Duration: 17:10


PART 1 — Analytical Summary 🧠

Context 💼

In a 17-minute talk titled “Here be dragons — Map out your microservices to navigate complexity,” Dable, a veteran engineer with 30+ years of experience and a product leader at PO (a spend management platform with an Odoo integration), shares a practical approach for tackling messy software systems. Speaking to an audience that spans microservices and monoliths alike, he frames the common struggle: codebases are hard to change safely, and unknowns surface at the worst moments—often in production. His thesis is simple and useful: teams can reduce risk and ship more confidently by creating opinionated “maps” of their code and systems that make risks (dragons) and exemplary patterns (treasure) visible.

Core ideas & innovations ⚙️

The talk elevates the idea that the quality of a system is measured by our ability to change it—echoing Dave Farley’s work on continuous delivery. Dable introduces codebase maps—lightweight, purpose-built visuals that “lie” in the useful way great maps do, much like the Mercator projection or a stylized Brussels Metro map. These maps omit many details yet amplify what matters for navigation: where complexity hides, where tests are trustworthy, what’s brittle, and what’s great.

He proposes building “pirate maps” from the outside-in. Start with business context and ownership boundaries, then place the services or major code units inside. Adjust the layout to reflect size and complexity, annotate where the tests you trust exist, and surface tacit team knowledge: which areas routinely break, which are confusing, and where the gold-standard patterns live. The goal is not architectural perfection—it’s a shared operating picture that helps teams anticipate risk and align on how to proceed.

Examples make it tangible. A security team inheriting auth services used mapping to identify weak spots and harden ownership. Five teams in a science-publishing organization used it to align on risks and good patterns across a sprawling service estate. A dating product team used a paper-based map for deep analysis and later to onboard a new, offshored team. The consistent thread: visualizing dragons and treasure improves outcomes—before code changes begin.

Impact & takeaways 🚀

The payoff is pragmatic and immediate. Codebase maps raise collective understanding, enabling safer, more predictable changes and better planning. Teams can pinpoint where to fortify tests before touching risky code, when to mob on a high-risk component, and how to sequence technical debt reduction to avoid past outages. They also help during large-impact planning sessions, where a printed or virtual map becomes a focal point for discussing dependencies, failure-prone areas, and realistic delivery timelines.

Beyond firefighting, the approach accelerates onboarding, clarifies ownership, and elevates shared language around quality. It turns tribal knowledge into a portable artifact. Most importantly, it reframes “fix everything” into “prepare wisely”—surfacing where to invest test coverage, where to consolidate over-sliced services, and where to exemplify patterns the rest of the codebase should emulate. The recommended next step is simple: run a two-hour workshop, map your microservices or monolith modules, capture dragons and treasure, and use the result as a living guide to safer, simpler change. 💬

PART 2 — Viewpoint: Odoo Perspective

Disclaimer: AI-generated creative perspective inspired by Odoo's vision.

As a community, we win when we make complexity visible and then remove it. I like the “pirate map” idea because it is pragmatic: prioritize what helps you change quickly and safely. In Odoo, teams often integrate many apps with external services. A simple, opinionated map can reveal where integration patterns are inconsistent, where tests are missing, or where a single module is doing too much.

The goal isn’t prettier diagrams; it’s better choices. If a map shows five services doing what one well-designed Odoo module could do, consolidate. If it shows fragile edges, standardize flows and invest in tests you trust. Keep the artifact close to execution—use Odoo Knowledge for living documentation, automate pipelines on Odoo.sh, and let the map guide the next refactor, not become an end in itself.

PART 3 — Viewpoint: Competitors (SAP / Microsoft / Others)

Disclaimer: AI-generated fictional commentary. Not an official corporate statement.

The mapping technique resonates with enterprise architecture practices: you need a shared, navigable view of systems to manage change at scale. In highly regulated environments (SOX, GDPR, industry-specific mandates), these maps should link to a CMDB, change controls, and traceability records. Pair the workshop-style “pirate map” with automated discovery (APM tracing, service registries, log correlation) so the picture stays fresh across hundreds or thousands of services.

The opportunity is to marry clarity with depth: use maps to illuminate UX-critical paths and risk “hotspots,” while leveraging platform governance for scalability, resilience, and compliance. The UX differentiation is the map’s simplicity; the enterprise differentiator is how well it integrates with tooling like Azure DevOps, SAP Solution Manager, or service catalogs—turning a conversation starter into an operational backbone.

Disclaimer: This article contains AI-generated summaries and fictionalized commentaries for illustrative purposes. Viewpoints labeled as "Odoo Perspective" or "Competitors" are simulated and do not represent any real statements or positions. All product names and trademarks belong to their respective owners.

Share this post
Archive
Sign in to leave a comment
Enabling multi-company sales team coordination in Odoo through selective record-level access