As it is nearing Halloween, a discussion of skeletons seems in order. To quote a couple of less eerie definitions from Merriam-Webster:
skel·e·ton \ˈske-lə-tən\ ... 2: something reduced to its minimum form or essential parts ... 4a : something forming a structural framework
A "walking skeleton" is an implementation of the thinnest possible slice of real functionality that we can automatically build, deploy, and test end-to-end.
A fully "walking" skeleton is my first milestone, but I felt that it was time to commit something and describe the shape that my architecture is initially taking.
My plan is to adopt the "micro-services" style for this system. I am interested in further exploring service-oriented architectures and micro-services with this project. My past use of SOA has been enough to convince me that it is a lot easier to reason about smaller, independent services than a single monolithic app. (I hope to have more to say on micro-services as I explore more.)
This architecture means multiple deployed artifacts. My current plan is to use Heroku to ultimately host these services, but that is fodder for another blog post. For now, getting a multiple artifact deployment to work locally means that I have had to solve at least one interesting problem.
From a component perspective, I have separated my design into three separate components for this first skeleton:
server/core- Core domain, as in the Ports and Adapters pattern. First version is a simple stub that returns the time.
server/<tech>- This adapter is in the form of an HTTP server that serves REST requests and responses. The first implementation is using Finagle, but that could be swapped out in the future.
client/<type>- Technically, a separate domain that talks to the server component over REST. The first client is a webpage version. (I do have a future itch for a mobile version, maybe iOS...) This web client could have be implemented in standard webapp style (i.e. serving the web artifacts from the same REST server), but to keep up the rigor of micro-services, I have kept them separate.
With this architecture, comes a set of tools:
That's the 0.0.1 version. Next up on getting this skeleton to walk, is testing...