A stock exchange simulator. The scope of this project is not yet defined but it should allow end user(s?) to exchange securities via a kind of stock exchange

Getting Started

Development

In development, you need nothing else than clojure and leiningen. The easiest way to install clojure is to make sure you have java (8 and above) and install leiningen.

Production

You will need plenty of things, the majority of them are yet to define. But, a good kafka deployment will be required. Probably a database, hopefully datomic.

Configuration

All configuration are set in the resources/config.edn file. Configuration uses aero. The configuration file should be self documented.

Technologies

Big architecture

docker because it is trendy.
docker-compose to manage system dependencies.
jvm because nothing beats it.

Server

clojure for programming language
kafka for message broker/database
datomic-free for transaction needs
clickhouse to store the market data

In the browser

clojure script for programming language
reagent as frontend framework. Simple and powerful.
metricsgraphicsjs for complex charts
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

Distributed under the Eclipse Public License either version 1.0 or (at your option) any later version.