Every software project eventually reaches a point where adding another feature is no longer the difficult part.
Maintaining clarity is.
Over the past several years, ExMachina 7 has grown alongside the ideas it was built to support. With each iteration came new requirements, better understanding, and occasionally the realization that an earlier design no longer reflected the system we wanted to build.
ExMachina 8 is not a rewrite for the sake of rewriting.
It is an effort to establish a clearer foundation.
Rather than beginning with APIs or databases, development starts with defining the language of the system itself. Every concept must answer a simple question:
What responsibility does this object exist to fulfill—and nothing more?
This philosophy has shaped the first set of architectural contracts.
Entities represent persistent objects within the authentication domain.
Relationships describe how those entities are connected.
Workspaces define boundaries where application data belongs.
Principals represent the authority granted to an authenticated entity within a single workspace and execution context.
Each concept exists for one purpose, with carefully defined responsibilities and equally important non-responsibilities. By keeping these boundaries explicit, the architecture becomes easier to reason about, easier to extend, and significantly harder to misuse.
The goal is not to build the most complicated identity system possible.
The goal is to build one that remains understandable years from now.
There is still much work ahead before ExMachina 8 becomes production-ready. Interfaces will evolve, implementations will change, and many design decisions will continue to be challenged. That is expected.
Architecture is not measured by how quickly it is written.
It is measured by how well it continues to explain the system after the excitement of implementation has passed.
ExMachina 8 is still in its planning phase, but every project begins with a vocabulary. Before software can be implemented correctly, its ideas must first be defined precisely.
This is where that journey begins.
