implement basic login in the wui

README.md

@@ -3,7 +3,7 @@
 ![logo](doc/logo.svg "Skrimish")
 
 A stock exchange simulator.  The scope of this project is not yet defined but it should
-allow end user(s?) to exchange securities via the common exchange rules.
+allow end user(s?) to exchange securities via a kind of stock exchange
 
 
 ## Getting Started
@@ -26,8 +26,15 @@ All configuration are set in the `resources/config.edn` file.
 Configuration uses [aero](https://github.com/juxt/aero).  The configuration
 file should be self documented.
 
+
 ### Technologies
 
+#### Big architecture
+
+* [docker](https://www.docker.com/) because it is trendy.
+* [docker-compose](https://docs.docker.com/compose/) to manage system dependencies.
+* [jvm](https://en.wikipedia.org/wiki/Java_virtual_machine) because nothing beats it.
+
 #### Server
 * [clojure](https://clojure.org/) for programming language
 * [kafka](http://kafka.apache.org/) for message broker/database
@@ -35,9 +42,30 @@ file should be self documented.
 
 #### In the browser
 * [clojure script](https://clojurescript.org/) for programming language
-* [sparks](https://aftertheflood.com/projects/sparks/) for trivial charts
+* [reagent](https://reagent-project.github.io/) as frontend framework.  Simple and powerful.
 * [metricsgraphicsjs](http://metricsgraphicsjs.org/) for complex charts
-* [dc-js](http://dc-js.github.io/dc.js/) for some charting.
+* [dc-js](http://dc-js.github.io/dc.js/) for some charting.  Looks awesome!.
+
+
+### Architecture shenanigans
+
+As any personal project, over engineering it the only solution.  Moreover the
+scope of the project is unknown.  Consequently, there is a plethora of
+micro-servicesh.
+
+
+#### Micro services
+
+A micro service does one thing, and does it well.  Micro services communicate to the world
+via REST api and collaborate together via a global state kept in kafka.
+
+| name                        | description                                                               |  REST |
+|:----------------------------|:--------------------------------------------------------------------------|:-----:|
+| `skirmish.exchange`         | Exchange engine.  Knows nothing about what it trades.                     | `yes` |
+| `skirmish.exchange-gateway` | Public api to `skirmish.exchange`.  Dispatch an order to the proper place | `no`  |
+| `skirmish.ledger`           | Source of truth for who owns what.                                        | `yes` |
+| `skirmish.bookkeeper`       | Source of truth for the marker data.  Publishes market data to the world. | `yes` |
+
 
 
 ## License