Permalink
Browse files

‚Initial`commit 🚀

  • Loading branch information...
zweizeichen committed Jul 30, 2017
1 parent 8ad5065 commit 4f8b27b67b635716771e5ace8e14849bc6ef1549
Showing with 63 additions and 17 deletions.
  1. +0 −17 .gitignore
  2. BIN 43.png
  3. +12 −0 LICENSE
  4. +51 −0 README.md
  5. BIN architecture.png

This file was deleted.

Oops, something went wrong.
BIN +10.6 KB 43.png
Binary file not shown.
12 LICENSE
@@ -0,0 +1,12 @@
Copyright (c) 2017, EVE-Tools
All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
@@ -0,0 +1,51 @@
<p align="center">
<img src="43.png" alt="logo 43"></img>
<br />
<span>
<a href="https://element-43.com" target="_blank">Website</a> |
<a href="https://news.element-43.com" target="_blank">News</a> |
<a href="https://element-43.com/about" target="_blank">About</a> |
<a href="https://tweetfleet.slack.com/messages/element43/" target="_blank">Slack</a>
</span>
</p>
# element43
[Element43](https://element-43.com) is a free and open web application providing market data for players of the MMORPG [EVE Online](https://www.eveonline.com). This includes the near real-time collection and processing of order book data of the entire game's economy as well as the calculation of various metrics for analytics based on historic price data. Data can be accessed via a modern web-based UI or a simple HTTP API serving JSON. The application's current backend is split into multiple modular components/services implemented in a variety of languages. Builds are executed automatically and the whole application can be deployed as a collection of Docker containers. Work on element43 was started by a small group of developers spread all over the globe in summer 2012. More info can be found on the project's ['about' page](https://element-43.com/about).
## Components
This repo serves as the entry point into element43's infrastructure. The components listed here are under active development and serve as the application's core. Follow the links in the first column to access the component's code and documentation. Until we provide an updated version of our development environment and the getting started guide, just ping us on Slack if you have any questions. Running individual components is a matter of executing a Docker container configured as outlined in the individual service's docs.
---
![architecture](architecture.png "Simplified architecture diagram")
*A simplified diagram of element43's architecture excluding external APIs.*
---
| | CI Status | Container Image | Language | Description |
| --- | --- | --- | --- | --- |
| [market-streamer](https://github.com/EVE-Tools/market-streamer) | [![Build Status](https://drone.element-43.com/api/badges/EVE-Tools/market-streamer/status.svg)](https://drone.element-43.com/EVE-Tools/market-streamer) | [![Docker Image](https://images.microbadger.com/badges/image/evetools/market-streamer.svg)](https://microbadger.com/images/evetools/market-streamer) | Go | Fetches market data from [ESI](https://esi.tech.ccp.is/latest/), converts it into [UUDIF](http://dev.eve-central.com/unifieduploader/start) and streams it via ZMQ. Drop-in replacement for [EMDR](http://www.eve-emdr.com/en/latest/). |
| [emdr-to-nsq](https://github.com/EVE-Tools/emdr-to-nsq) | [![Build Status](https://drone.element-43.com/api/badges/EVE-Tools/emdr-to-nsq/status.svg)](https://drone.element-43.com/EVE-Tools/emdr-to-nsq) | [![Docker Image](https://images.microbadger.com/badges/image/evetools/emdr-to-nsq.svg)](https://microbadger.com/images/evetools/emdr-to-nsq) | Go | Takes market data from ZMQ stream, performs deduplication and pushes data onto a NSQ-Queue |
| [order-server](https://github.com/EVE-Tools/order-server) | [![Build Status](https://drone.element-43.com/api/badges/EVE-Tools/order-server/status.svg)](https://drone.element-43.com/EVE-Tools/order-server) | [![Docker Image](https://images.microbadger.com/badges/image/evetools/order-server.svg)](https://microbadger.com/images/evetools/order-server) | Go | Stores order info from NSQ in Postgres DB and provides data as JSON via HTTP |
| [static-data](https://github.com/EVE-Tools/static-data) | [![Build Status](https://drone.element-43.com/api/badges/EVE-Tools/static-data/status.svg)](https://drone.element-43.com/EVE-Tools/static-data) | [![Docker Image](https://images.microbadger.com/badges/image/evetools/static-data.svg)](https://microbadger.com/images/evetools/static-data) | Go | Proxies and caches batch-calls to various in-game location APIs (1st/3rd party) and provides a uniform data format via API |
| [top-stations](https://github.com/EVE-Tools/top-stations) | [![Build Status](https://drone.element-43.com/api/badges/EVE-Tools/top-stations/status.svg)](https://drone.element-43.com/EVE-Tools/top-stations) | [![Docker Image](https://images.microbadger.com/badges/image/evetools/top-stations.svg)](https://microbadger.com/images/evetools/top-stations) | Python 3 | Generates metrics for individual station's markets using data from [order-server](https://github.com/EVE-Tools/order-server)'s API hourly |
| [market-stats](https://github.com/EVE-Tools/market-stats) | [![Build Status](https://drone.element-43.com/api/badges/EVE-Tools/market-stats/status.svg)](https://drone.element-43.com/EVE-Tools/market-stats) | [![Docker Image](https://images.microbadger.com/badges/image/evetools/market-stats.svg)](https://microbadger.com/images/evetools/market-stats) | Go | Generates price/volume statistics for the entire economy every night. Data is accessible in JSON format. |
| Frontend | | | JavaScript | Element43's SPA frontend based on VueJS/NuxtJS. Not yet open-sourced. |
## Legacy Components
These are legacy components of the application's older iterations which no longer are under active development. They were superseeded by the components listed above.
| | CI Status | Container Image | Language | Description |
| --- | --- | --- | --- | --- |
| [element43-django](https://github.com/EVE-Tools/element43-django) | - | - | Python 2 / Web | Legacy monolithic web application based on Django, switched to componentized structure due to reasons outlined [here](https://news.element-43.com/redesigning-element43/). Legacy docs can be found [here](http://element43.readthedocs.io/en/latest/).
| [node-43](https://github.com/EVE-Tools/node-43) | [![Build Status](https://img.shields.io/travis/EVE-Tools/node-43.svg?style=flat)](https://travis-ci.org/EVE-Tools/node-43) | - | JavaScript | The Django application's market data ingestion service. Takes data from [EMDR](http://www.eve-emdr.com/en/latest/) and stores it in Postgres DB. Worked nicely, however integration of data/services via DB generates tight coupling between applications.
| [vagrant-element43](https://github.com/EVE-Tools/vagrant-element43) | - | - | Vagrant/Ansible | A dev environment for the Django-based Element43 made with Vagrant and Ansible for getting started fast. Now everything is based on Docker and even faster.
| [search43](https://github.com/EVE-Tools/search43) | [![Build Status](https://drone.element-43.com/api/badges/EVE-Tools/search43/status.svg)](https://drone.element-43.com/EVE-Tools/search43) | [![Docker Image](https://images.microbadger.com/badges/image/evetools/search43.svg)](https://microbadger.com/images/evetools/search43) | Python 3 | A simple live-search API for Element43/EVE. Replaced by [ESI](https://esi.tech.ccp.is/latest/)'s official endpoint.
| [emdr_consumer](https://github.com/EVE-Tools/emdr_consumer) | [![Build Status](https://drone.element-43.com/api/badges/EVE-Tools/emdr_consumer/status.svg)](https://drone.element-43.com/EVE-Tools/emdr_consumer) | [![Docker Image](https://images.microbadger.com/badges/image/evetools/emdr_consumer.svg)](https://microbadger.com/images/evetools/emdr_consumer) | Elixir | A market data consumer similar to [emdr-to-nsq](https://github.com/EVE-Tools/emdr-to-nsq) written in Elixir. Rewritten in Go because of library ecosystem and resource consumption.
| [orders](https://github.com/EVE-Tools/orders) | [![Build Status](https://drone.element-43.com/api/badges/EVE-Tools/orders/status.svg)](https://drone.element-43.com/EVE-Tools/orders) | [![Docker Image](https://images.microbadger.com/badges/image/evetools/orders.svg)](https://microbadger.com/images/evetools/orders) | Elixir | A prototype of a market data storage backend similar to [order-server](https://github.com/EVE-Tools/order-server) written in Elixir.
| [static_data](https://github.com/EVE-Tools/static_data) | [![Build Status](https://drone.element-43.com/api/badges/EVE-Tools/static_data/status.svg)](https://drone.element-43.com/EVE-Tools/static_data) | [![Docker Image](https://images.microbadger.com/badges/image/evetools/static_data.svg)](https://microbadger.com/images/evetools/static_data) | Elixir | A prototype of a static data proxy similar to [static-data](https://github.com/EVE-Tools/static-data) written in Elixir.
| [crest](https://github.com/EVE-Tools/crest) | [![Build Status](https://drone.element-43.com/api/badges/EVE-Tools/crest/status.svg)](https://drone.element-43.com/EVE-Tools/crest) | - | Elixir | A WIP Elixir client library for the now deprecated CREST API.
| [elixir-build-base](https://github.com/EVE-Tools/elixir-build-base) | [![Build Status](https://drone.element-43.com/api/badges/EVE-Tools/elixir-build-base/status.svg)](https://drone.element-43.com/EVE-Tools/elixir-build-base) | [![Docker Image](https://images.microbadger.com/badges/image/evetools/elixir-build-base.svg)](https://microbadger.com/images/evetools/elixir-build-base) | Docker | Base container image for Elixir-based builds. Not needed anymore.
BIN +227 KB architecture.png
Binary file not shown.

0 comments on commit 4f8b27b

Please sign in to comment.