{"id":19100224,"url":"https://github.com/charlessolar/eShopOnContainersDDD","last_synced_at":"2025-04-18T17:33:04.109Z","repository":{"id":39554397,"uuid":"130364468","full_name":"charlessolar/eShopOnContainersDDD","owner":"charlessolar","description":"Fork of dotnet-architecture/eShopOnContainers in full DDD/CQRS design using my own patterns","archived":false,"fork":false,"pushed_at":"2023-03-04T00:19:52.000Z","size":5117,"stargazers_count":318,"open_issues_count":30,"forks_count":43,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-07-23T15:32:13.260Z","etag":null,"topics":["backend","cqrs","cqrs-es","ddd","domain-driven-design","eventsourcing","eventstore","example","frontend","microservices","mobx","mobx-state-tree","netstandard","nservicebus","react","servicestack","typescript"],"latest_commit_sha":null,"homepage":null,"language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/charlessolar.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2018-04-20T13:16:34.000Z","updated_at":"2024-07-18T12:16:56.000Z","dependencies_parsed_at":"2024-01-03T06:56:12.535Z","dependency_job_id":"8fa92026-7003-4269-a025-ff7118e39379","html_url":"https://github.com/charlessolar/eShopOnContainersDDD","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/charlessolar%2FeShopOnContainersDDD","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/charlessolar%2FeShopOnContainersDDD/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/charlessolar%2FeShopOnContainersDDD/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/charlessolar%2FeShopOnContainersDDD/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/charlessolar","download_url":"https://codeload.github.com/charlessolar/eShopOnContainersDDD/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223783092,"owners_count":17201903,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["backend","cqrs","cqrs-es","ddd","domain-driven-design","eventsourcing","eventstore","example","frontend","microservices","mobx","mobx-state-tree","netstandard","nservicebus","react","servicestack","typescript"],"created_at":"2024-11-09T03:52:35.626Z","updated_at":"2024-11-09T03:53:22.336Z","avatar_url":"https://github.com/charlessolar.png","language":"C#","readme":"# eShopOnContainers (Aggregates.Net Edition)\n\nThis project is a fork (maybe better a loose copy) of Microsoft's container example [eShopOnContainers](https://github.com/dotnet-architecture/eShopOnContainers).  I implemented many of the same objects using my own DDD, EventSourcing library [Aggregates.NET](https://github.com/volak/Aggregates.NET) and its meant to be an illustrative example of a fully event sourced application.\n\n## Like what you see?\n\nWe're hiring developers!  We are currently looking for a couple people to help develop new software for small/medium businesses - remote OK but located around Chicago is ideal.  If you have an interest in learning DDD, CQRS, EventSourcing and making distributed systems less complex send me an email or better yet open a pull request!\n\n### Live Demo\n\nCurrently disabled\n\n### Wiki\n\nThere are articles in the Wiki about certain features of the app / how certain things are handled and implemented - check them out!\n\n### Disclaimer\n\nThis is a project written over the course of a month in my free time.  Its not bug free, its not exploit free, it may not even be very clean in places.  Please don't judge too harsly 🙏 \n\n# Instructions\n\n**Linux Only**\n\nOne docker image we require to run (eventstore) doesn't have a windows container - so run `docker-compose` on linux only for now!\n\n**Start**\n\nfrom the linux-cli directory\n```\nexport SERVICESTACK_LICENSE=\u003c-Your license-\u003e\nexport HOST_SERVER=\u003c-Machine's ip address-\u003e\n./build.sh\n./up.sh\n```\n\n**Note**\n\nA NServiceBus license is not required to run this example - but a servicestack license is.\nIts also required to supply the host machine's ip - use `localhost` if running localy\n\n### What is EventSourcing?\n\nEventSourcing is a process of representing domain objects (Orders, Invoices, Accounts, etc) as a series of separate events.\n\nYour application ends up being 1 long audit log which records every state-changing event that occurs.  The advantage of this approach is other processes can read this event log and generate models that contain only the information the process cares about.  There is also additional information available that other services perhaps don't record themselves.\n\nImagine a shoppign cart which fills with items to buy.  The warehouse only cares about the final order of the stuff the customer actually agreed to purchase -\n\n\u003cimg src=\"img/eventsourcing.png\" height=\"400px\"\u003e\n\nbut the marketing team might care more about the items the customer removed from their cart **without** buying.  \n\nUsing eventsourcing correctly you can generate models which contain both sets of information to satisfy both departments with only 1 set of data.\n\n### What is CQRS\n\nCQRS stands for **Command and Query Responsibility Segregation**\n\n\u003cimg src=\"img/cqrs-logical.svg\" height=\"400px\"\u003e\n\nIn a nut shell - commands are everything that want to change the application state.  Queries are anything that want to read application state.  **There is no overlap**\n\nCommands do not return any data other than if they were *Accepted* or *Rejected*. Accepted meaning the change was saved and read models will be updated.  Rejected meaning the command failed validation or was not valid to be run at this time.  (One example would be trying to invoice a sales order twice)\n\n## Architecture Overview\n\n\u003cimg src=\"img/overview.png\" height=\"400px\"\u003e\n\n## Commands Processing\n\n\u003cimg src=\"img/commands.png\" height=\"400px\"\u003e\n\n### Good reads\n\n* [Microsoft's CQRS architecture guide](https://docs.microsoft.com/en-us/azure/architecture/guide/architecture-styles/cqrs)\n* [Microsoft's eventsourcing architecture guide](https://docs.microsoft.com/en-us/azure/architecture/patterns/event-sourcing)\n\n### Libraries Used\n\n**Backend**\n* [Aggregates.NET](https://github.com/volak/Aggregates.NET)\n* [NServiceBus](https://github.com/Particular/NServiceBus)\n* [ServiceStack](https://github.com/ServiceStack/ServiceStack)\n* [NEST](https://github.com/elastic/elasticsearch-net)\n* [MongoDB.Driver](https://docs.mongodb.com/ecosystem/drivers/csharp/)\n\n**FrontEnd**\n* [Typescript](https://github.com/Microsoft/TypeScript)\n* [MobX State Tree](https://github.com/mobxjs/mobx-state-tree)\n* [React](https://github.com/facebook/react)\n* [MaterialUi](https://github.com/mui-org/material-ui)\n","funding_links":[],"categories":["frontend","typescript","Architectural Patterns"],"sub_categories":["Domain Driven Design - Domain Centric"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcharlessolar%2FeShopOnContainersDDD","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcharlessolar%2FeShopOnContainersDDD","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcharlessolar%2FeShopOnContainersDDD/lists"}