docs: Includes instructions & inspirations

Author: ruiconti

README.md

@@ -22,12 +22,54 @@ This is intendend as both to serve as a scaffold for our internal projects as to
 - Aggregate's atomic services consistency guaranteed using `postgres` locks.
 - Isolated and pure domain layer that has no dependencies (no, not even ORM).
 
+## Roadmap 
+
+This is project's in its early stages, and should receive a big WIP tag. We should track progress using GitHub features:
+
+1. [https://github.com/t10d/kingdom-python-server/discussions](Discussions) for brainstorming & prioritizing
+1. [https://github.com/t10d/kingdom-python-server/milestones](Milestones) for planned features
+1. [https://github.com/t10d/kingdom-python-server/issues/](Issues) for ongoing tasks
+
+## Instructions
+
+As it is disclaimed the project current status, running *for now* means making sure tests pass.
+We are shortly improving the entire installation experience and usage. Hold tight.
+
+### Step 1: Dependencies & environment
+
+This projects uses `poetry` to manage dependencies.
+Having said that, how you instantiate your virtual environment is up to you. You can do that now.
+
+Inside your blank python virtual environment:
+
+```shell
+pip install poetry & poetry install
+```
+
+### Step 2: Prepare your database
+
+As there aren't any containerization being done for now, you'd need `postgres` up and running in your local machine.
+
+```shell
+psql -c "create database template"
+```
+
+### Step 3: Test it
+
+Right now you should be able to run the entire test-suite properly.
+
+```shell
+make test
+```
+
 
 ## Why?
 
 Why not use django? Or flask? Or FastAPI? Because these are great but heavily opiniated frameworks. We have a need to implement and deliver maintainable software we really know what's happening under the hood. 
 As a software house, we've come to find that by using such frameworks tends to inhibit programmers from practicing and improving their design skills.
 
+We're (obviously) not alone here. [https://github.com/pcah/python-clean-architecture](`pca`) have touched base a few years ago.
+
 ## Philosophy
 
 We are committed to these non-negotiables principle:
@@ -39,10 +81,13 @@ We are committed to these non-negotiables principle:
 
 ## Inspiration
 
-We don't claim to have created everything from scratch. Quite the opposite, all of these are inspirations from elsewhere.
+We don't claim to have created everything from scratch. Quite the opposite, the work here is a direct fork
+from ideas we really identify with that were hard earned throughout the past two decades.
 
 Specifically:
 
 1. Architecture Patterns with Python from Bob Gregory & Harry Percival,
+1. Python Clean Architecture, from [https://github.com/pcah](`pcah`)
 1. Functional Core, Imperative Shell from Destroy All Software,
-1. Hexagonal Architecture aka Ports & Adapters
+1. Hexagonal Architecture aka Ports & Adapters by Alistair Cockburn
+1. Domain-Driven-Design by Eric Evans & Martin Fowler