RolleiShop

E-commerce application where users may browse the catalog, manage their
shopping cart, submit orders (dummy or through stripe), and browse through
their order history. Admin users may manage the catalog (add and edit catalog
items). Features include distributed caching for the catalog items (via Redis),
in-memory catching for the catalog types and brands, localization, server-side
filtering (via specification pattern), and emails (via MailKit).

Architecture is vertically sliced, CQRS, with a rich, encapsulated
domain¹ (private collections and setters) with domain notifications
(for sending emails and product price changes) to explicitly implement side
effects. The application IO is fully-asynchronous and the errors are handled
with command results (similar to F#’s Option Type or Haskell’s Maybe monad).

1. The only exception to this (as far as I’m aware) is the ApplicationUser
   class which references Identity Framework.

Technology

• ASP.NET Core 2.0
• PostgreSQL
• Redis
• Identity 2.0
• Entity Framework Core 2.0
• MediatR
• FluentValidation
• NLog
• CSharpFunctionalExtensions
• Semantic UI
• Stripe API
• Noty
• Rellax
• Google Maps API

Screenshots

Index

The index and layout templates are translated to Japanese thanks to Google
translate (Most likely not too accurate).

Catalog

Filter catalog-items by brand and/or format.

Cart

Displays cart items with the abilities to update, clear, and checkout.
Checking out the cart publishes a domain notification to send customer emails.

Orders - Details

Displays your detailed order history.

Admin

Admin users may manage the catalog (and inventory). Updating the product price publishes
a domain notification to reflect the price change in the customer’s cart.

Run

With docker:

docker-compose build
docker-compose up
Go to http://localhost:5000

Alternatively, you will need .NET Core 2.0 SDK. If you have the SDK installed,
then open appsettings.Development.json and point the connection strings to
your PostgreSQL and Redis servers. Install the javascript dependencies (e.g.
npm install). You may optionally fill out the credentials for the mail
server.

cd into ./src/RolleiShop (if you are not already); then run:

webpack build
dotnet restore
dotnet ef database update -c ApplicationDbContext
dotnet ef database update -c IdentityDbContext
dotnet run
Go to http://localhost:5000

Deploy (Dockerized hosts)

This process is more thoroughly explained
here,
but I’ll summarize the steps required (mostly for my own reference).

Prerequisites: Docker Machine installed on your local machine and DigitalOcean
API token.

1. Create Dockerized hos

   docker-machine create --driver digitalocean --digitalocean-access-token
   $DOTOKEN machine-name

2. Activate Dockerized host

   eval (docker-machine env machine-name)

3. Build and run containers

   docker-compose -f docker-compose.yml -f docker-compose.prod.yml build
   docker-compose -f docker-compose.yml -f docker-compose.prod.yml up -d

4. Unset Dockerized host

   eval (docker-machine env -u)

NOTE

The resources I use to create this project were plentiful, coming from several
projects and tutorials provided by Microsoft (mostly eShopOnWeb,
eShopOnContainers, MVCMusicStore, and ContosoUniversity), Pluralsight, Jimmy
Bogards Contoso University remake, and several blogs.

TODO

configure webpack (for production)
Add more unit tests
Add Serverside sorting by price
Fix AJAX remove cart-items (low priority)