madetech / clean-architecture

A (work-in-progress) guide to the methodology behind Made Tech Flavoured Clean Architecture

Clean Architecture

How to begin with "Made Tech Flavoured Clean Architecture".

This style of architecture has had many names over the years including "Hexagonal", "Ports & Adapters" and "Boundary-Control-Entity".

Getting started

Architectural Concepts

• Use Case
• Domain
• Gateway
• Bounded Contexts

Learn by example (Ruby)

The best way to learn Clean Architecture is through deliberate practice.

(Work-in-progress)

Basics

• The Mindset
• Start with Acceptance Testing
• Writing Fake Gateways
• Use Cases organise your code
• Constructors are for collaborators
• Don't leak your internals!
• TDD everything
• Build in a reliable dependency upgrade path
• Your first Real Gateway
• Your first Delivery Mechanism

Intermediate

• Presenters are more flexible
• Keep your wiring DRY
• Extend Use Case behaviour with Domain objects
• Extracting a Use Case from a Use Case
• Authentication
• Authorisation

Advanced

• Consider the Actors
• Substitutable Use Cases
• Feature Toggles
• Keep your Domain object construction DRY

Examples in Languages

• Ruby
• Kotlin
• Go
• Clojure
• JS

Further Reading

Clean Architecture by Robert C. Martin is extremely similar in nature to

• BCE by Ivar Jacobson and,
• Hexagonal Architecture (also known as Ports & Adapters) by Alistair Cockburn.

The Made Tech flavour is slightly different still to exactly what is described in Robert C. Martin's book about Clean Architecture, the choice to rename certain basic concept is deliberate to aid:

• Learning as a Junior
  • Relating Interactors (Robert's name for UseCase objects) to Use Case Analysis sessions
  • Retaining an eye on Domain-Driven-Design i.e. What are Domain objects?
  • Avoiding overloading terminology e.g. Entity (Robert's name for Domain Objects) with EntityFramework Entities

Made Tech flavour Clean Architecture is more prescriptive than any of these other examples

Reference

• Clean Coders videos
• Clean Architecture Book

clean-architecture's Issues

On folder Learn missing Clean Architecture layers

Hi!
I think this project would benefit from having the layers of Clean Architecture well defined, thus being Data, Domain and Presentation.

I would like to contribute to your repo with this, if you let me