How to Design a Modern Medical Records System

This contribution presents a lean approach to software design, focusing on the journey from a basic idea to a well-defined API and software architecture. This method combines different workshop formats, namely Domain Storytelling and Event Storming, to effectively define software systems collaboratively within cross-functional teams. The process starts with gathering business requirements using Domain Storytelling, a visual technique that provides a thorough understanding of business processes. A visual glossary then helps to create an unambiguous language for all stakeholders. The identification of bounded contexts, essential for defining independent and maintainable services, is done using Event Storming workshops. Once these contexts are identified, a context map is created to give a preliminary architectural overview and to guide the configuration of implementation teams. APIs are then formulated using OpenAPI and AsyncAPI, typically in a mob programming setting. This lean approach ensures faster time to market with committed stakeholder, business, and technical expert involvement.