Decent Chatbot Initial Architecture and Docs

decentstudio / decent-info

Knowledge base and documentation. Overarching concerns.

0 stars 0 forks source link

Decent Chatbot Initial Architecture and Docs #1

Open cjbarre opened 7 years ago

cjbarre commented 7 years ago

This is related to the system as a whole, not just the decent-event-receiver.

We need:

A rough wire-frame for our architecture.
A presentation to help convey the ideas.

We should:

Identify core components.
Identify key interactions between the components.
Identify key interactions with 3rd parties.

cjbarre commented 7 years ago

decent-chatbot-arc

cjbarre commented 7 years ago

Core Components:

Internal:

Decent Event Receiver (We Make This)
Decent Event Handler (We Make This)
Decent Event Bus (We Use This)

External:

Slack Events API
Slack Web API
External Services (Exchange API for fetching pricing)

cjbarre commented 7 years ago

Key interactions between our components:

Terms:

Decent Event Receiver (DER)
Decent Event Handler (DEH)
Decent Event Bus (DEB) a.k.a. Queue Layer

The DER publishes valid events to the DEB as messages
The DEB routes event messages based on topics to DEHs
The DEHs consume event messages from the DEB

The Slack Events API publishes Slack Events to the DER HTTP Endpoint
The DEHs respond to the user by sending HTTP requests to the Slack Web API

cjbarre commented 7 years ago

The Queue layer, aka DEB:

This could be:

A RabbitMQ service which we provision and maintain
Google Cloud Messaging

Our applications should remain fairly independent of the queuing service if we follow an architecture approach such as the Hexagonal Architecture.

cjbarre commented 7 years ago

Principles to live by:

cjbarre commented 7 years ago

We should plan to have our servers / services running in Docker containers.

Our containers will eventually be scheduled by Kubernetes

cjbarre commented 7 years ago

If we want Continuous Integration we can use:

cjbarre commented 7 years ago

WIP Presentation

cjbarre commented 7 years ago

:wave: @bpringe @ShawnCholeva

Can you guys start checking out the presentation linked in the comment above. Let me know if I can be more clear, or add more information, or ask any questions you may have. Most of the information is also in the comments in this issue.