• Stars
    star
    220
  • Rank 176,626 (Top 4 %)
  • Language
    C#
  • License
    MIT License
  • Created almost 6 years ago
  • Updated 26 days ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

A microservices powered e-commerce shopping cart sample - based on SOA principles. Demos and sample for my "All our Aggregates are Wrong" talk

All our Aggregates are Wrong - Demos

A microservices powered e-commerce shopping cart sample - based on SOA principles. These are the demos for my All our Aggregates are Wrong talk.

How to get the sample working locally

Get a copy of this repository

Clone or download this repo locally on your machine. If you're downloading a zip copy of the repo please be sure the zip file is unblocked before decompressing it. In order to unblock the zip file:

  • Right-click on the downloaded copy
  • Choose Property
  • On the Property page tick the unblock checkbox
  • Press OK

Check your machine is correctly configured

In order to run the sample the following machine configuration is required:

  • PowerShell execution policy to allow script execution, from an elevated PowerShell run the following:
Set-ExecutionPolicy Unrestricted

NOTE: On a clean machine do not install latest version, as of this writing 13.1, of Microsoft ODBC Driver and Microsoft ODBC Command Line Utilities as the latter is affected by a bug that prevents the LocalDb instance to be accessible at configuration time.

Databases setup

To simplify LocalDB instance setup 2 PowerShell scripts, in the scripts folder, are provided for your convenience. Both need to be run from an elevated PowerShell console.

  • Run Setup-Databases.ps1, with elevation, to create the LocalDB instance and all the required databases
  • Run Teardown-Databases.ps1, with elevation, to drop all the databases and delete the LocalDB instance

The created LocalDB instance is named (localdb)\all-our-aggregates-are-wrong.

NOTE: If you receive errors regarding "Microsoft ODBC Driver", you can work around these by connecting to the (localdb)\all-our-aggregates-are-wrong database using, for example, Visual Studio or SQL Managerment Studio, and running the SQL contained in the Setup-Databases.sql file to manually create databases.

NOTE: In case the database setup script fails with a "sqllocaldb command not found" error it is possible to install LocalDb as a standalone package by downloading it separately at https://www.microsoft.com/en-us/download/details.aspx?id=29062

Startup projects

Solutions is configured to use the SwitchStartupProject Visual Studio Extension to manage startup projects. The extension is not a requirement, it's handy.

The solution can be configured to run 3 different demos.

Demo (default)

Demos the default shopping cart behavior and all its implemented functionalities. Add items to the cart, observe the various "services" console windows they'll display log messages related to the ongoing processes. Leave the cart inactive for a few seconds and observe the stale cart policy kicking in, first raising a warning, finally deleting stale carts. Ensure the following projects are set as startup projects:

  • WebApp
  • Sales.Api
  • Marketing.Api
  • Warehouse.Api
  • Shipping.Api
  • Sales.Service
  • Marketing.Service
  • Warehouse.Service
  • Shipping.Service

Demo (failed services)

Demos what happens when a back-end service is not available. Add an item to the cart, visualize the shopping cart and observe the different information displayed in relation to the shipping estimates. Ensure the following projects are set as startup projects:

  • WebApp
  • Sales.Api
  • Marketing.Api
  • Warehouse.Api
  • Shipping.Api
  • Sales.Service
  • Marketing.Service

Demo (Platform)

Uses the Particular Platform Sample package to visualize monitoring information, and messages and policies (Sagas) runtime behaviors.

  • WebApp
  • Sales.Api
  • Marketing.Api
  • Warehouse.Api
  • Shipping.Api
  • Sales.Service
  • Marketing.Service
  • Warehouse.Service
  • Shipping.Service
  • PlatformLauncher

NServiceBus configuration

This sample has no NServiceBus related pre-requisites as it's configured to use Learning Transport and Learning Persistence, both explicitly designed for short term learning and experimentation purposes.

They should also not be used for longer-term development, i.e. the same transport and persistence used in production should be used in development and debug scenarios. Select a production transport and persistence before developing features.

NOTE: Do not use the learning transport or learning persistence to perform any kind of performance analysis.

Disclaimer

Parts of this demo are built using NServiceBus, I work for Particular Software, the makers of NServiceBus.

More Repositories

1

designing-a-ui-for-microservices-demos

Demos and sample for my "Designing a UI for Microservices" talk
C#
55
star
2

welcome-to-the-state-machine-demos

Demos and sample for my "Welcome to the (state) machine" talk
C#
26
star
3

distributed-systems-101

C#
22
star
4

Conferences

11
star
5

microservices-done-right-demos

C#
9
star
6

radical-directives

Radical Directives for AngularJS
JavaScript
9
star
7

Composite-UI-Sample

JavaScript
9
star
8

NServiceBus.IntegrationTesting

An end-to-end testing toolkit for NServiceBus based messaging systems.
C#
6
star
9

Radical.CQRS

C#
6
star
10

Introduction-to-messagging-with-RabbitMQ-CSharp

Demos for the UGIdotNET "Introduction to messaging with RabbitMQ & C#" Small Talk
C#
5
star
11

CompositeQuestionnaire

C#
5
star
12

NServiceBus.AttributeConventions

Attribute based conventions for NServiceBus messages, commands, and events.
C#
4
star
13

NServiceBus.Extensions.EndpointStarted

Enables to register a callback to be notified when the NServiceBus endpoints are started
C#
3
star
14

got-the-time-demos

Demos and sample for my "Got the Time" talk
C#
3
star
15

shopper

Shopper, a Services UI Composition and SOA sample
C#
3
star
16

composition-gateway-samples

A sample implementation of a Composition Gateway
C#
3
star
17

milestone.github.io

My personal blog
HTML
2
star
18

NServiceBus.TenantAwareSample

C#
2
star
19

NServiceBus.POCs.OCRProcessing

C#
2
star
20

KLab-Services-UI-Composition-Demos

C#
2
star
21

Jason

Jason is an infrastructure framework to easly put the "Command" part of CQRS on top of WCF & WebAPI
C#
2
star
22

NServiceBus.Extensions.DispatchRetries

C#
2
star
23

Mattox.NServiceBus

NServiceBus endpoints made simple
C#
2
star
24

NServiceBus.AttributeConventions.Contracts

Contracts to support attribute based conventions for NServiceBus messages, commands, and events.
C#
1
star
25

mauroservienti

Who I am
1
star
26

Eileen

A trivially simple library management tool for my dad
C#
1
star
27

immutable-message-samples

C#
1
star
28

use-tx-scope-with-nhibernate-and-outbox

Shows how to configure NServiceBus to use Outbox on SqlP and business data on NHibernate and share the same transaction
C#
1
star
29

Radical.CQRS.EntityFramework

C#
1
star