Field Guides
Real-World Architectures
Field guides on data, systems and institutions. Short, free, practice-first volumes on the architectural patterns that decide whether data platforms survive production, in regulated industries and in public institutions.
Latest volume
Volume 2 · October 2026
Document Management: Metadata-Driven Search over Documents and Records
How to build a governed metadata layer with search over documents and records that holds up in production: the reference architecture, the data model, search that combines filters, full text, facets and semantic retrieval under one permission model, and the records obligations that come with keeping documents, from registration to retention, legal hold and disposition. With industry patterns, a worked example, anti-patterns and an adoption checklist. 51 pages, free.
The series
Volume 1
Single View
One governed view of customers and citizens, assembled from the systems that already hold the data.
Volume 2
Document Management
Metadata-driven search over documents and records: one governed registry, search as the product, retention and legal hold by design.
Volume 3
Coming next
In preparation. Follow the series to be notified when it is released.
From the author
Most writing about data architecture describes systems as they look in a demo. This series describes them as they behave in production: inside banks, insurers, telecom operators, hospitals and public administrations, under regulation, legacy constraints and real budgets.
Each volume takes one architectural pattern and treats it end to end: the problem it solves, the reference design, the data model, the governance it requires, the mistakes that sink it, and a checklist to tell whether it is ready. The guides draw on more than thirty years of designing and delivering information systems, and they are written for the architects, data leads and decision makers who have to make these systems work.
How the guides are written
- Practice first: patterns, decisions and trade-offs that hold up in production, not product tours.
- One pattern per volume, from problem to adoption checklist.
- Concrete where it helps: reference implementations use real technologies, with their limits stated plainly.
- Free and open: every volume is distributed free of charge under a Creative Commons BY-NC-ND 4.0 licence.
- Corrections welcome: each edition is versioned and updated when readers find errors.
Get the next volume
An email when a new volume is out, with the free PDF. A few a year, free, and you can unsubscribe in one click.
Want every new essay too? See both lists.
Note
Real-World Architectures is an independent, non-commercial publication. The views expressed are the author’s own and do not represent those of his employer or of any organization he works or has worked with. Product names are trademarks of their respective owners.