Skip to content

Architecture map

A map of your systems that the board understands and the engineers can build from.

Before buying, integrating or building software it pays to see the whole: what the business does, which applications hold it up, and which technology they run on. I draw that map in two languages that complement each other: ArchiMate for the enterprise and C4 for each system to be built or integrated. The result fits in a few pages and gets signed before the first line of code.

01

What it is for

Decide

With the whole in view

Ross, Weill and Robertson call it the core diagram: one page showing which processes, data and technologies the company must standardise to execute its strategy. It is the first sheet of the map.

Understand

The same drawing for everyone

Leadership, operations and engineering look at the same map at different zoom levels. Nobody has to translate between an org chart, a software contract and a network diagram.

Sign

Before building

What is going to be integrated or developed is described, with its boundaries and its decisions, before anyone asks for a quote. Changing a drawing costs an hour; changing a half-built system costs weeks.

02

C4: a map with zoom

The C4 model, by Simon Brown, describes a software system as a map with four levels of zoom: context, containers, components and code. Each level answers a different audience in the same language. Below, the first three for the ERP of the fictional distributor; the code level is only drawn when it is needed.

Level 1 · System context Orders andpays on the Enters orders Reconciles andcloses Importsstatements Files signedinvoices Sendsdocuments Customer Buys, checks their statementand pays Sales rep Enters orders from a phone Accountant Reconciles, files and closesthe month The distributor's ERP [Odoo 19 Community] Orders, inventory, invoicingand accounting in one system Bank Provides the accountstatements Tax authority Receives and clears e-invoices Email service Delivers invoices andstatements
Who uses the system and which other systems it talks to. For the board.
Level 2 · Containers of the ERP The distributor's ERP Uses in abrowser Uses in abrowser and on Queries Reads andwrites Runs Hands overinvoices Signed SOAP Files Loadstransactions Customer Sales rep and accountant Customer portal [Odoo website] Orders, invoices, balance andonline payment Web application [Odoo 19, Python] Sales, inventory, invoicingand accounting Scheduled jobs [Odoo scheduler] Mailings, reminders, automaticmatching Tax integration [OCA module] Signs the XML and files theinvoices Database [PostgreSQL 17] All the data, backed up daily Bank statement importer [OCA module] Reads the bank's files Tax authority Bank
The pieces that get deployed and how they talk. For whoever runs it and decides the infrastructure.
Level 3 · Components of the web application Web application Checks thelimit Releases Invoices whatwas delivered Leaves thebalance Feeds Quotations and orders [Sales] Price list, confirmation,portal Credit control [Sales and Accounting] Limit per customer, hold andapproval Deliveries [Inventory] Packing list, deliveredquantities Electronic invoicing [Accounting] Invoice from the delivery,signed and filed Bank reconciliation [Accounting] Rules by amount, reference andcounterparty Reports [Accounting] Receivables, trial balance,financial statements
What is inside a piece and which module covers it. For whoever configures and codes.

The zoom advances on its own; hover to stop it and pick a level. Every box says what it is, on which technology, and what it is for: that discipline is what makes a map readable without an explanation. The same discipline, applied to cameras, access control and alarms, is on integrated security with AI.

03

ArchiMate: business, applications and technology in one language

ArchiMate is The Open Group's standard for modelling the whole enterprise. One model holds motivation and strategy, the actors, roles and processes of the business, the applications with their services, and the technology underneath, joined by relationships that mean something: who performs what, what realises what, what serves whom. With it you can answer which applications hold up each process, what is affected if one changes, and where there is duplication.

Layered view in the ArchiMate style Motivation Business Application Technology realises serves performs realises realises serves realises realises hosts hosts serves accesses Collect every sale within 30 (Goal) Customer (Business actor) Sales rep (Business role) Order to cash (Business process) Order handling (Service) Order capture and invoicing (Service) Odoo Sales (Application component) Odoo Accounting (Application component) Customer portal (Application component) Cloud server (Node) PostgreSQL (System software) Sales rep's phone (Device)
The order-to-cash process of the fictional distributor, from the goal down to the technology. Each element carries its type in the label and relationships run only horizontally and vertically: two style rules from Wierda's book. The colours follow this site's palette; the delivered model opens in Archi, the free ArchiMate tool.

How it is modelled, with method

A map is worth what you can ask of it afterwards. These are the rules I apply, taken from Gerben Wierda's practice in Mastering ArchiMate and from the standard.

Structure and behaviour, kept apart

An application is not a box: it is the component that acts, the function it acts with, the service it offers and the data it touches. That is how you know what each application gives the business, not merely that it exists.

One model, many views

ArchiMate has a single view type: the whole enterprise. Each diagram is a cut of that model for one audience: leadership, operations or engineering. Nothing is drawn twice.

The same pattern for comparable things

Two similar applications are modelled the same way. That is what makes the model answer questions: which servers hold up a process that cannot stop for more than four hours, which applications depend on one vendor.

Relationships that mean something

Who performs what, what realises what, what serves whom. Relationships are chosen for what they say, not for the arrow that looks nice, and they read as sentences.

Quiet views

Lines only horizontal and vertical, no confusing crossings; elements of the same size on a grid; the element type written in the label for people who do not read models every day.

The source model, not the picture

What gets delivered is the model file, opened in Archi, with the views inside. Pictures can be regenerated; a model is queried and maintained.

04

What you get

Core diagram

One page with the company's operating model: which processes, data and technologies are shared across units and which are not. It follows the method of Ross, Weill and Robertson.

ArchiMate views

Business capabilities and processes, the applications that hold them up, the technology they run on, and the gaps between what exists and what is missing.

C4 model of the solution

Context, containers and components of what is going to be built or integrated, with the technology of each piece. The code level when it needs explaining.

Decisions on record

Every architecture decision with its context, the alternatives and the reason, in short versioned records. Whoever arrives later will know why.

The source model, not just images

The Archi file for ArchiMate and the C4 diagrams as code, so your team can keep editing them without depending on me.

A reading session

A session with leadership and engineering to read the map together, correct it and sign it.

05

Price

Two scopes at a fixed price. Half to start and half when the map is signed.

USD 700

Context map

One week. Core diagram, C4 context of the current systems, and one ArchiMate view of processes and applications. To know where the company stands before deciding.

USD 2,100

Solution architecture

Three weeks. Everything above plus the containers and components of the solution to be built or integrated, the technology view, the decisions on record, and the reading session.

If you come from the process mapping, the context map comes out of the same interviews and costs USD 350. If you go on to contract the implementation with me, the map is credited against it. Full refund of the deposit within fourteen days and before the first delivery, under the refund policy.

06

Frequently asked

What is the C4 model?

A way of describing a software system as a map with four levels of zoom: context, containers, components and code. Each level answers a different audience in the same language. It was proposed by Simon Brown.

What is ArchiMate and how is it different from C4?

ArchiMate is The Open Group's standard for modelling a whole enterprise: motivation, business, applications and technology in one model. C4 describes one concrete system. In an architecture map they are used together: ArchiMate for the whole, C4 for what is going to be built or integrated.

What do I receive, and in what format?

A PDF to sign, the source model in Archi for ArchiMate, the C4 diagrams as code and the architecture decisions on record, plus a reading session with leadership and engineering. Context map USD 700 in one week; solution architecture USD 2,100 in three weeks.

07 /

Ask for the map

Tell me which systems you run today and what you want to build or integrate. I reply with a proposal within one business day.

contacto@andresbrinez.com

+593 95 893 3406 · WhatsApp

By sending this form you agree that I use your details only to reply to you, under the privacy policy.

WhatsApp