[
{
"path": ".github/workflows/buildPipeline.yml",
"content": "name: CI Pipeline\n\non:\n push:\n branches: [master]\n pull_request:\n branches: [master]\n\njobs:\n build:\n name: Build and run Unit and Architecture Tests\n runs-on: ubuntu-latest\n\n steps:\n - uses: actions/checkout@v4\n - name: Setup .NET\n uses: actions/setup-dotnet@v4\n with:\n dotnet-version: 8.0.x\n - name: Run build\n run: ./build.sh BuildAndUnitTests --configuration Release\n\n integration:\n name: Build and run Integration Tests\n needs: [build]\n runs-on: ubuntu-latest\n\n steps:\n - uses: actions/checkout@v4\n - name: Setup .NET\n uses: actions/setup-dotnet@v4\n with:\n dotnet-version: 8.0.x\n - name: Run build\n run: ./build.sh RunAllIntegrationTests\n"
},
{
"path": ".gitignore",
"content": "## Ignore Visual Studio temporary files, build results, and\n## files generated by popular Visual Studio add-ons.\n\n# User-specific files\n*.suo\n*.user\n*.userosscache\n*.sln.docstates\n.vscode/\n\n# User-specific files (MonoDevelop/Xamarin Studio)\n*.userprefs\n\n# Build results\n[Dd]ebug/\n[Dd]ebugPublic/\n[Rr]elease/\n[Rr]eleases/\nx64/\nx86/\nbld/\n[Bb]in/\n[Oo]bj/\n[Ll]og/\n\n# Visual Studio 2015 cache/options directory\n.vs/\n# Uncomment if you have tasks that create the project's static files in wwwroot\n**/wwwroot/lib/\n!/wwwroot/lib/signalr\n!/wwwroot/lib/toastr\n\n# MSTest test Results\n[Tt]est[Rr]esult*/\n[Bb]uild[Ll]og.*\n\n# NUNIT\n*.VisualState.xml\nTestResult.xml\n\n# Build Results of an ATL Project\n[Dd]ebugPS/\n[Rr]eleasePS/\ndlldata.c\n\n# DNX\nproject.lock.json\nartifacts/\n\n*_i.c\n*_p.c\n*_i.h\n*.ilk\n*.meta\n*.obj\n*.pch\n*.pdb\n*.pgc\n*.pgd\n*.rsp\n*.sbr\n*.tlb\n*.tli\n*.tlh\n*.tmp\n*.tmp_proj\n*.log\n*.vspscc\n*.vssscc\n.builds\n*.pidb\n*.svclog\n*.scc\n\n# Chutzpah Test files\n_Chutzpah*\n\n# Visual C++ cache files\nipch/\n*.aps\n*.ncb\n*.opendb\n*.opensdf\n*.sdf\n*.cachefile\n*.VC.db\n*.VC.VC.opendb\n\n# Visual Studio profiler\n*.psess\n*.vsp\n*.vspx\n*.sap\n\n# TFS 2012 Local Workspace\n$tf/\n\n# Guidance Automation Toolkit\n*.gpState\n\n# ReSharper is a .NET coding add-in\n_ReSharper*/\n*.[Rr]e[Ss]harper\n*.DotSettings.user\n\n# JustCode is a .NET coding add-in\n.JustCode\n\n# TeamCity is a build add-in\n_TeamCity*\n\n# DotCover is a Code Coverage Tool\n*.dotCover\n\n# NCrunch\n_NCrunch_*\n.*crunch*.local.xml\nnCrunchTemp_*\n\n# MightyMoose\n*.mm.*\nAutoTest.Net/\n\n# Web workbench (sass)\n.sass-cache/\n\n# Installshield output folder\n[Ee]xpress/\n\n# DocProject is a documentation generator add-in\nDocProject/buildhelp/\nDocProject/Help/*.HxT\nDocProject/Help/*.HxC\nDocProject/Help/*.hhc\nDocProject/Help/*.hhk\nDocProject/Help/*.hhp\nDocProject/Help/Html2\nDocProject/Help/html\n\n# Click-Once directory\npublish/\n\n# Publish Web Output\n*.[Pp]ublish.xml\n*.azurePubxml\n# TODO: Comment the next line if you want to checkin your web deploy settings\n# but database connection strings (with potential passwords) will be unencrypted\n*.pubxml\n*.publishproj\n\n# Microsoft Azure Web App publish settings. Comment the next line if you want to\n# checkin your Azure Web App publish settings, but sensitive information contained\n# in these scripts will be unencrypted\nPublishScripts/\n\n# NuGet Packages\n*.nupkg\n# The packages folder can be ignored because of Package Restore\n**/packages/*\n# except build/, which is used as an MSBuild target.\n!**/packages/build/\n# Uncomment if necessary however generally it will be regenerated when needed\n#!**/packages/repositories.config\n# NuGet v3's project.json files produces more ignoreable files\n*.nuget.props\n*.nuget.targets\n\n# Microsoft Azure Build Output\ncsx/\n*.build.csdef\n\n# Microsoft Azure Emulator\necf/\nrcf/\n\n# Windows Store app package directories and files\nAppPackages/\nBundleArtifacts/\nPackage.StoreAssociation.xml\n_pkginfo.txt\n\n# Visual Studio cache files\n# files ending in .cache can be ignored\n*.[Cc]ache\n# but keep track of directories ending in .cache\n!*.[Cc]ache/\n\n# Others\nClientBin/\n~$*\n*~\n*.dbmdl\n*.dbproj.schemaview\n*.jfm\n*.publishsettings\nnode_modules/\norleans.codegen.cs\n\n# Since there are multiple workflows, uncomment next line to ignore bower_components\n# (https://github.com/github/gitignore/pull/1529#issuecomment-104372622)\n#bower_components/\n\n# RIA/Silverlight projects\nGenerated_Code/\n\n# Backup & report files from converting an old project file\n# to a newer Visual Studio version. Backup files are not needed,\n# because we have git ;-)\n_UpgradeReport_Files/\nBackup*/\nUpgradeLog*.XML\nUpgradeLog*.htm\n\n# SQL Server files\n*.mdf\n*.ldf\n\n# Business Intelligence projects\n*.rdl.data\n*.bim.layout\n*.bim_*.settings\n\n# Microsoft Fakes\nFakesAssemblies/\n\n# GhostDoc plugin setting file\n*.GhostDoc.xml\n\n# Node.js Tools for Visual Studio\n.ntvs_analysis.dat\n\n# Visual Studio 6 build log\n*.plg\n\n# Visual Studio 6 workspace options file\n*.opt\n\n# Visual Studio LightSwitch build output\n**/*.HTMLClient/GeneratedArtifacts\n**/*.DesktopClient/GeneratedArtifacts\n**/*.DesktopClient/ModelManifest.xml\n**/*.Server/GeneratedArtifacts\n**/*.Server/ModelManifest.xml\n_Pvt_Extensions\n\n# Paket dependency manager\n.paket/paket.exe\npaket-files/\n\n# FAKE - F# Make\n.fake/\n\n# JetBrains Rider\n.idea/\n*.sln.iml\npub/\n/src/Web/WebMVC/Properties/PublishProfiles/eShopOnContainersWebMVC2016 - Web Deploy-publish.ps1\n/src/Web/WebMVC/Properties/PublishProfiles/publish-module.psm1\n/src/Services/Identity/eShopOnContainers.Identity/Properties/launchSettings.json\n\n#Ignore marker-file used to know which docker files we have.\n.eshopdocker_*\n/src/Web/WebMVC/wwwroot/lib\n/src/Web/WebMVC/wwwroot/css/site.min.css\n**/.kube/**\n.mfractor\n\n#Ignore logs folder\n[Ll]ogs\n\n#Ignore uploaded files folder\nUploadedFiles\n/src/CompanyName.MyMeetings.v3.ncrunchsolution\n\n#Nuke working directory\n.nuke-working-directory\n/src/API/CompanyName.MyMeetings.API/tempkey.jwk\n"
},
{
"path": ".nuke/build.schema.json",
"content": "{\n \"$schema\": \"http://json-schema.org/draft-04/schema#\",\n \"$ref\": \"#/definitions/build\",\n \"title\": \"Build Schema\",\n \"definitions\": {\n \"build\": {\n \"type\": \"object\",\n \"properties\": {\n \"Configuration\": {\n \"type\": \"string\",\n \"description\": \"Configuration to build - Default is 'Debug' (local) or 'Release' (server)\",\n \"enum\": [\n \"Debug\",\n \"Release\"\n ]\n },\n \"Continue\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates to continue a previously failed build attempt\"\n },\n \"DatabaseConnectionString\": {\n \"type\": \"string\",\n \"description\": \"Modular Monolith database connection string\"\n },\n \"Help\": {\n \"type\": \"boolean\",\n \"description\": \"Shows the help text for this build assembly\"\n },\n \"Host\": {\n \"type\": \"string\",\n \"description\": \"Host for execution. Default is 'automatic'\",\n \"enum\": [\n \"AppVeyor\",\n \"AzurePipelines\",\n \"Bamboo\",\n \"Bitbucket\",\n \"Bitrise\",\n \"GitHubActions\",\n \"GitLab\",\n \"Jenkins\",\n \"Rider\",\n \"SpaceAutomation\",\n \"TeamCity\",\n \"Terminal\",\n \"TravisCI\",\n \"VisualStudio\",\n \"VSCode\"\n ]\n },\n \"NoLogo\": {\n \"type\": \"boolean\",\n \"description\": \"Disables displaying the NUKE logo\"\n },\n \"Partition\": {\n \"type\": \"string\",\n \"description\": \"Partition to use on CI\"\n },\n \"Plan\": {\n \"type\": \"boolean\",\n \"description\": \"Shows the execution plan (HTML)\"\n },\n \"Profile\": {\n \"type\": \"array\",\n \"description\": \"Defines the profiles to load\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"Root\": {\n \"type\": \"string\",\n \"description\": \"Root directory during build execution\"\n },\n \"Skip\": {\n \"type\": \"array\",\n \"description\": \"List of targets to be skipped. Empty list skips all dependencies\",\n \"items\": {\n \"type\": \"string\",\n \"enum\": [\n \"ArchitectureTests\",\n \"BuildAdministrationModuleIntegrationTests\",\n \"BuildAndUnitTests\",\n \"BuildMeetingsModuleIntegrationTests\",\n \"BuildPaymentsModuleIntegrationTests\",\n \"BuildSystemIntegrationTests\",\n \"BuildUserAccessModuleIntegrationTests\",\n \"Clean\",\n \"Compile\",\n \"CompileDbUpMigrator\",\n \"CompileDbUpMigratorForIntegrationTests\",\n \"CreateDatabase\",\n \"MigrateDatabase\",\n \"PrepareInputFiles\",\n \"PrepareSqlServer\",\n \"PrepareSUT\",\n \"Restore\",\n \"RunAdministrationModuleIntegrationTests\",\n \"RunAllIntegrationTests\",\n \"RunDatabaseMigrations\",\n \"RunMeetingsModuleIntegrationTests\",\n \"RunPaymentsModuleIntegrationTests\",\n \"RunSystemIntegrationTests\",\n \"RunUserAccessModuleIntegrationTests\",\n \"UnitTests\"\n ]\n }\n },\n \"Solution\": {\n \"type\": \"string\",\n \"description\": \"Path to a solution file that is automatically loaded\"\n },\n \"SUTTestName\": {\n \"type\": \"string\",\n \"description\": \"SUT creator test name to execute\"\n },\n \"Target\": {\n \"type\": \"array\",\n \"description\": \"List of targets to be invoked. Default is '{default_target}'\",\n \"items\": {\n \"type\": \"string\",\n \"enum\": [\n \"ArchitectureTests\",\n \"BuildAdministrationModuleIntegrationTests\",\n \"BuildAndUnitTests\",\n \"BuildMeetingsModuleIntegrationTests\",\n \"BuildPaymentsModuleIntegrationTests\",\n \"BuildSystemIntegrationTests\",\n \"BuildUserAccessModuleIntegrationTests\",\n \"Clean\",\n \"Compile\",\n \"CompileDbUpMigrator\",\n \"CompileDbUpMigratorForIntegrationTests\",\n \"CreateDatabase\",\n \"MigrateDatabase\",\n \"PrepareInputFiles\",\n \"PrepareSqlServer\",\n \"PrepareSUT\",\n \"Restore\",\n \"RunAdministrationModuleIntegrationTests\",\n \"RunAllIntegrationTests\",\n \"RunDatabaseMigrations\",\n \"RunMeetingsModuleIntegrationTests\",\n \"RunPaymentsModuleIntegrationTests\",\n \"RunSystemIntegrationTests\",\n \"RunUserAccessModuleIntegrationTests\",\n \"UnitTests\"\n ]\n }\n },\n \"Verbosity\": {\n \"type\": \"string\",\n \"description\": \"Logging verbosity during build execution. Default is 'Normal'\",\n \"enum\": [\n \"Minimal\",\n \"Normal\",\n \"Quiet\",\n \"Verbose\"\n ]\n }\n }\n }\n }\n}\n"
},
{
"path": ".nuke/parameters.json",
"content": "{\n \"$schema\": \"./build.schema.json\",\n \"Solution\": \"src/CompanyName.MyMeetings.sln\"\n}"
},
{
"path": "LICENSE",
"content": "MIT License\n\nCopyright (c) 2019 Kamil Grzybek\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n"
},
{
"path": "README.md",
"content": "# Modular Monolith with DDD\n\nFull Modular Monolith .NET application with Domain-Driven Design approach.\n\n## Announcement\n\n\n\nLearn, use and benefit from this project only if:\n\n- You **condemn Russia and its military aggression against Ukraine**\n- You **recognize that Russia is an occupant that unlawfully invaded a sovereign state**\n- You **support Ukraine's territorial integrity, including its claims over temporarily occupied territories of Crimea and Donbas**\n- You **reject false narratives perpetuated by Russian state propaganda**\n\nOtherwise, leave this project immediately and educate yourself.\n\nPutin, idi nachuj.\n\n## CI\n\n\n\n## FrontEnd application\n\nFrontEnd application : [Modular Monolith With DDD: FrontEnd React application](https://github.com/kgrzybek/modular-monolith-with-ddd-fe-react)\n\n## Table of contents\n\n[1. Introduction](#1-introduction)\n\n [1.1 Purpose of this Repository](#11-purpose-of-this-repository)\n\n [1.2 Out of Scope](#12-out-of-scope)\n\n [1.3 Reason](#13-reason)\n\n [1.4 Disclaimer](#14-disclaimer)\n\n [1.5 Give a Star](#15-give-a-star)\n\n [1.6 Share It](#16-share-it)\n\n[2. Domain](#2-domain)\n\n [2.1 Description](#21-description)\n\n [2.2 Conceptual Model](#22-conceptual-model)\n\n [2.3 Event Storming](#23-event-storming)\n\n[3. Architecture](#3-architecture)\n\n [3.0 C4 Model](#30-c4-model)\n\n [3.1 High Level View](#31-high-level-view)\n\n [3.2 Module Level View](#32-module-level-view)\n\n [3.3 API and Module Communication](#33-api-and-module-communication)\n\n [3.4 Module Requests Processing via CQRS](#34-module-requests-processing-via-cqrs)\n\n [3.5 Domain Model Principles and Attributes](#35-domain-model-principles-and-attributes)\n\n [3.6 Cross-Cutting Concerns](#36-cross-cutting-concerns)\n\n [3.7 Modules Integration](#37-modules-integration)\n\n [3.8 Internal Processing](#38-internal-processing)\n\n [3.9 Security](#39-security)\n\n [3.10 Unit Tests](#310-unit-tests)\n\n [3.11 Architecture Decision Log](#311-architecture-decision-log)\n\n [3.12 Architecture Unit Tests](#312-architecture-unit-tests)\n\n [3.13 Integration Tests](#313-integration-tests)\n\n [3.14 System Integration Testing](#314-system-integration-testing)\n\n [3.15 Event Sourcing](#315-event-sourcing)\n\n [3.16 Database change management](#316-database-change-management)\n\n [3.17 Continuous Integration](#317-continuous-integration)\n\n [3.18 Static code analysis](#318-static-code-analysis)\n\n [3.19 System Under Test SUT](#319-system-under-test-sut)\n\n [3.20 Mutation Testing](#320-mutation-testing)\n\n[4. Technology](#4-technology)\n\n[5. How to Run](#5-how-to-run)\n\n[6. Contribution](#6-contribution)\n\n[7. Roadmap](#7-roadmap)\n\n[8. Authors](#8-authors)\n\n[9. License](#9-license)\n\n[10. Inspirations and Recommendations](#10-inspirations-and-recommendations)\n\n## 1. Introduction\n\n### 1.1 Purpose of this Repository\n\nThis is a list of the main goals of this repository:\n\n- Showing how you can implement a **monolith** application in a **modular** way\n- Presentation of the **full implementation** of an application\n - This is not another simple application\n - This is not another proof of concept (PoC)\n - The goal is to present the implementation of an application that would be ready to run in production\n- Showing the application of **best practices** and **object-oriented programming principles**\n- Presentation of the use of **design patterns**. When, how and why they can be used\n- Presentation of some **architectural** considerations, decisions, approaches\n- Presentation of the implementation using **Domain-Driven Design** approach (**tactical** patterns)\n- Presentation of the implementation of **Unit Tests** for Domain Model (Testable Design in mind)\n- Presentation of the implementation of **Integration Tests**\n- Presentation of the implementation of **Event Sourcing**\n- Presentation of **C4 Model**\n- Presentation of **diagram as text** approach\n\n### 1.2 Out of Scope\n\nThis is a list of subjects which are out of scope for this repository:\n\n- Business requirements gathering and analysis\n- System analysis\n- Domain exploration\n- Domain distillation\n- Domain-Driven Design **strategic** patterns\n- Architecture evaluation, quality attributes analysis\n- Integration, system tests\n- Project management\n- Infrastructure\n- Containerization\n- Software engineering process\n- Deployment process\n- Maintenance\n- Documentation\n\n### 1.3 Reason\n\nThe reason for creating this repository is the lack of something similar. Most sample applications on GitHub have at least one of the following issues:\n\n- Very, very simple - few entities and use cases implemented\n- Not finished (for example there is no authentication, logging, etc..)\n- Poorly designed (in my opinion)\n- Poorly implemented (in my opinion)\n- Not well described\n- Assumptions and decisions are not clearly explained\n- Implements \"Orders\" domain - yes, everyone knows this domain, but something different is needed\n- Implemented in old technology\n- Not maintained\n\nTo sum up, there are some very good examples, but there are far too few of them. This repository has the task of filling this gap at some level.\n\n### 1.4 Disclaimer\n\nSoftware architecture should always be created to resolve specific **business problems**. Software architecture always supports some quality attributes and at the same time does not support others. A lot of other factors influence your software architecture - your team, opinions, preferences, experiences, technical constraints, time, budget, etc.\n\nAlways functional requirements, quality attributes, technical constraints and other factors should be considered before an architectural decision is made.\n\nBecause of the above, the architecture and implementation presented in this repository is **one of the many ways** to solve some problems. Take from this repository as much as you want, use it as you like but remember to **always pick the best solution which is appropriate to the problem class you have**.\n\n### 1.5 Give a Star\n\nMy primary focus in this project is on quality. Creating a good quality product involves a lot of analysis, research and work. It takes a lot of time. If you like this project, learned something or you are using it in your applications, please give it a star :star:. This is the best motivation for me to continue this work. Thanks!\n\n### 1.6 Share It\n\nThere are very few really good examples of this type of application. If you think this repository makes a difference and is worth it, please share it with your friends and on social networks. I will be extremely grateful.\n\n## 2. Domain\n\n### 2.1 Description\n\n**Definition:**\n\n> Domain - A sphere of knowledge, influence, or activity. The subject area to which the user applies a program is the domain of the software. [Domain-Driven Design Reference](http://domainlanguage.com/ddd/reference/), Eric Evans\n\nThe **Meeting Groups** domain was selected for the purposes of this project based on the [Meetup.com](https://www.meetup.com/) system.\n\n**Main reasons for selecting this domain:**\n\n- It is common, a lot of people use the Meetup site to organize or attend meetings\n- There is a system for it, so everyone can check this implementation against a working site which supports this domain\n- It is not complex so it is easy to understand\n- It is not trivial - there are some business rules and logic and it is not just CRUD operations\n- You don't need much specific domain knowledge unlike other domains like financing, banking, medical\n- It is not big so it is easier to implement\n\n**Meetings**\n\nThe main business entities are `Member`, `Meeting Group` and `Meeting`. A `Member` can create a `Meeting Group`, be part of a `Meeting Group` or can attend a `Meeting`.\n\nA `Meeting Group Member` can be an `Organizer` of this group or a normal `Member`.\n\nOnly an `Organizer` of a `Meeting Group` can create a new `Meeting`.\n\nA `Meeting` has attendees, not attendees (`Members` which declare they will not attend the `Meeting`) and `Members` on the `Waitlist`.\n\nA `Meeting` can have an attendee limit. If the limit is reached, `Members` can only sign up to the `Waitlist`.\n\nA `Meeting Attendee` can bring guests to the `Meeting`. The number of guests allowed is an attribute of the `Meeting`. Bringing guests can be unallowed.\n\nA `Meeting Attendee` can have one of two roles: `Attendee` or `Host`. A `Meeting` must have at least one `Host`. The `Host` is a special role which grants permission to edit `Meeting` information or change the attendees list.\n\nA `Member` can comment `Meetings`. A `Member` can reply to, like other `Comments`. `Organizer` manages commenting of `Meeting` by `Meeting Commenting Configuration`. `Organizer` can delete any `Comment`.\n\nEach `Meeting Group` must have an organizer with active `Subscription`. One organizer can cover 3 `Meeting Groups` by his `Subscription`.\n\nAdditionally, Meeting organizer can set an `Event Fee`. Each `Meeting Attendee` is obliged to pay the fee. All guests should be paid by `Meeting Attendee` too.\n\n**Administration**\n\nTo create a new `Meeting Group`, a `Member` needs to propose the group. A `Meeting Group Proposal` is sent to `Administrators`. An `Administrator` can accept or reject a `Meeting Group Proposal`. If a `Meeting Group Proposal` is accepted, a `Meeting Group` is created.\n\n**Payments**\n\nEach `Member` who is the `Payer` can buy the `Subscription`. He needs to pay the `Subscription Payment`. `Subscription` can expire so `Subscription Renewal` is required (by `Subscription Renewal Payment` payment to keep `Subscription` active).\n\nWhen the `Meeting` fee is required, the `Payer` needs to pay `Meeting Fee` (through `Meeting Fee Payment`).\n\n**Users**\n\nEach `Administrator`, `Member` and `Payer` is a `User`. To be a `User`, `User Registration` is required and confirmed.\n\nEach `User` is assigned one or more `User Role`.\n\nEach `User Role` has set of `Permissions`. A `Permission` defines whether `User` can invoke a particular action.\n\n### 2.2 Conceptual Model\n\n**Definition:**\n\n> Conceptual Model - A conceptual model is a representation of a system, made of the composition of concepts that are used to help people know, understand, or simulate a subject the model represents. [Wikipedia - Conceptual model](https://en.wikipedia.org/wiki/Conceptual_model)\n\n**Conceptual Model**\n\nPlantUML version:\n\n\nVisualParadigm version (not maintained, only for demonstration):\n\n\n**Conceptual Model of commenting feature**\n\n\n### 2.3 Event Storming\n\nWhile a Conceptual Model focuses on structures and relationships between them, **behavior** and **events** that occur in our domain are more important.\n\nThere are many ways to show behavior and events. One of them is a light technique called [Event Storming](https://www.eventstorming.com/) which is becoming more popular. Below are presented 3 main business processes using this technique: user registration, meeting group creation and meeting organization.\n\nNote: Event Storming is a light, live workshop. One of the possible outputs of this workshop is presented here. Even if you are not doing Event Storming workshops, this type of process presentation can be very valuable to you and your stakeholders.\n\n**User Registration process**\n\n------\n\n\n\n------\n\n**Meeting Group creation**\n\n\n------\n\n**Meeting organization**\n\n\n------\n\n**Payments**\n\n[Download high resolution file](docs/Images/Payments_EventStorming_Design_HighRes.jpg)\n\n------\n\n## 3. Architecture\n\n### 3.0 C4 Model\n\n[C4 model](https://c4model.com/) is a lean graphical notation technique for modelling the architecture of software systems.
\n\nAs can be found on the website of the author of this model ([Simon Brown](https://simonbrown.je/)): *The C4 model was created as a way to help software development teams describe and communicate software architecture, both during up-front design sessions and when retrospectively documenting an existing codebase*
\n\n*Model C4* defines 4 levels (views) of the system architecture: *System Context*, *Container*, *Component* and *Code*. Below are examples of each of these levels that describe the architecture of this system.
\n\n*Note: The [PlantUML](https://plantuml.com/) (diagram as text) component was used to describe all C4 model levels. Additionally, for levels C1-C3, a [C4-PlantUML](https://github.com/plantuml-stdlib/C4-PlantUML) plug-in connecting PlantUML with the C4 model was used*.\n\n#### 3.0.1 C1 System Context\n\n\n\n#### 3.0.2 C2 Container\n\n\n\n#### 3.0.3 C3 Component (high-level)\n\n\n\n#### 3.0.4 C3 Component (module-level)\n\n\n\n#### 3.0.5 C4 Code (meeting group aggregate)\n\n\n\n### 3.1 High Level View\n\n\n\n**Module descriptions:**\n\n- **API** - Very thin ASP.NET MVC Core REST API application. Main responsibilities are:\n 1. Accept request\n 2. Authenticate and authorize request (using User Access module)\n 3. Delegate work to specific module sending Command or Query\n 4. Return response\n- **User Access** - responsible for user authentication and authorization\n- **Registrations** - responsible for user registration\n- **Meetings** - implements Meetings Bounded Context: creating meeting groups, meetings\n- **Administration** - implements Administration Bounded Context: implements administrative tasks like meeting group proposal verification\n- **Payments** - implements Payments Bounded Context: implements all functionalities associated with payments\n- **In Memory Events Bus** - Publish/Subscribe implementation to asynchronously integrate all modules using events ([Event Driven Architecture](https://en.wikipedia.org/wiki/Event-driven_architecture)).\n\n**Key assumptions:**\n\n1. API contains no application logic\n2. API communicates with Modules using a small interface to send Queries and Commands\n3. Each Module has its own interface which is used by API\n4. **Modules communicate each other only asynchronously using Events Bus** - direct method calls are not allowed\n5. Each Module **has it's own data** in a separate schema - shared data is not allowed\n - Module data could be moved into separate databases if desired\n6. Modules can only have a dependency on the integration events assembly of other Module (see [Module level view](#32-module-level-view))\n7. Each Module has its own [Composition Root](https://freecontent.manning.com/dependency-injection-in-net-2nd-edition-understanding-the-composition-root/), which implies that each Module has its own Inversion-of-Control container\n8. API as a host needs to initialize each module and each module has an initialization method\n9. Each Module is **highly encapsulated** - only required types and members are public, the rest are internal or private\n\n### 3.2 Module Level View\n\n\n\nEach Module has [Clean Architecture](https://blog.cleancoder.com/uncle-bob/2012/08/13/the-clean-architecture.html) and consists of the following submodules (assemblies):\n\n- **Application** - the application logic submodule which is responsible for requests processing: use cases, domain events, integration events, internal commands.\n- **Domain** - Domain Model in Domain-Driven Design terms implements the applicable [Bounded Context](https://martinfowler.com/bliki/BoundedContext.html)\n- **Infrastructure** - infrastructural code responsible for module initialization, background processing, data access, communication with Events Bus and other external components or systems\n- **IntegrationEvents** - **Contracts** published to the Events Bus; only this assembly can be called by other modules\n\n\n\n**Note:** Application, Domain and Infrastructure assemblies could be merged into one assembly. Some people like horizontal layering or more decomposition, some don't. Implementing the Domain Model or Infrastructure in separate assembly allows encapsulation using the [`internal`](https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/keywords/internal) keyword. Sometimes Bounded Context logic is not worth it because it is too simple. As always, be pragmatic and take whatever approach you like.\n\n### 3.3 API and Module Communication\n\nThe API only communicates with Modules in two ways: during module initialization and request processing.\n\n**Module initialization**\n\nEach module has a static ``Initialize`` method which is invoked in the API ``Startup`` class. All configuration needed by this module should be provided as arguments to this method. All services are configured during initialization and the Composition Root is created using the Inversion-of-Control Container.\n\n```csharp\npublic static void Initialize(\n string connectionString,\n IExecutionContextAccessor executionContextAccessor,\n ILogger logger,\n EmailsConfiguration emailsConfiguration)\n{\n var moduleLogger = logger.ForContext(\"Module\", \"Meetings\");\n\n ConfigureCompositionRoot(connectionString, executionContextAccessor, moduleLogger, emailsConfiguration);\n\n QuartzStartup.Initialize(moduleLogger);\n\n EventsBusStartup.Initialize(moduleLogger);\n}\n```\n\n**Request processing**\n\nEach module has the same interface signature exposed to the API. It contains 3 methods: command with result, command without result and query.\n\n```csharp\npublic interface IMeetingsModule\n{\n Task ExecuteCommandAsync(ICommand command);\n\n Task ExecuteCommandAsync(ICommand command);\n\n Task ExecuteQueryAsync(IQuery query);\n}\n```\n\n**Note:** Some people say that processing a command should not return a result. This is an understandable approach but sometimes impractical, especially when you want to immediately return the ID of a newly created resource. Sometimes the boundary between Command and Query is blurry. One example is ``AuthenticateCommand`` - it returns a token but it is not a query because it has a side effect.\n\n### 3.4 Module Requests Processing via CQRS\n\nProcessing of Commands and Queries is separated by applying the architectural style/pattern [Command Query Responsibility Segregation (CQRS)](https://docs.microsoft.com/en-us/azure/architecture/patterns/cqrs).\n\n\n\nCommands are processed using *Write Model* which is implemented using DDD tactical patterns:\n\n```csharp\ninternal class CreateNewMeetingGroupCommandHandler : ICommandHandler\n{\n private readonly IMeetingGroupRepository _meetingGroupRepository;\n private readonly IMeetingGroupProposalRepository _meetingGroupProposalRepository;\n\n internal CreateNewMeetingGroupCommandHandler(\n IMeetingGroupRepository meetingGroupRepository,\n IMeetingGroupProposalRepository meetingGroupProposalRepository)\n {\n _meetingGroupRepository = meetingGroupRepository;\n _meetingGroupProposalRepository = meetingGroupProposalRepository;\n }\n\n public async Task Handle(CreateNewMeetingGroupCommand request, CancellationToken cancellationToken)\n {\n var meetingGroupProposal = await _meetingGroupProposalRepository.GetByIdAsync(request.MeetingGroupProposalId);\n\n var meetingGroup = meetingGroupProposal.CreateMeetingGroup();\n\n await _meetingGroupRepository.AddAsync(meetingGroup);\n\n \n }\n}\n```\n\nQueries are processed using *Read Model* which is implemented by executing raw SQL statements on database views:\n\n```csharp\ninternal class GetAllMeetingGroupsQueryHandler : IQueryHandler>\n{\n private readonly ISqlConnectionFactory _sqlConnectionFactory;\n\n internal GetAllMeetingGroupsQueryHandler(ISqlConnectionFactory sqlConnectionFactory)\n {\n _sqlConnectionFactory = sqlConnectionFactory;\n }\n\n public async Task> Handle(GetAllMeetingGroupsQuery request, CancellationToken cancellationToken)\n {\n var connection = _sqlConnectionFactory.GetOpenConnection();\n\n const string sql = $\"\"\"\n SELECT \n [MeetingGroup].[Id] as [{nameof(MeetingGroupDto.Id)}] , \n [MeetingGroup].[Name] as [{nameof(MeetingGroupDto.Name)}], \n [MeetingGroup].[Description] as [{nameof(MeetingGroupDto.Description)}] \n [MeetingGroup].[LocationCountryCode] as [{nameof(MeetingGroupDto.LocationCountryCode)}],\n [MeetingGroup].[LocationCity] as [{nameof(MeetingGroupDto.LocationCity)}]\n FROM [meetings].[v_MeetingGroups] AS [MeetingGroup]\n \"\"\";\n var meetingGroups = await connection.QueryAsync(sql);\n\n return meetingGroups.AsList();\n }\n}\n```\n\n**Key advantages:**\n\n- Solution is appropriate to the problem - reading and writing needs are usually different\n- Supports [Single Responsibility Principle](https://en.wikipedia.org/wiki/Single_responsibility_principle) (SRP) - one handler does one thing\n- Supports [Interface Segregation Principle](https://en.wikipedia.org/wiki/Interface_segregation_principle) (ISP) - each handler implements interface with exactly one method\n- Supports [Parameter Object pattern](https://refactoring.com/catalog/introduceParameterObject.html) - Commands and Queries are objects which are easy to serialize/deserialize\n- Easy way to apply [Decorator pattern](https://en.wikipedia.org/wiki/Decorator_pattern) to handle cross-cutting concerns\n- Supports Loose Coupling by use of the [Mediator pattern](https://en.wikipedia.org/wiki/Mediator_pattern) - separates invoker of request from handler of request\n\n**Disadvantage:**\n\n- Mediator pattern introduces extra indirection and is harder to reason about which class handles the request\n\nFor more information: [Simple CQRS implementation with raw SQL and DDD](https://www.kamilgrzybek.com/design/simple-cqrs-implementation-with-raw-sql-and-ddd/)\n\n### 3.5 Domain Model Principles and Attributes\n\nThe Domain Model, which is the central and most critical part in the system, should be designed with special attention. Here are some key principles and attributes which are applied to Domain Models of each module:\n\n1. **High level of encapsulation**\n\n All members are ``private`` by default, then ``internal`` - only ``public`` at the very edge.\n\n2. **High level of PI (Persistence Ignorance)**\n\n No dependencies to infrastructure, databases, etc. All classes are [POCOs](https://en.wikipedia.org/wiki/Plain_old_CLR_object).\n\n3. **Rich in behavior**\n\n All business logic is located in the Domain Model. No leaks to the application layer or elsewhere.\n\n4. **Low level of Primitive Obsession**\n\n Primitive attributes of Entites grouped together using ValueObjects.\n\n5. **Business language**\n\n All classes, methods and other members are named in business language used in this Bounded Context.\n\n6. **Testable**\n\n The Domain Model is a critical part of the system so it should be easy to test (Testable Design).\n\n```csharp\npublic class MeetingGroup : Entity, IAggregateRoot\n{\n public MeetingGroupId Id { get; private set; }\n\n private string _name;\n\n private string _description;\n\n private MeetingGroupLocation _location;\n\n private MemberId _creatorId;\n\n private List _members;\n\n private DateTime _createDate;\n\n private DateTime? _paymentDateTo;\n\n internal static MeetingGroup CreateBasedOnProposal(\n MeetingGroupProposalId meetingGroupProposalId,\n string name,\n string description,\n MeetingGroupLocation location, MemberId creatorId)\n {\n return new MeetingGroup(meetingGroupProposalId, name, description, location, creatorId);\n }\n\n public Meeting CreateMeeting(\n string title,\n MeetingTerm term,\n string description,\n MeetingLocation location,\n int? attendeesLimit,\n int guestsLimit,\n Term rsvpTerm,\n MoneyValue eventFee,\n List hostsMembersIds,\n MemberId creatorId)\n {\n this.CheckRule(new MeetingCanBeOrganizedOnlyByPayedGroupRule(_paymentDateTo));\n\n this.CheckRule(new MeetingHostMustBeAMeetingGroupMemberRule(creatorId, hostsMembersIds, _members));\n\n return new Meeting(this.Id,\n title,\n term,\n description,\n location,\n attendeesLimit,\n guestsLimit,\n rsvpTerm,\n eventFee,\n hostsMembersIds,\n creatorId);\n }\n```\n\n### 3.6 Cross-Cutting Concerns\n\nTo support [Single Responsibility Principle](https://en.wikipedia.org/wiki/Single_responsibility_principle) and [Don't Repeat Yourself](https://en.wikipedia.org/wiki/Don%27t_repeat_yourself) principles, the implementation of cross-cutting concerns is done using the [Decorator Pattern](https://en.wikipedia.org/wiki/Decorator_pattern). Each Command processor is decorated by 3 decorators: logging, validation and unit of work.\n\n\n\n**Logging**\n\nThe Logging decorator logs execution, arguments and processing of each Command. This way each log inside a processor has the log context of the processing command.\n\n```csharp\ninternal class LoggingCommandHandlerDecorator : ICommandHandler where T:ICommand\n{\n private readonly ILogger _logger;\n private readonly IExecutionContextAccessor _executionContextAccessor;\n private readonly ICommandHandler _decorated;\n\n public LoggingCommandHandlerDecorator(\n ILogger logger,\n IExecutionContextAccessor executionContextAccessor,\n ICommandHandler decorated)\n {\n _logger = logger;\n _executionContextAccessor = executionContextAccessor;\n _decorated = decorated;\n }\n public async Task Handle(T command, CancellationToken cancellationToken)\n {\n if (command is IRecurringCommand)\n {\n return await _decorated.Handle(command, cancellationToken);\n }\n using (\n LogContext.Push(\n new RequestLogEnricher(_executionContextAccessor),\n new CommandLogEnricher(command)))\n {\n try\n {\n this._logger.Information(\n \"Executing command {Command}\",\n command.GetType().Name);\n\n var result = await _decorated.Handle(command, cancellationToken);\n\n this._logger.Information(\"Command {Command} processed successful\", command.GetType().Name);\n\n return result;\n }\n catch (Exception exception)\n {\n this._logger.Error(exception, \"Command {Command} processing failed\", command.GetType().Name);\n throw;\n }\n }\n }\n\n private class CommandLogEnricher : ILogEventEnricher\n {\n private readonly ICommand _command;\n\n public CommandLogEnricher(ICommand command)\n {\n _command = command;\n }\n public void Enrich(LogEvent logEvent, ILogEventPropertyFactory propertyFactory)\n {\n logEvent.AddOrUpdateProperty(new LogEventProperty(\"Context\", new ScalarValue($\"Command:{_command.Id.ToString()}\")));\n }\n }\n\n private class RequestLogEnricher : ILogEventEnricher\n {\n private readonly IExecutionContextAccessor _executionContextAccessor;\n public RequestLogEnricher(IExecutionContextAccessor executionContextAccessor)\n {\n _executionContextAccessor = executionContextAccessor;\n }\n public void Enrich(LogEvent logEvent, ILogEventPropertyFactory propertyFactory)\n {\n if (_executionContextAccessor.IsAvailable)\n {\n logEvent.AddOrUpdateProperty(new LogEventProperty(\"CorrelationId\", new ScalarValue(_executionContextAccessor.CorrelationId)));\n }\n }\n }\n}\n```\n\n**Validation**\n\nThe Validation decorator performs Command data validation. It checks rules against Command arguments using the FluentValidation library.\n\n```csharp\ninternal class ValidationCommandHandlerDecorator : ICommandHandler where T:ICommand\n{\n private readonly IList> _validators;\n private readonly ICommandHandler _decorated;\n\n public ValidationCommandHandlerDecorator(\n IList> validators,\n ICommandHandler decorated)\n {\n this._validators = validators;\n _decorated = decorated;\n }\n\n public Task Handle(T command, CancellationToken cancellationToken)\n {\n var errors = _validators\n .Select(v => v.Validate(command))\n .SelectMany(result => result.Errors)\n .Where(error => error != null)\n .ToList();\n\n if (errors.Any())\n {\n var errorBuilder = new StringBuilder();\n\n errorBuilder.AppendLine(\"Invalid command, reason: \");\n\n foreach (var error in errors)\n {\n errorBuilder.AppendLine(error.ErrorMessage);\n }\n\n throw new InvalidCommandException(errorBuilder.ToString(), null);\n }\n\n return _decorated.Handle(command, cancellationToken);\n }\n}\n```\n\n**Unit Of Work**\n\nAll Command processing has side effects. To avoid calling commit on every handler, `UnitOfWorkCommandHandlerDecorator` is used. It additionally marks `InternalCommand` as processed (if it is Internal Command) and dispatches all Domain Events (as part of [Unit Of Work](https://martinfowler.com/eaaCatalog/unitOfWork.html)).\n\n```csharp\npublic class UnitOfWorkCommandHandlerDecorator : ICommandHandler where T:ICommand\n{\n private readonly ICommandHandler _decorated;\n private readonly IUnitOfWork _unitOfWork;\n private readonly MeetingsContext _meetingContext;\n\n public UnitOfWorkCommandHandlerDecorator(\n ICommandHandler decorated,\n IUnitOfWork unitOfWork,\n MeetingsContext meetingContext)\n {\n _decorated = decorated;\n _unitOfWork = unitOfWork;\n _meetingContext = meetingContext;\n }\n\n public async Task Handle(T command, CancellationToken cancellationToken)\n {\n await this._decorated.Handle(command, cancellationToken);\n\n if (command is InternalCommandBase)\n {\n var internalCommand =\n await _meetingContext.InternalCommands.FirstOrDefaultAsync(x => x.Id == command.Id,\n cancellationToken: cancellationToken);\n\n if (internalCommand != null)\n {\n internalCommand.ProcessedDate = DateTime.UtcNow;\n }\n }\n\n await this._unitOfWork.CommitAsync(cancellationToken);\n\n \n }\n}\n```\n\n### 3.7 Modules Integration\n\nIntegration between modules is strictly **asynchronous** using Integration Events and the In Memory Event Bus as broker. In this way coupling between modules is minimal and exists only on the structure of Integration Events.\n\n**Modules don't share data** so it is not possible nor desirable to create a transaction which spans more than one module. To ensure maximum reliability, the [Outbox / Inbox pattern](http://www.kamilgrzybek.com/design/the-outbox-pattern/) is used. This pattern provides accordingly *\"At-Least-Once delivery\"* and *\"At-Least-Once processing\"*.\n\n\n\nThe Outbox and Inbox is implemented using two SQL tables and a background worker for each module. The background worker is implemented using the Quartz.NET library.\n\n**Saving to Outbox:**\n\n\n\n**Processing Outbox:**\n\n\n\n### 3.8 Internal Processing\n\nThe main principle of this system is that you can change its state only by calling a specific Command.\n\nCommands can be called not only by the API, but by the processing module itself. The main use case which implements this mechanism is data processing in eventual consistency mode when we want to process something in a different process and transaction. This applies, for example, to Inbox processing because we want to do something (calling a Command) based on an Integration Event from the Inbox.\n\nThis idea is taken from Alberto's Brandolini's Event Storming picture called \"The picture that explains “almost” everything\" which shows that every side effect (domain event) is created by invoking a Command on Aggregate. See [EventStorming cheat sheet](https://xebia.com/blog/eventstorming-cheat-sheet/) article for more details.\n\nImplementation of internal processing is very similar to implementation of the Outbox and Inbox. One SQL table and one background worker for processing. Each internally processing Command must inherit from `InternalCommandBase` class:\n\n```csharp\ninternal abstract class InternalCommandBase : ICommand\n{\n public Guid Id { get; }\n\n protected InternalCommandBase(Guid id)\n {\n this.Id = id;\n }\n}\n```\n\nThis is important because the `UnitOfWorkCommandHandlerDecorator` must mark an internal Command as processed during committing:\n\n```csharp\npublic async Task Handle(T command, CancellationToken cancellationToken)\n{\n await this._decorated.Handle(command, cancellationToken);\n\n if (command is InternalCommandBase)\n {\n var internalCommand =\n await _meetingContext.InternalCommands.FirstOrDefaultAsync(x => x.Id == command.Id,\n cancellationToken: cancellationToken);\n\n if (internalCommand != null)\n {\n internalCommand.ProcessedDate = DateTime.UtcNow;\n }\n }\n\n await this._unitOfWork.CommitAsync(cancellationToken);\n\n \n}\n```\n\n### 3.9 Security\n\n**Authentication**\n\nAuthentication is implemented using JWT Token and Bearer scheme using IdentityServer. For now, only one authentication method is implemented: forms style authentication (username and password) via the OAuth2 [Resource Owner Password Grant Type](https://www.oauth.com/oauth2-servers/access-tokens/password-grant/). It requires implementation of the `IResourceOwnerPasswordValidator` interface:\n\n```csharp\npublic class ResourceOwnerPasswordValidator : IResourceOwnerPasswordValidator\n{\n private readonly IUserAccessModule _userAccessModule;\n\n public ResourceOwnerPasswordValidator(IUserAccessModule userAccessModule)\n {\n _userAccessModule = userAccessModule;\n }\n\n public async Task ValidateAsync(ResourceOwnerPasswordValidationContext context)\n {\n var authenticationResult = await _userAccessModule.ExecuteCommandAsync(new AuthenticateCommand(context.UserName, context.Password));\n if (!authenticationResult.IsAuthenticated)\n {\n context.Result = new GrantValidationResult(\n TokenRequestErrors.InvalidGrant,\n authenticationResult.AuthenticationError);\n return;\n }\n context.Result = new GrantValidationResult(\n authenticationResult.User.Id.ToString(),\n \"forms\",\n authenticationResult.User.Claims);\n }\n}\n```\n\n**Authorization**\n\nAuthorization is achieved by implementing [RBAC (Role Based Access Control)](https://en.wikipedia.org/wiki/Role-based_access_control) using Permissions. Permissions are more granular and a much better way to secure your application than Roles alone. Each User has a set of Roles and each Role contains one or more Permission. The User's set of Permissions is extracted from all Roles the User belongs to. Permissions are always checked on `Controller` level - never Roles:\n\n```csharp\n[HttpPost]\n[Route(\"\")]\n[HasPermission(MeetingsPermissions.ProposeMeetingGroup)]\npublic async Task ProposeMeetingGroup(ProposeMeetingGroupRequest request)\n{\n await _meetingsModule.ExecuteCommandAsync(\n new ProposeMeetingGroupCommand(\n request.Name,\n request.Description,\n request.LocationCity,\n request.LocationCountryCode));\n\n return Ok();\n}\n```\n\n### 3.10 Unit Tests\n\n**Definition:**\n\n>A unit test is an automated piece of code that invokes the unit of work being tested, and then checks some assumptions about a single end result of that unit. A unit test is almost always written using a unit testing framework. It can be written easily and runs quickly. It’s trustworthy, readable, and maintainable. It’s consistent in its results as long as production code hasn’t changed. [Art of Unit Testing 2nd Edition](https://www.manning.com/books/the-art-of-unit-testing-second-edition) Roy Osherove\n\n**Attributes of good unit test**\n\n- Automated\n- Maintainable\n- Runs very fast (in ms)\n- Consistent, Deterministic (always the same result)\n- Isolated from other tests\n- Readable\n- Can be executed by anyone\n- Testing public API, not internal behavior (overspecification)\n- Looks like production code\n- Treated as production code\n\n**Implementation**\n\nUnit tests should mainly test business logic (domain model): \n\n\nEach unit test has 3 standard sections: Arrange, Act and Assert:\n\n\n\n**1\\. Arrange**\n\nThe Arrange section is responsible for preparing the Aggregate for testing the public method that we want to test. This public method is often called (from the unit tests perspective) the SUT (system under test).\n\nCreating an Aggregate ready for testing involves **calling one or more other public constructors/methods** on the Domain Model. At first it may seem that we are testing too many things at the same time, but this is not true. We need to be one hundred percent sure that the Aggregate is in a state exactly as it will be in production. This can only be ensured when we:\n\n- **Use only public API of Domain Model**\n- Don't use [InternalsVisibleToAttribute](https://docs.microsoft.com/en-us/dotnet/api/system.runtime.compilerservices.internalsvisibletoattribute?view=netframework-4.8) class\n - This exposes the Domain Model to the Unit Tests library, removing encapsulation so our tests and production code are treated differently and it is a very bad thing\n- Don't use [ConditionalAttribute](https://docs.microsoft.com/en-us/dotnet/api/system.diagnostics.conditionalattribute?view=netframework-4.8) classes - it reduces readability and increases complexity\n- Don't create any special constructors/factory methods for tests (even with conditional compilation symbols)\n - Special constructor/factory method only for unit tests causes duplication of business logic in the test itself and focuses on state - this kind of approach causes the test to be very sensitive to changes and hard to maintain\n- Don't remove encapsulation from Domain Model (for example: change keywords from `internal`/`private` to `public`)\n- Don't make methods `protected` to inherit from tested class and in this way provide access to internal methods/properties\n\n**Isolation of external dependencies**\n\nThere are 2 main concepts - stubs and mocks:\n\n> A stub is a controllable replacement for an existing dependency (or collaborator) in the system. By using a stub, you can test your code without dealing with the dependency directly.\n\n>A mock object is a fake object in the system that decides whether the unit test has passed or failed. It does so by verifying whether the object under test called the fake object as expected. There’s usually no more than one mock per test.\n>[Art of Unit Testing 2nd Edition](https://www.manning.com/books/the-art-of-unit-testing-second-edition) Roy Osherove\n\nGood advice: use stubs if you need to, but try to avoid mocks. Mocking causes us to test too many internal things and leads to overspecification.\n\n**2\\. Act**\n\nThis section is very easy - we execute **exactly one** public method on aggregate (SUT).\n\n**3\\. Assert**\n\nIn this section we check expectations. There are only 2 possible outcomes:\n\n- Method completed and Domain Event(s) published\n- Business rule was broken\n\nSimple example:\n\n```csharp\n[Test]\npublic void NewUserRegistration_WithUniqueLogin_IsSuccessful()\n{\n // Arrange\n var usersCounter = Substitute.For();\n\n // Act\n var userRegistration =\n UserRegistration.RegisterNewUser(\n \"login\", \"password\", \"test@email\",\n \"firstName\", \"lastName\", usersCounter);\n\n // Assert\n var newUserRegisteredDomainEvent = AssertPublishedDomainEvent(userRegistration);\n Assert.That(newUserRegisteredDomainEvent.UserRegistrationId, Is.EqualTo(userRegistration.Id));\n}\n\n[Test]\npublic void NewUserRegistration_WithoutUniqueLogin_BreaksUserLoginMustBeUniqueRule()\n{\n // Arrange\n var usersCounter = Substitute.For();\n usersCounter.CountUsersWithLogin(\"login\").Returns(x => 1);\n\n // Assert\n AssertBrokenRule(() =>\n {\n // Act\n UserRegistration.RegisterNewUser(\n \"login\", \"password\", \"test@email\",\n \"firstName\", \"lastName\", usersCounter);\n });\n}\n```\n\nAdvanced example:\n\n```csharp\n[Test]\npublic void AddAttendee_WhenMemberIsAlreadyAttendeeOfMeeting_IsNotPossible()\n{\n // Arrange\n var creatorId = new MemberId(Guid.NewGuid());\n var meetingTestData = CreateMeetingTestData(new MeetingTestDataOptions\n {\n CreatorId = creatorId\n });\n var newMemberId = new MemberId(Guid.NewGuid());\n meetingTestData.MeetingGroup.JoinToGroupMember(newMemberId);\n meetingTestData.Meeting.AddAttendee(meetingTestData.MeetingGroup, newMemberId, 0);\n\n // Assert\n AssertBrokenRule(() =>\n {\n // Act\n meetingTestData.Meeting.AddAttendee(meetingTestData.MeetingGroup, newMemberId, 0);\n });\n}\n```\n\n`CreateMeetingTestData` method is an implementation of [SUT Factory](https://blog.ploeh.dk/2009/02/13/SUTFactory/) described by Mark Seemann which allows keeping common creation logic in one place:\n\n```csharp\nprotected MeetingTestData CreateMeetingTestData(MeetingTestDataOptions options)\n{\n var proposalMemberId = options.CreatorId ?? new MemberId(Guid.NewGuid());\n var meetingProposal = MeetingGroupProposal.ProposeNew(\n \"name\", \"description\",\n new MeetingGroupLocation(\"Warsaw\", \"PL\"), proposalMemberId);\n\n meetingProposal.Accept();\n\n var meetingGroup = meetingProposal.CreateMeetingGroup();\n\n meetingGroup.UpdatePaymentInfo(DateTime.Now.AddDays(1));\n\n var meetingTerm = options.MeetingTerm ??\n new MeetingTerm(DateTime.UtcNow.AddDays(1), DateTime.UtcNow.AddDays(2));\n\n var rsvpTerm = options.RvspTerm ?? Term.NoTerm;\n var meeting = meetingGroup.CreateMeeting(\"title\",\n meetingTerm,\n \"description\",\n new MeetingLocation(\"Name\", \"Address\", \"PostalCode\", \"City\"),\n options.AttendeesLimit,\n options.GuestsLimit,\n rsvpTerm,\n MoneyValue.Zero,\n new List(),\n proposalMemberId);\n\n DomainEventsTestHelper.ClearAllDomainEvents(meetingGroup);\n\n return new MeetingTestData(meetingGroup, meeting);\n}\n```\n\n### 3.11 Architecture Decision Log\n\nAll Architectural Decisions (AD) are documented in the [Architecture Decision Log (ADL)](docs/architecture-decision-log).\n\nMore information about documenting architecture-related decisions in this way : [https://github.com/joelparkerhenderson/architecture_decision_record](https://github.com/joelparkerhenderson/architecture_decision_record)\n\n### 3.12 Architecture Unit Tests\n\nIn some cases it is not possible to enforce the application architecture, design or established conventions using compiler (compile-time). For this reason, code implementations can diverge from the original design and architecture. We want to minimize this behavior, not only by code review.\n\nTo do this, unit tests of system architecture, design, major conventions and assumptions have been written. In .NET there is special library for this task: [NetArchTest](https://github.com/BenMorris/NetArchTest). This library has been written based on the very popular JAVA architecture unit tests library - [ArchUnit](https://www.archunit.org/).\n\nUsing this kind of tests we can test proper layering of our application, dependencies, encapsulation, immutability, DDD correct implementation, naming, conventions and so on - everything what we need to test. Example:\n\n\n\nMore information about architecture unit tests here: [https://blogs.oracle.com/javamagazine/unit-test-your-architecture-with-archunit](https://blogs.oracle.com/javamagazine/unit-test-your-architecture-with-archunit)\n\n### 3.13 Integration Tests\n\n#### Definition\n\n\"Integration Test\" term is blurred. It can mean test between classes, modules, services, even systems - see [this](https://martinfowler.com/bliki/IntegrationTest.html) article (by Martin Fowler). \n\nFor this reason, the definition of integration test in this project is as follows:\n\n- it verifies how system works in integration with \"out-of-process\" dependencies - database, messaging system, file system or external API\n- it tests particular use case\n- it can be slow (as opposed to Unit Test)\n\n#### Approach\n\n- **Do not mock dependencies over which you have full control** (like database). Full control dependency means you can always revert all changes (remove side-effects) and no one can notice it. They are not visible to others. See next point, please.\n- **Use \"production\", normal, real database version**. Some use e.g. in memory repository, some use light databases instead \"production\" version. This is still mocking. Testing makes sense if we have full confidence in testing. You can't trust the test if you know that the infrastructure in the production environment will vary. Be always as close to production environment as possible.\n- **Mock dependencies over which you don't have control**. No control dependency means you can't remove side-effects after interaction with this dependency (external API, messaging system, SMTP server etc.). They can be visible to others.\n\n#### Implementation\n\nIntegration test should test exactly one use case. One use case is represented by one Command/Query processing so CommandHandler/QueryHandler in Application layer is perfect starting point for running the Integration Test:\n\n\nFor each test, the following preparation steps must be performed:\n\n1. Clear database\n2. Prepare mocks\n3. Initialize testing module\n\n```csharp\n[SetUp]\npublic async Task BeforeEachTest()\n{\n const string connectionStringEnvironmentVariable =\n \"ASPNETCORE_MyMeetings_IntegrationTests_ConnectionString\";\n ConnectionString = Environment.GetEnvironmentVariable(connectionStringEnvironmentVariable, EnvironmentVariableTarget.Machine);\n if (ConnectionString == null)\n {\n throw new ApplicationException(\n $\"Define connection string to integration tests database using environment variable: {connectionStringEnvironmentVariable}\");\n }\n\n using (var sqlConnection = new SqlConnection(ConnectionString))\n {\n await ClearDatabase(sqlConnection);\n }\n\n Logger = Substitute.For();\n EmailSender = Substitute.For();\n EventsBus = new EventsBusMock();\n ExecutionContext = new ExecutionContextMock(Guid.NewGuid());\n \n PaymentsStartup.Initialize(\n ConnectionString,\n ExecutionContext,\n Logger,\n EventsBus,\n false);\n\n PaymentsModule = new PaymentsModule();\n}\n```\n\nAfter preparation, test is performed on clear database. Usually, it is the execution of some (or many) Commands and: \na) running a Query or/and \nb) verifying mocks \nto check the result.\n\n```csharp\n[TestFixture]\npublic class MeetingPaymentTests : TestBase\n{\n [Test]\n public async Task CreateMeetingPayment_Test()\n {\n PayerId payerId = new PayerId(Guid.NewGuid());\n MeetingId meetingId = new MeetingId(Guid.NewGuid());\n decimal value = 100;\n string currency = \"EUR\";\n await PaymentsModule.ExecuteCommandAsync(new CreateMeetingPaymentCommand(Guid.NewGuid(),\n payerId, meetingId, value, currency));\n\n var payment = await PaymentsModule.ExecuteQueryAsync(new GetMeetingPaymentQuery(meetingId.Value, payerId.Value));\n\n Assert.That(payment.PayerId, Is.EqualTo(payerId.Value));\n Assert.That(payment.MeetingId, Is.EqualTo(meetingId.Value));\n Assert.That(payment.FeeValue, Is.EqualTo(value));\n Assert.That(payment.FeeCurrency, Is.EqualTo(currency));\n }\n}\n```\n\nEach Command/Query processing is a separate execution (with different object graph resolution, context, database connection etc.) thanks to Composition Root of each module. This behavior is important and desirable.\n\n### 3.14 System Integration Testing\n\n#### Definition\n\n[System Integration Testing (SIT)](https://en.wikipedia.org/wiki/System_integration_testing) is performed to verify the interactions between the modules of a software system. It involves the overall testing of a complete system of many subsystem components or elements.\n\n#### Implementation\n\nImplementation of system integration tests is based on approach of integration testing of modules in isolation (invoking commands and queries) described in the previous section.\n\nThe problem is that in this case we are dealing with **asynchronous communication**. Due to asynchrony, our **test must wait for the result** at certain times.\n\nTo correctly implement such tests, the **Sampling** technique and implementation described in the [Growing Object-Oriented Software, Guided by Tests](https://www.amazon.com/Growing-Object-Oriented-Software-Guided-Tests/dp/0321503627) book was used:\n\n>An asynchronous test must wait for success and use timeouts to detect failure. This implies that every tested activity must have an observable effect: a test must affect the system so that its observable state becomes different. This sounds obvious but it drives how we think about writing asynchronous tests. If an activity has no observable effect, there is nothing the test can wait for, and therefore no way for the test to synchronize with the system it is testing. There are two ways a test can observe the system: by sampling its observable state or by listening for events that it sends out.\n\n\n\nTest below:\n\n1. Creates Meeting Group Proposal in Meetings module\n2. Waits until Meeting Group Proposal to verification will be available in Administration module with 10 seconds timeout\n3. Accepts Meeting Group Proposal in Administration module\n4. Waits until Meeting Group is created in Meetings module with 15 seconds timeout\n\n```csharp\npublic class CreateMeetingGroupTests : TestBase\n{\n [Test]\n public async Task CreateMeetingGroupScenario_WhenProposalIsAccepted()\n {\n var meetingGroupId = await MeetingsModule.ExecuteCommandAsync(\n new ProposeMeetingGroupCommand(\"Name\",\n \"Description\",\n \"Location\",\n \"PL\"));\n\n AssertEventually(\n new GetMeetingGroupProposalFromAdministrationProbe(meetingGroupId, AdministrationModule), \n 10000);\n\n await AdministrationModule.ExecuteCommandAsync(new AcceptMeetingGroupProposalCommand(meetingGroupId));\n\n AssertEventually(\n new GetCreatedMeetingGroupFromMeetingsProbe(meetingGroupId, MeetingsModule),\n 15000);\n }\n\n private class GetCreatedMeetingGroupFromMeetingsProbe : IProbe\n {\n private readonly Guid _expectedMeetingGroupId;\n\n private readonly IMeetingsModule _meetingsModule;\n\n private List _allMeetingGroups;\n\n public GetCreatedMeetingGroupFromMeetingsProbe(\n Guid expectedMeetingGroupId, \n IMeetingsModule meetingsModule)\n {\n _expectedMeetingGroupId = expectedMeetingGroupId;\n _meetingsModule = meetingsModule;\n }\n\n public bool IsSatisfied()\n {\n return _allMeetingGroups != null && \n _allMeetingGroups.Any(x => x.Id == _expectedMeetingGroupId);\n }\n\n public async Task SampleAsync()\n {\n _allMeetingGroups = await _meetingsModule.ExecuteQueryAsync(new GetAllMeetingGroupsQuery());\n }\n\n public string DescribeFailureTo() \n => $\"Meeting group with ID: {_expectedMeetingGroupId} is not created\";\n }\n\n private class GetMeetingGroupProposalFromAdministrationProbe : IProbe\n {\n private readonly Guid _expectedMeetingGroupProposalId;\n\n private MeetingGroupProposalDto _meetingGroupProposal;\n\n private readonly IAdministrationModule _administrationModule;\n\n public GetMeetingGroupProposalFromAdministrationProbe(Guid expectedMeetingGroupProposalId, IAdministrationModule administrationModule)\n {\n _expectedMeetingGroupProposalId = expectedMeetingGroupProposalId;\n _administrationModule = administrationModule;\n }\n\n public bool IsSatisfied()\n {\n if (_meetingGroupProposal == null)\n {\n return false;\n }\n\n if (_meetingGroupProposal.Id == _expectedMeetingGroupProposalId &&\n _meetingGroupProposal.StatusCode == MeetingGroupProposalStatus.ToVerify.Value)\n {\n return true;\n }\n\n return false;\n }\n\n public async Task SampleAsync()\n {\n try\n {\n _meetingGroupProposal =\n await _administrationModule.ExecuteQueryAsync(\n new GetMeetingGroupProposalQuery(_expectedMeetingGroupProposalId));\n }\n catch\n {\n // ignored\n }\n }\n\n public string DescribeFailureTo()\n => $\"Meeting group proposal with ID: {_expectedMeetingGroupProposalId} to verification not created\";\n }\n}\n```\n\nPoller class implementation (based on example in the book):\n\n```csharp\npublic class Poller\n{\n private readonly int _timeoutMillis;\n\n private readonly int _pollDelayMillis;\n\n public Poller(int timeoutMillis)\n {\n _timeoutMillis = timeoutMillis;\n _pollDelayMillis = 1000;\n }\n\n public void Check(IProbe probe)\n {\n var timeout = new Timeout(_timeoutMillis);\n while (!probe.IsSatisfied())\n {\n if (timeout.HasTimedOut())\n {\n throw new AssertErrorException(DescribeFailureOf(probe));\n }\n\n Thread.Sleep(_pollDelayMillis);\n probe.SampleAsync();\n }\n }\n\n private static string DescribeFailureOf(IProbe probe)\n {\n return probe.DescribeFailureTo();\n }\n}\n```\n\n### 3.15 Event Sourcing\n\n#### Theory\n\nDuring the implementation of the Payment module, *Event Sourcing* was used. *Event Sourcing* is a way of preserving the state of our system by recording a sequence of events. No less, no more.\n\nIt is important here to really restore the state of our application from events. If we collect events only for auditing purposes, it is an [Audit Log/Trail](https://en.wikipedia.org/wiki/Audit_trail) - not the *Event Sourcing*.\n\nThe main elements of *Event Sourcing* are as follows:\n\n- Events Stream\n- Objects that are restored based on events. There are 2 types of such objects depending on the purpose:\n-- Objects responsible for the change of state. In Domain-Driven Design they will be *Aggregates*.\n-- *Projections*: read models prepared for a specific purpose\n- *Subscriptions* : a way to receive information about new events\n- *Snapshots*: from time to time, objects saved in the traditional way for performance purposes. Mainly used if there are many events to restore the object from the entire event history. (Note: there is currently no snapshot implementation in the project)\n\n\n\n#### Tool\n\nIn order not to reinvent the wheel, the *SQL Stream Store* library was used. As the [documentation](https://sqlstreamstore.readthedocs.io/en/latest/) says:\n\n*SQL Stream Store is a .NET library to assist with developing applications that use event sourcing or wish to use stream based patterns over a relational database and existing operational infrastructure.*\n\nLike every library, it has its limitations and assumptions (I recommend the linked documentation chapter \"Things you need to know before adopting\"). For me, the most important 2 points from this chapter are:\n\n1. *\"Subscriptions (and thus projections) are **eventually consistent** and always will be.\"* This means that there will always be an inconsistency time from saving the event to the stream and processing the event by the projector(s).\n2. *\"No support for ambient System.Transaction scopes enforcing the concept of the stream as the consistency and transactional boundary.\"* This means that if we save the event to a events stream and want to save something **in the same transaction**, we must use [TransactionScope](https://learn.microsoft.com/en-us/dotnet/api/system.transactions.transactionscope?view=net-8.0). If we cannot use *TransactionScope* for some reason, we must accept the Eventual Consistency also in this case.\n\nOther popular tools:\n\n- [EventStore](https://eventstore.com/) *\"An industrial-strength database solution built from the ground up for event sourcing.\"*\n- [Marten](https://martendb.io/) *\".NET Transactional Document DB and Event Store on PostgreSQL\"*\n\n#### Implementation\n\nThere are 2 main \"flows\" to handle:\n\n- Command handling: change of state - adding new events to stream (writing)\n- Projection of events to create read models\n\n##### Command Handling\n\nThe whole process looks like this:\n\n\n\n1. We create / update an aggregate by creating an event\n2. We add changes to the Aggregate Store. This is the class responsible for writing / loading our aggregates. We are not saving changes yet.\n3. As part of Unit Of Work a) Aggregate Store adds events to the stream b) messages are added to the Outbox\n\nCommand Handler:\n\n```csharp\npublic class BuySubscriptionCommandHandler : ICommandHandler\n{\n private readonly IAggregateStore _aggregateStore;\n\n private readonly IPayerContext _payerContext;\n\n private readonly ISqlConnectionFactory _sqlConnectionFactory;\n\n public BuySubscriptionCommandHandler(\n IAggregateStore aggregateStore, \n IPayerContext payerContext, \n ISqlConnectionFactory sqlConnectionFactory)\n {\n _aggregateStore = aggregateStore;\n _payerContext = payerContext;\n _sqlConnectionFactory = sqlConnectionFactory;\n }\n\n public async Task Handle(BuySubscriptionCommand command, CancellationToken cancellationToken)\n {\n var priceList = await PriceListProvider.GetPriceList(_sqlConnectionFactory.GetOpenConnection());\n\n var subscriptionPayment = SubscriptionPayment.Buy(\n _payerContext.PayerId,\n SubscriptionPeriod.Of(command.SubscriptionTypeCode),\n command.CountryCode,\n MoneyValue.Of(command.Value, command.Currency),\n priceList);\n \n _aggregateStore.AppendChanges(subscriptionPayment);\n\n return subscriptionPayment.Id;\n }\n}\n```\n\n`SubscriptionPayment` Aggregate:\n\n```csharp\npublic class SubscriptionPayment : AggregateRoot\n{\n private PayerId _payerId;\n\n private SubscriptionPeriod _subscriptionPeriod;\n\n private string _countryCode;\n\n private SubscriptionPaymentStatus _subscriptionPaymentStatus;\n\n private MoneyValue _value;\n\n protected override void Apply(IDomainEvent @event)\n {\n this.When((dynamic)@event);\n }\n\n public static SubscriptionPayment Buy(\n PayerId payerId,\n SubscriptionPeriod period,\n string countryCode,\n MoneyValue priceOffer,\n PriceList priceList)\n {\n var priceInPriceList = priceList.GetPrice(countryCode, period, PriceListItemCategory.New);\n CheckRule(new PriceOfferMustMatchPriceInPriceListRule(priceOffer, priceInPriceList));\n\n var subscriptionPayment = new SubscriptionPayment();\n\n var subscriptionPaymentCreated = new SubscriptionPaymentCreatedDomainEvent(\n Guid.NewGuid(),\n payerId.Value,\n period.Code,\n countryCode,\n SubscriptionPaymentStatus.WaitingForPayment.Code,\n priceOffer.Value,\n priceOffer.Currency);\n\n subscriptionPayment.Apply(subscriptionPaymentCreated);\n subscriptionPayment.AddDomainEvent(subscriptionPaymentCreated);\n\n return subscriptionPayment;\n }\n\n private void When(SubscriptionPaymentCreatedDomainEvent @event)\n {\n this.Id = @event.SubscriptionPaymentId;\n _payerId = new PayerId(@event.PayerId);\n _subscriptionPeriod = SubscriptionPeriod.Of(@event.SubscriptionPeriodCode);\n _countryCode = @event.CountryCode;\n _subscriptionPaymentStatus = SubscriptionPaymentStatus.Of(@event.Status);\n _value = MoneyValue.Of(@event.Value, @event.Currency);\n }\n```\n\n`AggregateRoot` base class:\n\n```csharp\npublic abstract class AggregateRoot\n{\n public Guid Id { get; protected set; }\n\n public int Version { get; private set; }\n\n private readonly List _domainEvents;\n\n protected AggregateRoot()\n {\n _domainEvents = new List();\n\n Version = -1;\n }\n\n protected void AddDomainEvent(IDomainEvent @event)\n {\n _domainEvents.Add(@event);\n }\n\n public IReadOnlyCollection GetDomainEvents() => _domainEvents.AsReadOnly();\n\n public void Load(IEnumerable history)\n {\n foreach (var e in history)\n {\n Apply(e);\n Version++;\n }\n }\n\n protected abstract void Apply(IDomainEvent @event);\n\n protected static void CheckRule(IBusinessRule rule)\n {\n if (rule.IsBroken())\n {\n throw new BusinessRuleValidationException(rule);\n }\n }\n}\n\n```\n\nAggregate Store implementation with SQL Stream Store library usage:\n\n```csharp\npublic class SqlStreamAggregateStore : IAggregateStore\n{\n private readonly IStreamStore _streamStore;\n\n private readonly List _appendedChanges;\n\n private readonly List _aggregatesToSave;\n\n public SqlStreamAggregateStore(\n ISqlConnectionFactory sqlConnectionFactory)\n {\n _appendedChanges = new List();\n\n _streamStore =\n new MsSqlStreamStore(\n new MsSqlStreamStoreSettings(sqlConnectionFactory.GetConnectionString())\n {\n Schema = DatabaseSchema.Name\n });\n\n _aggregatesToSave = new List();\n }\n\n public async Task Save()\n {\n foreach (var aggregateToSave in _aggregatesToSave)\n {\n await _streamStore.AppendToStream(\n GetStreamId(aggregateToSave.Aggregate),\n aggregateToSave.Aggregate.Version,\n aggregateToSave.Messages.ToArray());\n }\n\n _aggregatesToSave.Clear();\n }\n\n public async Task Load(AggregateId aggregateId) where T : AggregateRoot\n {\n var streamId = GetStreamId(aggregateId);\n\n IList domainEvents = new List();\n ReadStreamPage readStreamPage;\n do\n {\n readStreamPage = await _streamStore.ReadStreamForwards(streamId, StreamVersion.Start, maxCount: 100);\n var messages = readStreamPage.Messages;\n foreach (var streamMessage in messages)\n {\n Type type = DomainEventTypeMappings.Dictionary[streamMessage.Type];\n var jsonData = await streamMessage.GetJsonData();\n var domainEvent = JsonConvert.DeserializeObject(jsonData, type) as IDomainEvent;\n\n domainEvents.Add(domainEvent);\n }\n } while (!readStreamPage.IsEnd);\n\n var aggregate = (T)Activator.CreateInstance(typeof(T), true);\n\n aggregate.Load(domainEvents);\n\n return aggregate;\n }\n\n```\n\n##### Events Projection\n\nThe whole process looks like this:\n\n\n\n1. Special class `Subscriptions Manager` subscribes to Events Store (using SQL Store Stream library)\n2. Events Store raises `StreamMessageRecievedEvent`\n3. `Subscriptions Manager` invokes all projectors\n4. If projector know how to handle given event, it updates particular read model. In current implementation it updates special table in SQL database.\n\n`SubscriptionsManager` class implementation:\n\n```csharp\npublic class SubscriptionsManager\n{\n private readonly IStreamStore _streamStore;\n\n public SubscriptionsManager(\n IStreamStore streamStore)\n {\n _streamStore = streamStore;\n }\n\n public void Start()\n {\n long? actualPosition;\n\n using (var scope = PaymentsCompositionRoot.BeginLifetimeScope())\n {\n var checkpointStore = scope.Resolve();\n\n actualPosition = checkpointStore.GetCheckpoint(SubscriptionCode.All);\n }\n\n _streamStore.SubscribeToAll(actualPosition, StreamMessageReceived);\n }\n\n public void Stop()\n {\n _streamStore.Dispose();\n }\n\n private static async Task StreamMessageReceived(\n IAllStreamSubscription subscription, StreamMessage streamMessage, CancellationToken cancellationToken)\n {\n var type = DomainEventTypeMappings.Dictionary[streamMessage.Type];\n var jsonData = await streamMessage.GetJsonData(cancellationToken);\n var domainEvent = JsonConvert.DeserializeObject(jsonData, type) as IDomainEvent;\n\n using var scope = PaymentsCompositionRoot.BeginLifetimeScope();\n\n var projectors = scope.Resolve>();\n\n var tasks = projectors\n .Select(async projector =>\n {\n await projector.Project(domainEvent);\n });\n\n await Task.WhenAll(tasks);\n\n var checkpointStore = scope.Resolve();\n await checkpointStore.StoreCheckpoint(SubscriptionCode.All, streamMessage.Position);\n }\n}\n\n```\n\nExample projector:\n\n```csharp\ninternal class SubscriptionDetailsProjector : ProjectorBase, IProjector\n{\n private readonly IDbConnection _connection;\n\n public SubscriptionDetailsProjector(ISqlConnectionFactory sqlConnectionFactory)\n {\n _connection = sqlConnectionFactory.GetOpenConnection();\n }\n\n public async Task Project(IDomainEvent @event)\n {\n await When((dynamic) @event);\n }\n\n private async Task When(SubscriptionRenewedDomainEvent subscriptionRenewed)\n {\n var period = SubscriptionPeriod.GetName(subscriptionRenewed.SubscriptionPeriodCode);\n \n await _connection.ExecuteScalarAsync(\"UPDATE payments.SubscriptionDetails \" +\n \"SET \" +\n \"[Status] = @Status, \" +\n \"[ExpirationDate] = @ExpirationDate, \" +\n \"[Period] = @Period \" +\n \"WHERE [Id] = @SubscriptionId\",\n new\n {\n subscriptionRenewed.SubscriptionId,\n subscriptionRenewed.Status,\n subscriptionRenewed.ExpirationDate,\n period\n });\n }\n\n private async Task When(SubscriptionExpiredDomainEvent subscriptionExpired)\n {\n await _connection.ExecuteScalarAsync(\"UPDATE payments.SubscriptionDetails \" +\n \"SET \" +\n \"[Status] = @Status \" +\n \"WHERE [Id] = @SubscriptionId\",\n new\n {\n subscriptionExpired.SubscriptionId,\n subscriptionExpired.Status\n });\n }\n\n private async Task When(SubscriptionCreatedDomainEvent subscriptionCreated)\n {\n var period = SubscriptionPeriod.GetName(subscriptionCreated.SubscriptionPeriodCode);\n \n await _connection.ExecuteScalarAsync(\"INSERT INTO payments.SubscriptionDetails \" +\n \"([Id], [Period], [Status], [CountryCode], [ExpirationDate]) \" +\n \"VALUES (@SubscriptionId, @Period, @Status, @CountryCode, @ExpirationDate)\",\n new\n {\n subscriptionCreated.SubscriptionId,\n period,\n subscriptionCreated.Status,\n subscriptionCreated.CountryCode,\n subscriptionCreated.ExpirationDate\n });\n }\n}\n\n```\n\n#### Sample view of Event Store\n\nSample *Event Store* view after execution of SubscriptionLifecycleTests Integration Test which includes following steps:\n\n1. Creating Price List\n2. Buying Subscription\n3. Renewing Subscription\n4. Expiring Subscription\n\nlooks like this (*SQL Stream Store* table - *payments.Messages*):\n\n\n\n### 3.16 Database Change Management\n\nDatabase change management is accomplished by *migrations/transitions* versioning. Additionally, the current state of the database structure is also versioned.\n\nMigrations are applied using a simple [DatabaseMigrator](src/Database/DatabaseMigrator) console application that uses the [DbUp](https://dbup.readthedocs.io/en/latest/) library. The current state of the database structure is kept in the [SSDT Database Project](https://docs.microsoft.com/en-us/sql/ssdt/how-to-create-a-new-database-project).\n\nThe database update is performed by running the following command:\n\n```shell\ndotnet DatabaseMigrator.dll \"connection_string\" \"scripts_directory_path\"\n```\n\nThe entire solution is described in detail in the following articles:\n\n1. [Database change management](https://www.kamilgrzybek.com/database/database-change-management/) (theory)\n2. [Using database project and DbUp for database management](https://www.kamilgrzybek.com/database/using-database-project-and-dbup-for-database-management/) (implementation)\n\n### 3.17 Continuous Integration\n\n#### Definition\n\nAs defined on [Martin Fowler's website](https://martinfowler.com/articles/continuousIntegration.html):\n> *Continuous Integration is a software development practice where members of a team integrate their work frequently, usually each person integrates at least daily - leading to multiple integrations per day. Each integration is verified by an automated build (including test) to detect integration errors as quickly as possible.*\n\n#### YAML Implementation [OBSOLETE]\n\n*Originally the build was implemented using yaml and GitHub Actions functionality. Currently, the build is implemented with NUKE (see next section). See [buildPipeline.yml](.github/workflows/buildPipeline.yml)* file history.\n\n##### Pipeline description\n\nCI was implemented using [GitHub Actions](https://docs.github.com/en/actions/getting-started-with-github-actions/about-github-actions). For this purpose, one workflow, which triggers on Pull Request to *master* branch or Push to *master* branch was created. It contains 2 jobs:\n\n- build test, execute Unit Tests and Architecture Tests\n- execute Integration Tests\n\n\n\n**Steps description**
\na) Checkout repository - clean checkout of git repository
\nb) Setup .NET - install .NET 8.0 SDK
\nc) Install dependencies - resolve NuGet packages
\nd) Build - build solution
\ne) Run Unit Tests - run automated Unit Tests (see section 3.10)
\nf) Run Architecture Tests - run automated Architecture Tests (see section 3.12)
\ng) Initialize containers - setup Docker container for MS SQL Server
\nh) Wait for SQL Server initialization - after container initialization MS SQL Server is not ready, initialization of server itself takes some time so 30 seconds timeout before execution of next step is needed
\ni) Create Database - create and initialize database
\nj) Migrate Database - execute database upgrade using *DatabaseMigrator* application (see 3.16 section)
\nk) Run Integration Tests - perform Integration and System Integration Testing (see section 3.13 and 3.14)
\n\n##### Workflow definition\n\nWorkflow definition: [buildPipeline.yml](.github/workflows/buildPipeline.yml)\n\n##### Example workflow execution\n\nExample workflow output:\n\n\n\n\n\n#### NUKE\n\n[Nuke](https://nuke.build/) is *the cross-platform build automation solution for .NET with C# DSL.*\n\nThe 2 main advantages of its use over pure yaml defined in GitHub actions are as follows:\n\n- You run the same code on local machine and in the build server. See [buildPipeline.yml](.github/workflows/buildPipeline.yml)\n- You use C# with all the goodness (debugging, compilation, packages, refactoring and so on)\n\nThis is how one of the stage definition looks like (execute Build, Unit Tests, Architecture Tests) [Build.cs](build/Build.cs):\n\n```csharp\npartial class Build : NukeBuild\n{\n /// Support plugins are available for:\n /// - JetBrains ReSharper https://nuke.build/resharper\n /// - JetBrains Rider https://nuke.build/rider\n /// - Microsoft VisualStudio https://nuke.build/visualstudio\n /// - Microsoft VSCode https://nuke.build/vscode\n\n public static int Main () => Execute(x => x.Compile);\n\n [Parameter(\"Configuration to build - Default is 'Debug' (local) or 'Release' (server)\")]\n readonly Configuration Configuration = IsLocalBuild ? Configuration.Debug : Configuration.Release;\n\n [Solution] readonly Solution Solution;\n\n Target Clean => _ => _\n .Before(Restore)\n .Executes(() =>\n {\n EnsureCleanDirectory(WorkingDirectory);\n });\n\n Target Restore => _ => _\n .Executes(() =>\n {\n DotNetRestore(s => s\n .SetProjectFile(Solution));\n });\n\n Target Compile => _ => _\n .DependsOn(Restore)\n .Executes(() =>\n {\n DotNetBuild(s => s\n .SetProjectFile(Solution)\n .SetConfiguration(Configuration)\n .EnableNoRestore());\n });\n\n Target UnitTests => _ => _\n .DependsOn(Compile)\n .Executes(() =>\n {\n DotNetTest(s => s\n .SetProjectFile(Solution)\n .SetFilter(\"UnitTests\")\n .SetConfiguration(Configuration)\n .EnableNoRestore()\n .EnableNoBuild());\n });\n\n Target ArchitectureTests => _ => _\n .DependsOn(UnitTests)\n .Executes(() =>\n {\n DotNetTest(s => s\n .SetProjectFile(Solution)\n .SetFilter(\"ArchTests\")\n .SetConfiguration(Configuration)\n .EnableNoRestore()\n .EnableNoBuild());\n });\n\n Target BuildAndUnitTests => _ => _\n .Triggers(ArchitectureTests)\n .Executes(() =>\n {\n });\n}\n\n```\n\nIf you want to see more complex scenario when integration tests are executed (with SQL Server database creation using docker) see [BuildIntegrationTests.cs](build/BuildIntegrationTests.cs) file.\n\n#### SQL Server database project build\n\nCurrently, compilation of database projects is not supported by the .NET Core and dotnet tool. For this reason, the [MSBuild.Sdk.SqlProj](https://github.com/rr-wfm/MSBuild.Sdk.SqlProj/) library was used. In order to do that, you need to create .NET standard library, change SDK and create links to scripts folders. Final [database project](src/Database/CompanyName.MyMeetings.Database.Build/CompanyName.MyMeetings.Database.Build.csproj) looks as follows:\n\n```xml\n\n \n netstandard2.0\n \n \n \n \n \n \n \n \n \n\n```\n\n### 3.18 Static code analysis\n\nIn order to standardize the appearance of the code and increase its readability, the [StyleCopAnalyzers](https://github.com/DotNetAnalyzers/StyleCopAnalyzers) library was used. This library implements StyleCop rules using the .NET Compiler Platform and is responsible for the static code analysis.
\n\nUsing this library is trivial - it is just added as a NuGet package to all projects. There are many ways to configure rules, but currently the best way to do this is to edit the [.editorconfig](src/.editorconfig) file. More information can be found at the link above.
\n\n**Note! Static code analysis works best when the following points are met:**
\n\n1. Each developer has an IDE that respects the rules and helps to follow them\n2. The rules are checked during the project build process as part of Continuous Integration\n3. The rules are set to *help your system grow*. **Static analysis is not a value in itself.** Some rules may not make complete sense and should be turned off. Other rules may have higher priority. It all depends on the project, company standards and people involved in the project. Be pragmatic.\n\n### 3.19 System Under Test SUT\n\nThere is always a need to prepare the entire system in a specific state, e.g. for manual, exploratory, UX / UI tests. The fact that the tests are performed manually does not mean that we cannot automate the preparation phase (Given / Arrange). Thanks to the automation of system state preparation ([System Under Test](https://en.wikipedia.org/wiki/System_under_test)), we are able to recreate exactly the same state in any environment. In addition, such automation can be used later to automate the entire test (e.g. through an [3.13 Integration Tests](#313-integration-tests)).
\n\nThe implementation of such automation based on the use of NUKE and the test framework is presented below. As in the case of integration testing, we use the public API of modules.\n\n\n\nBelow is a SUT whose task is to go through the whole process - from setting up a *Meeting Group*, through its *Payment*, adding a new *Meeting* and signing up for it by another user.\n\n```csharp\npublic class CreateMeeting : TestBase\n{\n protected override bool PerformDatabaseCleanup => true;\n\n [Test]\n public async Task Prepare()\n {\n await UsersFactory.GivenAdmin(\n UserAccessModule,\n \"testAdmin@mail.com\",\n \"testAdminPass\",\n \"Jane Doe\",\n \"Jane\",\n \"Doe\",\n \"testAdmin@mail.com\");\n\n var userId = await UsersFactory.GivenUser(\n UserAccessModule,\n ConnectionString,\n \"adamSmith@mail.com\",\n \"adamSmithPass\",\n \"Adam\",\n \"Smith\",\n \"adamSmith@mail.com\");\n\n ExecutionContextAccessor.SetUserId(userId);\n\n var meetingGroupId = await MeetingGroupsFactory.GivenMeetingGroup(\n MeetingsModule,\n AdministrationModule,\n ConnectionString,\n \"Software Craft\",\n \"Group for software craft passionates\",\n \"Warsaw\",\n \"PL\");\n\n await TestPriceListManager.AddPriceListItems(PaymentsModule, ConnectionString);\n\n await TestPaymentsManager.BuySubscription(\n PaymentsModule,\n ExecutionContextAccessor);\n \n SetDate(new DateTime(2022, 7, 1, 10, 0, 0));\n\n var meetingId = await TestMeetingFactory.GivenMeeting(\n MeetingsModule,\n meetingGroupId,\n \"Tactical DDD\",\n new DateTime(2022, 7, 10, 18, 0, 0),\n new DateTime(2022, 7, 10, 20, 0, 0),\n \"Meeting about Tactical DDD patterns\",\n \"Location Name\",\n \"Location Address\",\n \"01-755\",\n \"Warsaw\",\n 50,\n 0,\n null,\n null,\n 0,\n null,\n new List()\n );\n \n var attendeeUserId = await UsersFactory.GivenUser(\n UserAccessModule,\n ConnectionString,\n \"rickmorty@mail.com\",\n \"rickmortyPass\",\n \"Rick\",\n \"Morty\",\n \"rickmorty@mail.com\");\n \n ExecutionContextAccessor.SetUserId(attendeeUserId);\n\n await TestMeetingGroupManager.JoinToGroup(MeetingsModule, meetingGroupId);\n\n await TestMeetingManager.AddAttendee(MeetingsModule, meetingId, guestsNumber: 1);\n }\n}\n```\n\nYou can create this SUT using following *NUKE* target providing connection string and particular test name:\n\n```shell\n .\\build PrepareSUT --DatabaseConnectionString \"connection_string\" --SUTTestName CreateMeeting\n```\n\n### 3.20 Mutation Testing\n\n#### Description\n\nMutation testing is an approach to test and evaluate our existing tests. During mutation testing a special framework modifies pieces of our code and runs our tests. These modifications are called *mutations* or *mutants*. If a given *mutation* does not cause a failure of at least once test, it means that the mutant has *survived* so our tests are probably not sufficient.\n\n#### Example\n\nIn this repository, the [Stryker.NET](https://stryker-mutator.io/docs/stryker-net/Introduction) framework was used for mutation testing. In the simplest use, after installation, all you need to do is enter the directory of tests that you want to mutate and run the following command:\n\n```shell\ndotnet stryker\n```\n\nThe result of this command is the *mutation report file*. Assuming we want to test the unit tests of the Meetings module, such a [report](docs/mutation-tests-reports/mutation-report.html) has been generated. This is its first page:\n\n\n\nLet us analyze one of the places where the mutant survived. This is the *AddNotAttendee* method of the *Meeting* class. This method is used to add a *Member* to the list of people who have decided not to attend the meeting. According to the logic, if the same person previously indicated that he was going to the *Meeting* and later changed his mind, then if there is someone on the *Waiting List*, he should be added to the attendees. Based on requirements, this should be the person who signed up on the *Waiting List* **first** (based on **SignUpDate**).\n\n\n\nAs you can see, the mutation framework changed our sorting in linq query (from default ascending to descending). However, each test was successful, so it means that mutant survived so we don't have a test that checks the correct sort based on *SignUpDate*.\n\nFrom the example above, one more important thing can be deduced - **code coverage is insufficient**. In the given example, this code is covered, but our tests do not check the given requirement, therefore our code may have errors. Mutation testing allow to detect such situations. Of course, as with any tool, we should use it wisely, as not every case requires our attention.\n\n## 4. Technology\n\nList of technologies, frameworks and libraries used for implementation:\n\n- [.NET 8.0](https://dotnet.microsoft.com/download) (platform). Note for Visual Studio users: **VS 2019** is required.\n- [MS SQL Server Express](https://www.microsoft.com/en-us/sql-server/sql-server-editions-express) (database)\n- [Entity Framework Core 8.0](https://docs.microsoft.com/en-us/ef/core/) (ORM Write Model implementation for DDD)\n- [Autofac](https://autofac.org/) (Inversion of Control Container)\n- [IdentityServer4](http://docs.identityserver.io) (Authentication and Authorization)\n- [Serilog](https://serilog.net/) (structured logging)\n- [Hellang.Middleware.ProblemDetails](https://github.com/khellang/Middleware/tree/master/src/ProblemDetails) (API Problem Details support)\n- [Swashbuckle](https://github.com/domaindrivendev/Swashbuckle) (Swagger automated documentation)\n- [Dapper](https://github.com/StackExchange/Dapper) (micro ORM for Read Model)\n- [Newtonsoft.Json](https://www.newtonsoft.com/json) (serialization/deserialization to/from JSON)\n- [Quartz.NET](https://www.quartz-scheduler.net/) (background processing)\n- [FluentValidation](https://fluentvalidation.net/) (data validation)\n- [MediatR](https://github.com/jbogard/MediatR) (mediator implementation)\n- [Postman](https://www.getpostman.com/) (API tests)\n- [NUnit](https://nunit.org/) (Testing framework)\n- [NSubstitute](https://nsubstitute.github.io/) (Testing isolation framework)\n- [Visual Paradigm Community Edition](https://www.visual-paradigm.com/download/community.jsp) (CASE tool for modeling and documentation)\n- [NetArchTest](https://github.com/BenMorris/NetArchTest) (Architecture Unit Tests library)\n- [Polly](https://github.com/App-vNext/Polly) (Resilience and transient-fault-handling library)\n- [SQL Stream Store](https://github.com/SQLStreamStore) (Library to assist with Event Sourcing)\n- [DbUp](https://dbup.readthedocs.io/en/latest/) (Database migrations deployment)\n- [SSDT Database Project](https://docs.microsoft.com/en-us/sql/ssdt/how-to-create-a-new-database-project) (Database structure versioning)\n- [GitHub Actions](https://docs.github.com/en/actions) (Continuous Integration workflows implementation)\n- [StyleCopAnalyzers](https://github.com/DotNetAnalyzers/StyleCopAnalyzers) (Static code analysis library)\n- [PlantUML](https://plantuml.com) (UML diagrams from textual description, diagrams as text)\n- [C4 Model](https://c4model.com/) (Model for visualising software architecture)\n- [C4-PlantUML](https://github.com/plantuml-stdlib/C4-PlantUML) (C4 Model for PlantUML plugin)\n- [NUKE](https://nuke.build/) (Build automation system)\n- [MSBuild.Sdk.SqlProj](https://github.com/rr-wfm/MSBuild.Sdk.SqlProj/) (Database project compilation)\n- [Stryker.NET](https://stryker-mutator.io/docs/stryker-net/Introduction) (Mutation Testing framework)\n\n## 5. How to Run\n\n### Install .NET 8.0 SDK\n\n- [Download](https://dotnet.microsoft.com/en-us/download/dotnet/8.0) and install .NET 8.0 SDK\n\n### Create database\n\n- Download and install MS SQL Server Express or other\n- Create an empty database using [CreateDatabase_Windows.sql](src/Database/CompanyName.MyMeetings.Database/Scripts/CreateDatabase_Windows.sql) or [CreateDatabase_Linux.sql](src/Database/CompanyName.MyMeetings.Database/Scripts/CreateDatabase_Linux.sql). Script adds **app** schema which is needed for migrations journal table. Change database file path if needed.\n- Run database migrations using **MigrateDatabase** NUKE target by executing the build.sh script present in the root folder:\n\n```shell\n.\\build MigrateDatabase --DatabaseConnectionString \"connection_string\"\n```\n\n*\"connection_string\"* - connection string to your database\n\n### Seed database\n\n- Execute [SeedDatabase.sql](src/Database/CompanyName.MyMeetings.Database/Scripts/SeedDatabase.sql) script\n- 2 test users will be created - check the script for usernames and passwords\n\n### Configure connection string\n\nSet a database connection string called `MeetingsConnectionString` in the root of the API project's appsettings.json or use [Secrets](https://blogs.msdn.microsoft.com/mihansen/2017/09/10/managing-secrets-in-net-core-2-0-apps/)\n\nExample config setting in appsettings.json for a database called `MyMeetings`:\n\n```json\n{\n \"MeetingsConnectionString\": \"Server=(localdb)\\\\mssqllocaldb;Database=MyMeetings;Trusted_Connection=True;\"\n}\n```\n\n### Configure startup in IDE\n\n- Set the Startup Item in your IDE to the API Project, not IIS Express\n\n### Authenticate\n\n- Once it is running you'll need a token to make API calls. This is done via OAuth2 [Resource Owner Password Grant Type](https://www.oauth.com/oauth2-servers/access-tokens/password-grant/). By default IdentityServer is configured with the following:\n- `client_id = ro.client`\n- `client_secret = secret` **(this is literally the value - not a statement that this value is secret!)**\n- `scope = myMeetingsAPI openid profile`\n- `grant_type = password`\n\nInclude the credentials of a test user created in the [SeedDatabase.sql](src/Database/CompanyName.MyMeetings.Database/Scripts/SeedDatabase.sql) script - for example:\n\n- `username = testMember@mail.com`\n- `password = testMemberPass`\n\n**Example HTTP Request for an Access Token:**\n\n```http\nPOST /connect/token HTTP/1.1\nHost: localhost:5000\n \ngrant_type=password\n&username=testMember@mail.com\n&password=testMemberPass\n&client_id=ro.client\n&client_secret=secret\n```\n\nThis will fetch an access token for this user to make authorized API requests using the HTTP request header `Authorization: Bearer `\n\nIf you use a tool such as Postman to test your API, the token can be fetched and stored within the tool itself and appended to all API calls. Check your tool documentation for instructions.\n\n### Run using Docker Compose\n\nYou can run whole application using [docker compose](https://docs.docker.com/compose/) from root folder:\n\n```shell\ndocker-compose up\n```\n\nIt will create following services:
\n\n- MS SQL Server Database\n- Database Migrator\n- Application\n\n### Run Integration Tests in Docker\n\nYou can run all Integration Tests in Docker (exactly the same process is executed on CI) using **RunAllIntegrationTests** NUKE target:\n\n```shell\n.\\build RunAllIntegrationTests\n```\n\n## 6. Contribution\n\nThis project is still under analysis and development. I assume its maintenance for a long time and I would appreciate your contribution to it. Please let me know by creating an Issue or Pull Request.\n\n## 7. Roadmap\n\nList of features/tasks/approaches to add:\n\n| Name | Status | Release date |\n|------------------------------------| -------- |--------------|\n| Domain Model Unit Tests |Completed | 2019-09-10 |\n| Architecture Decision Log update | Completed | 2019-11-09 |\n| Integration automated tests | Completed | 2020-02-24 |\n| Migration to .NET Core 3.1 |Completed | 2020-03-04 |\n| System Integration Testing | Completed | 2020-03-28 |\n| More advanced Payments module | Completed | 2020-07-11 |\n| Event Sourcing implementation | Completed | 2020-07-11 |\n| Database Change Management | Completed | 2020-08-23 |\n| Continuous Integration | Completed | 2020-09-01 |\n| StyleCop Static Code Analysis | Completed | 2020-09-05 |\n| FrontEnd SPA application | Completed | 2020-11-08 |\n| Docker support | Completed | 2020-11-26 |\n| PlantUML Conceptual Model | Completed | 2021-03-22 |\n| C4 Model | Completed | 2021-03-29 |\n| Meeting comments feature | Completed | 2021-03-30 |\n| NUKE build automation | Completed | 2021-06-15 |\n| Database project compilation on CI | Completed | 2021-06-15 |\n| System Under Test implementation | Completed | 2022-07-17 |\n| Mutation Testing | Completed | 2022-08-23 |\n| Migration to .NET 8.0 | Completed | 2023-12-09 |\n\nNOTE: Please don't hesitate to suggest something else or a change to the existing code. All proposals will be considered.\n\n## 8. Authors\n\nKamil Grzybek\n\nBlog: [https://kamilgrzybek.com](https://kamilgrzybek.com)\n\nTwitter: [https://twitter.com/kamgrzybek](https://twitter.com/kamgrzybek)\n\nLinkedIn: [https://www.linkedin.com/in/kamilgrzybek/](https://www.linkedin.com/in/kamilgrzybek/)\n\nGitHub: [https://github.com/kgrzybek](https://github.com/kgrzybek)\n\n### 8.1 Main contributors\n\n- [Andrei Ganichev](https://github.com/AndreiGanichev)\n- [Bela Istok](https://github.com/bistok)\n- [Almar Aubel](https://github.com/AlmarAubel)\n\n## 9. License\n\nThe project is under [MIT license](https://opensource.org/licenses/MIT).\n\n## 10. Inspirations and Recommendations\n\n### Modular Monolith\n\n- [\"Modular Monolith: A Primer\"](https://www.kamilgrzybek.com/design/modular-monolith-primer/) Modular Monolith architecture article series, Kamil Grzybek\n- [\"Modular Monolith Architecture: One to rule them all\"](https://www.youtube.com/watch?v=njDSXUWeik0) presentation, Kamil Grzybek\n- [\"Modular Monoliths\"](https://www.youtube.com/watch?v=5OjqD-ow8GE) presentation, Simon Brown\n- [\"Majestic Modular Monoliths\"](https://www.youtube.com/watch?v=BOvxJaklcr0) presentation, Axel Fontaine\n- [\"Building Better Monoliths – Modulithic Applications with Spring Boot\"](https://speakerdeck.com/olivergierke/building-better-monoliths-modulithic-applications-with-spring-boot-cd16e6ec-d334-497d-b9f6-3f92d5db035a) slides, Oliver Drotbohm\n- [\"MonolithFirst\"](https://martinfowler.com/bliki/MonolithFirst.html) article, Martin Fowler\n- [\"Pattern: Monolithic Architecture\"](https://microservices.io/patterns/monolithic.html) pattern description, Chris Richardson\n\n### Domain-Driven Design\n\n- [\"Domain-Driven Design: Tackling Complexity in the Heart of Software\"](https://www.amazon.com/Domain-Driven-Design-Tackling-Complexity-Software/dp/0321125215) book, Eric Evans\n- [\"Implementing Domain-Driven Design\"](https://www.amazon.com/Implementing-Domain-Driven-Design-Vaughn-Vernon/dp/0321834577) book, Vaughn Vernon\n- [\"Domain-Driven Design Distilled\"](https://www.amazon.com/dp/0134434420) book, Vaughn Vernon\n- [\"Patterns, Principles, and Practices of Domain-Driven Design\"](https://www.amazon.com/Patterns-Principles-Practices-Domain-Driven-Design-ebook/dp/B00XLYUA0W) book, Scott Millett, Nick Tune\n- [\"Secure By Design\"](https://www.amazon.com/Secure-Design-Daniel-Deogun/dp/1617294357) book, Daniel Deogun, Dan Bergh Johnsson, Daniel Sawano\n- [\"Hands-On Domain-Driven Design with .NET Core: Tackling complexity in the heart of software by putting DDD principles into practice\"](https://www.amazon.com/Hands-Domain-Driven-Design-NET-ebook/dp/B07C5WSR9B) book, Alexey Zimarev\n- [\"Domain Modeling Made Functional: Tackle Software Complexity with Domain-Driven Design and F#\"](https://www.amazon.com/Domain-Modeling-Made-Functional-Domain-Driven-ebook/dp/B07B44BPFB) book, Scott Wlaschin\n- [\"DDD by examples - library\"](https://github.com/ddd-by-examples/library) GH repository, Jakub Pilimon, Bartłomiej Słota\n- [\"IDDD_Samples\"](https://github.com/VaughnVernon/IDDD_Samples) GH repository, Vaughn Vernon\n- [\"IDDD_Samples_NET\"](https://github.com/VaughnVernon/IDDD_Samples_NET) GH repository, Vaughn Vernon\n- [\"Awesome Domain-Driven Design\"](https://github.com/heynickc/awesome-ddd) GH repository, Nick Chamberlain\n\n### Application Architecture\n\n- [\"Patterns of Enterprise Application Architecture\"](https://martinfowler.com/books/eaa.html) book, Martin Fowler\n- [\"Dependency Injection Principles, Practices, and Patterns\"](https://www.manning.com/books/dependency-injection-principles-practices-patterns) book, Steven van Deursen, Mark Seemann\n- [\"Clean Architecture: A Craftsman's Guide to Software Structure and Design (Robert C. Martin Series\"](https://www.amazon.com/Clean-Architecture-Craftsmans-Software-Structure/dp/0134494164) book, Robert C. Martin\n- [\"The Clean Architecture\"](https://blog.cleancoder.com/uncle-bob/2012/08/13/the-clean-architecture.html) article, Robert C. Martin\n- [\"The Onion Architecture\"](https://jeffreypalermo.com/2008/07/the-onion-architecture-part-1/) article series, Jeffrey Palermo\n- [\"Hexagonal/Ports & Adapters Architecture\"](https://web.archive.org/web/20180822100852/http://alistair.cockburn.us/Hexagonal+architecture) article, Alistair Cockburn\n- [\"DDD, Hexagonal, Onion, Clean, CQRS, … How I put it all together\"](https://herbertograca.com/2017/11/16/explicit-architecture-01-ddd-hexagonal-onion-clean-cqrs-how-i-put-it-all-together/) article, Herberto Graca\n\n### Software Architecture\n\n- [\"Software Architecture in Practice (3rd Edition)\"](https://www.amazon.com/Software-Architecture-Practice-3rd-Engineering/dp/0321815734) book, Len Bass, Paul Clements, Rick Kazman\n- [\"Software Architecture for Developers Vol 1 & 2\"](https://softwarearchitecturefordevelopers.com/) book, Simon Brown\n- [\"Just Enough Software Architecture: A Risk-Driven Approach\"](https://www.amazon.com/Just-Enough-Software-Architecture-Risk-Driven/dp/0984618104) book, George H. Fairbanks\n- [\"Software Systems Architecture: Working With Stakeholders Using Viewpoints and Perspectives (2nd Edition)\"](https://www.amazon.com/Software-Systems-Architecture-Stakeholders-Perspectives/dp/032171833X/) book, Nick Rozanski, Eóin Woods\n- [\"Design It!: From Programmer to Software Architect (The Pragmatic Programmers)\"](https://www.amazon.com/Design-Programmer-Architect-Pragmatic-Programmers/dp/1680502093) book, Michael Keeling\n\n### System Architecture\n\n- [\"Enterprise Integration Patterns : Designing, Building, and Deploying Messaging Solutions\"](https://www.enterpriseintegrationpatterns.com/) book and catalogue, Gregor Hohpe, Bobby Woolf\n- [\"Designing Data-Intensive Applications: The Big Ideas Behind Reliable, Scalable, and Maintainable Systems \"](https://www.amazon.com/Designing-Data-Intensive-Applications-Reliable-Maintainable/dp/1449373321) book, Martin Kleppman\n- [\"Building Evolutionary Architectures: Support Constant Change\"](https://www.amazon.com/Building-Evolutionary-Architectures-Support-Constant/dp/1491986360) book, Neal Ford\n- [\"Building Microservices: Designing Fine-Grained Systems\"](https://www.amazon.com/Building-Microservices-Designing-Fine-Grained-Systems/dp/1491950358) book, Sam Newman\n\n### Design\n\n- [\"Refactoring: Improving the Design of Existing Code\"](https://www.amazon.com/Refactoring-Improving-Design-Existing-Code/dp/0201485672) book, Martin Fowler, Kent Beck, John Brant, William Opdyke, Don Roberts\n- [\"Clean Code: A Handbook of Agile Software Craftsmanship\"](https://www.amazon.com/Clean-Code-Handbook-Software-Craftsmanship/dp/0132350882) book, Robert C. Martin\n- [\"Agile Principles, Patterns, and Practices in C#\"](https://www.amazon.com/Agile-Principles-Patterns-Practices-C/dp/0131857258) book, Robert C. Martin\n- [\"Applying UML and Patterns: An Introduction to Object-Oriented Analysis and Design and Iterative Development (3rd Edition)\"](https://www.amazon.com/Applying-UML-Patterns-Introduction-Object-Oriented/dp/0131489062) book, Craig Larman\n- [\"Working Effectively with Legacy Code\"](https://www.amazon.com/Working-Effectively-Legacy-Michael-Feathers/dp/0131177052) book, Michael Feathers\n- [\"Code Complete: A Practical Handbook of Software Construction, Second Edition\"](https://www.amazon.com/Code-Complete-Practical-Handbook-Construction/dp/0735619670) book, Steve McConnell\n- [\"Design Patterns: Elements of Reusable Object-Oriented Software\"](https://www.amazon.com/Design-Patterns-Elements-Reusable-Object-Oriented/dp/0201633612) book, Erich Gamma, Richard Helm, Ralph Johnson, John Vlissides\n\n### Craftsmanship\n\n- [\"The Clean Coder: A Code of Conduct for Professional Programmers\"](https://www.amazon.com/Clean-Coder-Conduct-Professional-Programmers/dp/0137081073) book, Robert C. Martin\n- [\"The Pragmatic Programmer: From Journeyman to Master\"](https://www.amazon.com/Pragmatic-Programmer-Journeyman-Master/dp/020161622X) book, Andrew Hunt\n\n### Testing\n\n- [\"The Art of Unit Testing: with examples in C#\"](https://www.amazon.com/Art-Unit-Testing-examples/dp/1617290890) book, Roy Osherove\n- [\"Unit Test Your Architecture with ArchUnit\"](https://blogs.oracle.com/javamagazine/unit-test-your-architecture-with-archunit) article, Jonas Havers\n- [\"Unit Testing Principles, Practices, and Patterns\"](https://www.amazon.com/Unit-Testing-Principles-Practices-Patterns/dp/1617296279) book, Vladimir Khorikov\n- [\"Growing Object-Oriented Software, Guided by Tests\"](https://www.amazon.com/Growing-Object-Oriented-Software-Guided-Tests/dp/0321503627) book, Steve Freeman, Nat Pryce\n- [Automated Tests](https://www.kamilgrzybek.com/blog/series/automated-tests) article series, Kamil Grzybek\n\n### UML\n\n- [\"UML Distilled: A Brief Guide to the Standard Object Modeling Language (3rd Edition)\"](https://www.amazon.com/UML-Distilled-Standard-Modeling-Language/dp/0321193687) book, Martin Fowler\n\n### Event Storming\n\n- [\"Introducing EventStorming\"](https://leanpub.com/introducing_eventstorming) book, Alberto Brandolini\n- [\"Awesome EventStorming\"](https://github.com/mariuszgil/awesome-eventstorming) GH repository, Mariusz Gil\n\n### Event Sourcing\n\n- [\"Hands-On Domain-Driven Design with .NET Core: Tackling complexity in the heart of software by putting DDD principles into practice\"](https://www.amazon.com/Hands-Domain-Driven-Design-NET-ebook/dp/B07C5WSR9B) book, Alexey Zimarev\n- [\"Versioning in an Event Sourced System\"](https://leanpub.com/esversioning) book, Greg Young\n- [Hands-On-Domain-Driven-Design-with-.NET-Core](https://github.com/PacktPublishing/Hands-On-Domain-Driven-Design-with-.NET-Core) GH repository, Alexey Zimarev\n- [EventSourcing.NetCore](https://github.com/oskardudycz/EventSourcing.NetCore) GH repository, Oskar Dudycz\n"
},
{
"path": "azure-pipelines.yml",
"content": "# ASP.NET Core (.NET Framework)\n# Build and test ASP.NET Core projects targeting the full .NET Framework.\n# Add steps that publish symbols, save build artifacts, and more:\n# https://docs.microsoft.com/azure/devops/pipelines/languages/dotnet-core\n\ntrigger:\n- master\n\npool:\n vmImage: 'windows-latest'\n\nvariables:\n solution: '**/*.sln'\n buildPlatform: 'Any CPU'\n buildConfiguration: 'Release'\n\nsteps:\n- task: NuGetToolInstaller@1\n\n- task: NuGetCommand@2\n inputs:\n restoreSolution: '$(solution)'\n\n- task: VSBuild@1\n inputs:\n solution: '$(solution)'\n msbuildArgs: '/p:DeployOnBuild=true /p:WebPublishMethod=Package /p:PackageAsSingleFile=true /p:SkipInvalidConfigurations=true /p:DesktopBuildPackageLocation=\"$(build.artifactStagingDirectory)\\WebApp.zip\" /p:DeployIisAppPath=\"Default Web Site\"'\n platform: '$(buildPlatform)'\n configuration: '$(buildConfiguration)'\n\n- task: VSTest@2\n inputs:\n platform: '$(buildPlatform)'\n configuration: '$(buildConfiguration)'\n"
},
{
"path": "build/.editorconfig",
"content": "[*.cs]\ndotnet_style_qualification_for_field = false:warning\ndotnet_style_qualification_for_property = false:warning\ndotnet_style_qualification_for_method = false:warning\ndotnet_style_qualification_for_event = false:warning\ndotnet_style_require_accessibility_modifiers = never:warning\n\ncsharp_style_expression_bodied_methods = true:silent\ncsharp_style_expression_bodied_properties = true:warning\ncsharp_style_expression_bodied_indexers = true:warning\ncsharp_style_expression_bodied_accessors = true:warning\n"
},
{
"path": "build/Build.cs",
"content": "using Nuke.Common;\nusing Nuke.Common.IO;\nusing Nuke.Common.ProjectModel;\nusing Nuke.Common.Tools.DotNet;\nusing static Nuke.Common.Tools.DotNet.DotNetTasks;\n\n\npartial class Build : NukeBuild\n{\n /// Support plugins are available for:\n /// - JetBrains ReSharper https://nuke.build/resharper\n /// - JetBrains Rider https://nuke.build/rider\n /// - Microsoft VisualStudio https://nuke.build/visualstudio\n /// - Microsoft VSCode https://nuke.build/vscode\n\n public static int Main () => Execute(x => x.Compile);\n\n [Parameter(\"Configuration to build - Default is 'Debug' (local) or 'Release' (server)\")]\n readonly Configuration Configuration = IsLocalBuild ? Configuration.Debug : Configuration.Release;\n\n [Solution] readonly Solution Solution;\n\n Target Clean => _ => _\n .Before(Restore)\n .Executes(() =>\n {\n AbsolutePath.Create(WorkingDirectory).CreateOrCleanDirectory();\n });\n\n Target Restore => _ => _\n .Executes(() =>\n {\n DotNetRestore(s => s\n .SetProjectFile(Solution));\n });\n\n Target Compile => _ => _\n .DependsOn(Restore)\n .Executes(() =>\n {\n DotNetBuild(s => s\n .SetProjectFile(Solution)\n .SetConfiguration(Configuration)\n .EnableNoRestore());\n });\n\n Target UnitTests => _ => _\n .DependsOn(Compile)\n .Executes(() =>\n {\n DotNetTest(s => s\n .SetProjectFile(Solution)\n .SetFilter(\"UnitTests\")\n .SetConfiguration(Configuration)\n .EnableNoRestore()\n .EnableNoBuild());\n });\n\n Target ArchitectureTests => _ => _\n .DependsOn(UnitTests)\n .Executes(() =>\n {\n DotNetTest(s => s\n .SetProjectFile(Solution)\n .SetFilter(\"ArchTests\")\n .SetConfiguration(Configuration)\n .EnableNoRestore()\n .EnableNoBuild());\n });\n\n Target BuildAndUnitTests => _ => _\n .Triggers(ArchitectureTests)\n .Executes(() =>\n {\n });\n}\n"
},
{
"path": "build/BuildIntegrationTests.cs",
"content": "using System;\nusing System.Linq;\nusing Nuke.Common;\nusing Nuke.Common.IO;\nusing Nuke.Common.Tools.Docker;\nusing Nuke.Common.Tools.DotNet;\nusing Utils;\nusing static Nuke.Common.IO.FileSystemTasks;\nusing static Nuke.Common.Tools.DotNet.DotNetTasks;\n\npublic partial class Build\n{\n static AbsolutePath WorkingDirectory => RootDirectory / \".nuke-working-directory\";\n\n static AbsolutePath OutputDirectory => WorkingDirectory / \"output\";\n\n static AbsolutePath OutputDbUbMigratorBuildDirectory => OutputDirectory / \"dbUpMigrator\";\n\n static AbsolutePath InputFilesDirectory => WorkingDirectory / \"input-files\";\n\n static AbsolutePath DatabaseDirectory =>\n RootDirectory / \"src\" / \"Database\" / \"CompanyName.MyMeetings.Database\" / \"Scripts\";\n\n const string CreateDatabaseScriptName = \"CreateDatabase_Linux.sql\";\n\n const string InputFilesDirectoryName = \"input-files\";\n\n Target PrepareInputFiles => _ => _\n .DependsOn(Clean)\n .Executes(() =>\n {\n string createDatabaseFile = DatabaseDirectory / CreateDatabaseScriptName;\n string createDatabaseFileTarget = InputFilesDirectory / CreateDatabaseScriptName;\n CopyFile(createDatabaseFile, createDatabaseFileTarget, FileExistsPolicy.Overwrite);\n });\n\n const string SqlServerPassword = \"123qwe!@#QWE\";\n\n const string SqlServerUser = \"sa\";\n\n const string SqlServerPort = \"1401\";\n\n Target PrepareSqlServer => _ => _\n .DependsOn(PrepareInputFiles)\n .Executes(() =>\n {\n DockerTasks.DockerRun(s => s\n .EnableRm()\n .SetName(\"sql-server-db\")\n .SetImage(\"mcr.microsoft.com/mssql/server\")\n .SetEnv(\n $\"SA_PASSWORD={SqlServerPassword}\",\n \"ACCEPT_EULA=Y\",\n \"MSSQL_PID=Express\")\n .SetPublish($\"{SqlServerPort}:1433\")\n .SetMount($\"type=bind,source=\\\"{InputFilesDirectory}\\\",target=/{InputFilesDirectoryName},readonly\")\n .EnableDetach());\n\n SqlReadinessChecker.WaitForSqlSever(\n $\"Server=127.0.0.1,{SqlServerPort};Database=master;User={SqlServerUser};Password={SqlServerPassword};Encrypt=False;\");\n });\n\n Target CreateDatabase => _ => _\n .DependsOn(PrepareSqlServer)\n .Executes(() =>\n {\n DockerTasks.DockerExec(s => s\n .EnableInteractive()\n .SetContainer(\"sql-server-db\")\n .SetCommand(\"/bin/sh\")\n .SetArgs(\"-c\", $\"./opt/mssql-tools/bin/sqlcmd -d master -i ./{InputFilesDirectoryName}/{CreateDatabaseScriptName} -U {SqlServerUser} -P {SqlServerPassword}\"));\n });\n\n Target CompileDbUpMigratorForIntegrationTests => _ => _\n .DependsOn(CreateDatabase)\n .Executes(() =>\n {\n var dbUpMigratorProject = Solution.GetAllProjects(\"DatabaseMigrator\").First();\n DotNetBuild(s => s\n .SetProjectFile(dbUpMigratorProject)\n .SetConfiguration(Configuration)\n .SetOutputDirectory(OutputDbUbMigratorBuildDirectory)\n );\n });\n\n AbsolutePath DbUpMigratorPath => OutputDbUbMigratorBuildDirectory / \"DatabaseMigrator.dll\";\n\n readonly string MyMeetingsDatabaseConnectionString = $\"Server=127.0.0.1,{SqlServerPort};Database=MyMeetings;User={SqlServerUser};Password={SqlServerPassword};Encrypt=False;\";\n\n Target RunDatabaseMigrations => _ => _\n .DependsOn(CompileDbUpMigratorForIntegrationTests)\n .Executes(() =>\n {\n AbsolutePath migrationsPath = DatabaseDirectory / \"Migrations\";\n\n DotNet($\"{DbUpMigratorPath} {MyMeetingsDatabaseConnectionString} {migrationsPath}\");\n });\n\n const string MeetingsModuleIntegrationTestsAssemblyName = \"CompanyName.MyMeetings.Modules.Meetings.IntegrationTests\";\n\n Target BuildMeetingsModuleIntegrationTests => _ => _\n .DependsOn(RunDatabaseMigrations)\n .Executes(() =>\n {\n var integrationTest = Solution.GetAllProjects(MeetingsModuleIntegrationTestsAssemblyName).First();\n\n DotNetBuild(s => s\n .SetProjectFile(integrationTest)\n .DisableNoRestore());\n });\n\n const string MyMeetingsDatabaseEnvName = \"ASPNETCORE_MyMeetings_IntegrationTests_ConnectionString\";\n\n Target RunMeetingsModuleIntegrationTests => _ => _\n .DependsOn(BuildMeetingsModuleIntegrationTests)\n .Executes(() =>\n {\n var integrationTest = Solution.GetAllProjects(MeetingsModuleIntegrationTestsAssemblyName).First();\n Environment.SetEnvironmentVariable(\n MyMeetingsDatabaseEnvName,\n MyMeetingsDatabaseConnectionString);\n\n DotNetTest(s => s\n .EnableNoBuild()\n .SetProjectFile(integrationTest));\n });\n\n const string AdministrationModuleIntegrationTestsAssemblyName = \"CompanyName.MyMeetings.Modules.Administration.IntegrationTests\";\n\n Target BuildAdministrationModuleIntegrationTests => _ => _\n .DependsOn(RunDatabaseMigrations)\n .Executes(() =>\n {\n var integrationTest = Solution.GetAllProjects(AdministrationModuleIntegrationTestsAssemblyName).First();\n\n DotNetBuild(s => s\n .SetProjectFile(integrationTest)\n .DisableNoRestore());\n });\n\n Target RunAdministrationModuleIntegrationTests => _ => _\n .DependsOn(BuildAdministrationModuleIntegrationTests)\n .Executes(() =>\n {\n var integrationTest = Solution.GetAllProjects(AdministrationModuleIntegrationTestsAssemblyName).First();\n Environment.SetEnvironmentVariable(\n MyMeetingsDatabaseEnvName,\n MyMeetingsDatabaseConnectionString);\n\n DotNetTest(s => s\n .EnableNoBuild()\n .SetProjectFile(integrationTest));\n });\n\n const string UserAccessModuleIntegrationTestsAssemblyName = \"CompanyNames.MyMeetings.Modules.UserAccess.IntegrationTests\";\n\n Target BuildUserAccessModuleIntegrationTests => _ => _\n .DependsOn(RunDatabaseMigrations)\n .Executes(() =>\n {\n var integrationTest = Solution.GetAllProjects(UserAccessModuleIntegrationTestsAssemblyName).First();\n\n DotNetBuild(s => s\n .SetProjectFile(integrationTest)\n .DisableNoRestore());\n });\n\n Target RunUserAccessModuleIntegrationTests => _ => _\n .DependsOn(BuildUserAccessModuleIntegrationTests)\n .Executes(() =>\n {\n var integrationTest = Solution.GetAllProjects(UserAccessModuleIntegrationTestsAssemblyName).First();\n Environment.SetEnvironmentVariable(\n MyMeetingsDatabaseEnvName,\n MyMeetingsDatabaseConnectionString);\n\n DotNetTest(s => s\n .EnableNoBuild()\n .SetProjectFile(integrationTest));\n });\n\n const string PaymentsModuleIntegrationTestsAssemblyName = \"CompanyName.MyMeetings.Modules.Payments.IntegrationTests\";\n\n Target BuildPaymentsModuleIntegrationTests => _ => _\n .DependsOn(RunDatabaseMigrations)\n .Executes(() =>\n {\n var integrationTest = Solution.GetAllProjects(PaymentsModuleIntegrationTestsAssemblyName).First();\n\n DotNetBuild(s => s\n .SetProjectFile(integrationTest)\n .DisableNoRestore());\n });\n\n Target RunPaymentsModuleIntegrationTests => _ => _\n .DependsOn(BuildPaymentsModuleIntegrationTests)\n .Executes(() =>\n {\n var integrationTest = Solution.GetAllProjects(PaymentsModuleIntegrationTestsAssemblyName).First();\n Environment.SetEnvironmentVariable(\n MyMeetingsDatabaseEnvName,\n MyMeetingsDatabaseConnectionString);\n\n DotNetTest(s => s\n .EnableNoBuild()\n .SetProjectFile(integrationTest));\n });\n\n const string SystemIntegrationTestsAssemblyName = \"CompanyName.MyMeetings.IntegrationTests\";\n\n Target BuildSystemIntegrationTests => _ => _\n .DependsOn(RunDatabaseMigrations)\n .Executes(() =>\n {\n var integrationTest = Solution.GetAllProjects(SystemIntegrationTestsAssemblyName).First();\n\n DotNetBuild(s => s\n .SetProjectFile(integrationTest)\n .DisableNoRestore());\n });\n\n Target RunSystemIntegrationTests => _ => _\n .DependsOn(BuildSystemIntegrationTests)\n .Executes(() =>\n {\n var integrationTest = Solution.GetAllProjects(SystemIntegrationTestsAssemblyName).First();\n Environment.SetEnvironmentVariable(\n MyMeetingsDatabaseEnvName,\n MyMeetingsDatabaseConnectionString);\n\n DotNetTest(s => s\n .EnableNoBuild()\n .SetProjectFile(integrationTest));\n });\n\n Target RunAllIntegrationTests => _ => _\n .DependsOn(\n RunAdministrationModuleIntegrationTests,\n RunMeetingsModuleIntegrationTests,\n RunPaymentsModuleIntegrationTests,\n RunUserAccessModuleIntegrationTests,\n RunSystemIntegrationTests)\n .Executes(() =>\n {\n\n });\n}"
},
{
"path": "build/Configuration.cs",
"content": "using System.ComponentModel;\nusing Nuke.Common.Tooling;\n\n[TypeConverter(typeof(TypeConverter))]\npublic class Configuration : Enumeration\n{\n public static Configuration Debug = new Configuration { Value = nameof(Debug) };\n public static Configuration Release = new Configuration { Value = nameof(Release) };\n\n public static implicit operator string(Configuration configuration)\n {\n return configuration.Value;\n }\n}\n"
},
{
"path": "build/Database.cs",
"content": "using System.Linq;\nusing Nuke.Common;\nusing Nuke.Common.Tools.DotNet;\nusing static Nuke.Common.Tools.DotNet.DotNetTasks;\n\npublic partial class Build\n{\n Target CompileDbUpMigrator => _ => _\n .Executes(() =>\n {\n var dbUpMigratorProject = Solution.GetAllProjects(\"DatabaseMigrator\").First();\n \n DotNetBuild(s => s\n .SetProjectFile(dbUpMigratorProject)\n .SetConfiguration(Configuration)\n .SetOutputDirectory(OutputDbUbMigratorBuildDirectory)\n );\n });\n \n [Parameter(\"Modular Monolith database connection string\")] readonly string DatabaseConnectionString;\n Target MigrateDatabase => _ => _\n .Requires(() => DatabaseConnectionString != null)\n .DependsOn(CompileDbUpMigrator)\n .Executes(() =>\n {\n var migrationsPath = DatabaseDirectory / \"Migrations\";\n\n DotNet($\"{DbUpMigratorPath} {DatabaseConnectionString} {migrationsPath}\");\n });\n}"
},
{
"path": "build/Directory.Build.props",
"content": "\n\n\n \n \n \n\n\n"
},
{
"path": "build/Directory.Build.targets",
"content": "\n\n\n \n \n \n\n\n"
},
{
"path": "build/SUTCreator.cs",
"content": "using System;\nusing System.Collections.Generic;\nusing Nuke.Common;\nusing Nuke.Common.Tools.DotNet;\nusing static Nuke.Common.Tools.DotNet.DotNetTasks;\n\n\npublic partial class Build\n{\n [Parameter(\"SUT creator test name to execute\")] readonly string SUTTestName;\n\n readonly IDictionary TestCasesMap = new Dictionary\n {\n {\"CleanDatabase\", \"CompanyName.MyMeetings.SUT.TestCases.CleanDatabaseTestCase.Prepare\"},\n {\"OnlyAdmin\", \"CompanyName.MyMeetings.SUT.TestCases.OnlyAdminTestCase.Prepare\"},\n {\"CreateMeeting\", \"CompanyName.MyMeetings.SUT.TestCases.CreateMeeting.Prepare\"}\n };\n \n Target PrepareSUT => _ => _\n .Requires(() => SUTTestName != null)\n .Requires(() => DatabaseConnectionString != null)\n .Executes(() =>\n {\n Environment.SetEnvironmentVariable(\n \"MyMeetings_SUTDatabaseConnectionString\", \n DatabaseConnectionString,\n EnvironmentVariableTarget.Process);\n \n var sutTestProject = Solution.GetProject(\"CompanyName.MyMeetings.SUT\");\n\n var fullyQualifiedName = TestCasesMap[SUTTestName];\n \n DotNetTest(s => s\n .SetProjectFile(sutTestProject)\n \n .SetFilter($\"FullyQualifiedName={fullyQualifiedName}\"));\n });\n}"
},
{
"path": "build/Utils/SqlReadinessChecker.cs",
"content": "using System;\nusing System.Threading;\nusing Dapper;\nusing System.Data.SqlClient;\n\nnamespace Utils\n{\n public static class SqlReadinessChecker\n {\n public static void WaitForSqlSever(string connectionString)\n {\n using var connection = new SqlConnection(connectionString);\n\n const int maxTryCounts = 30;\n var tryCounts = 0;\n while (true)\n {\n tryCounts++;\n try\n {\n connection.QuerySingle(\"SELECT @@Version\");\n Serilog.Log.Information(\"Sql Server started\");\n break;\n }\n catch\n {\n Serilog.Log.Information(\"Sql Server not ready\");\n if (tryCounts > maxTryCounts)\n {\n throw new Exception(\"Sql Server cannot start.\");\n }\n }\n\n Thread.Sleep(2000);\n }\n }\n }\n}"
},
{
"path": "build/_build.csproj",
"content": "\n\n \n Exe\n net8.0\n \n CS0649;CS0169\n ..\n ..\n 1\n true\n \n\n \n \n \n \n \n\n\n"
},
{
"path": "build/_build.csproj.DotSettings",
"content": "\n\tDO_NOT_SHOW\n\tDO_NOT_SHOW\n\tDO_NOT_SHOW\n\tDO_NOT_SHOW\n\tImplicit\n\tImplicit\n\tExpressionBody\n\t0\n\tNEXT_LINE\n\tTrue\n\tFalse\n\t120\n\tIF_OWNER_IS_SINGLE_LINE\n\tWRAP_IF_LONG\n\tFalse\n\t<Policy Inspect=\"True\" Prefix=\"\" Suffix=\"\" Style=\"AaBb\" />\n\t<Policy Inspect=\"True\" Prefix=\"\" Suffix=\"\" Style=\"AaBb\" />\n\tTrue\n\tTrue\n\tTrue\n\tTrue\n\tTrue\n\tTrue\n\tTrue\n\tTrue\n\tTrue\n"
},
{
"path": "build.cmd",
"content": ":; set -eo pipefail\n:; SCRIPT_DIR=$(cd \"$( dirname \"${BASH_SOURCE[0]}\" )\" && pwd)\n:; ${SCRIPT_DIR}/build.sh \"$@\"\n:; exit $?\n\n@ECHO OFF\npowershell -ExecutionPolicy ByPass -NoProfile -File \"%~dp0build.ps1\" %*\n"
},
{
"path": "build.ps1",
"content": "[CmdletBinding()]\nParam(\n [Parameter(Position=0,Mandatory=$false,ValueFromRemainingArguments=$true)]\n [string[]]$BuildArguments\n)\n\nWrite-Output \"PowerShell $($PSVersionTable.PSEdition) version $($PSVersionTable.PSVersion)\"\n\nSet-StrictMode -Version 2.0; $ErrorActionPreference = \"Stop\"; $ConfirmPreference = \"None\"; trap { Write-Error $_ -ErrorAction Continue; exit 1 }\n$PSScriptRoot = Split-Path $MyInvocation.MyCommand.Path -Parent\n\n###########################################################################\n# CONFIGURATION\n###########################################################################\n\n$BuildProjectFile = \"$PSScriptRoot\\build\\_build.csproj\"\n$TempDirectory = \"$PSScriptRoot\\\\.nuke\\temp\"\n\n$DotNetGlobalFile = \"$PSScriptRoot\\\\global.json\"\n$DotNetInstallUrl = \"https://dot.net/v1/dotnet-install.ps1\"\n$DotNetChannel = \"Current\"\n\n$env:DOTNET_SKIP_FIRST_TIME_EXPERIENCE = 1\n$env:DOTNET_CLI_TELEMETRY_OPTOUT = 1\n$env:DOTNET_MULTILEVEL_LOOKUP = 0\n\n###########################################################################\n# EXECUTION\n###########################################################################\n\nfunction ExecSafe([scriptblock] $cmd) {\n & $cmd\n if ($LASTEXITCODE) { exit $LASTEXITCODE }\n}\n\n# If dotnet CLI is installed globally and it matches requested version, use for execution\nif ($null -ne (Get-Command \"dotnet\" -ErrorAction SilentlyContinue) -and `\n $(dotnet --version) -and $LASTEXITCODE -eq 0) {\n $env:DOTNET_EXE = (Get-Command \"dotnet\").Path\n}\nelse {\n # Download install script\n $DotNetInstallFile = \"$TempDirectory\\dotnet-install.ps1\"\n New-Item -ItemType Directory -Path $TempDirectory -Force | Out-Null\n [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12\n (New-Object System.Net.WebClient).DownloadFile($DotNetInstallUrl, $DotNetInstallFile)\n\n # If global.json exists, load expected version\n if (Test-Path $DotNetGlobalFile) {\n $DotNetGlobal = $(Get-Content $DotNetGlobalFile | Out-String | ConvertFrom-Json)\n if ($DotNetGlobal.PSObject.Properties[\"sdk\"] -and $DotNetGlobal.sdk.PSObject.Properties[\"version\"]) {\n $DotNetVersion = $DotNetGlobal.sdk.version\n }\n }\n\n # Install by channel or version\n $DotNetDirectory = \"$TempDirectory\\dotnet-win\"\n if (!(Test-Path variable:DotNetVersion)) {\n ExecSafe { & $DotNetInstallFile -InstallDir $DotNetDirectory -Channel $DotNetChannel -NoPath }\n } else {\n ExecSafe { & $DotNetInstallFile -InstallDir $DotNetDirectory -Version $DotNetVersion -NoPath }\n }\n $env:DOTNET_EXE = \"$DotNetDirectory\\dotnet.exe\"\n}\n\nWrite-Output \"Microsoft (R) .NET SDK version $(& $env:DOTNET_EXE --version)\"\n\nExecSafe { & $env:DOTNET_EXE build $BuildProjectFile /nodeReuse:false /p:UseSharedCompilation=false -nologo -clp:NoSummary --verbosity quiet }\nExecSafe { & $env:DOTNET_EXE run --project $BuildProjectFile --no-build -- $BuildArguments }\n"
},
{
"path": "build.sh",
"content": "#!/usr/bin/env bash\n\nbash --version 2>&1 | head -n 1\n\nset -eo pipefail\nSCRIPT_DIR=$(cd \"$( dirname \"${BASH_SOURCE[0]}\" )\" && pwd)\n\n###########################################################################\n# CONFIGURATION\n###########################################################################\n\nBUILD_PROJECT_FILE=\"$SCRIPT_DIR/build/_build.csproj\"\nTEMP_DIRECTORY=\"$SCRIPT_DIR//.nuke/temp\"\n\nDOTNET_GLOBAL_FILE=\"$SCRIPT_DIR//global.json\"\nDOTNET_INSTALL_URL=\"https://dot.net/v1/dotnet-install.sh\"\nDOTNET_CHANNEL=\"Current\"\n\nexport DOTNET_CLI_TELEMETRY_OPTOUT=1\nexport DOTNET_SKIP_FIRST_TIME_EXPERIENCE=1\nexport DOTNET_MULTILEVEL_LOOKUP=0\n\n###########################################################################\n# EXECUTION\n###########################################################################\n\nfunction FirstJsonValue {\n perl -nle 'print $1 if m{\"'\"$1\"'\": \"([^\"]+)\",?}' <<< \"${@:2}\"\n}\n\n# If dotnet CLI is installed globally and it matches requested version, use for execution\nif [ -x \"$(command -v dotnet)\" ] && dotnet --version &>/dev/null; then\n export DOTNET_EXE=\"$(command -v dotnet)\"\nelse\n # Download install script\n DOTNET_INSTALL_FILE=\"$TEMP_DIRECTORY/dotnet-install.sh\"\n mkdir -p \"$TEMP_DIRECTORY\"\n curl -Lsfo \"$DOTNET_INSTALL_FILE\" \"$DOTNET_INSTALL_URL\"\n chmod +x \"$DOTNET_INSTALL_FILE\"\n\n # If global.json exists, load expected version\n if [[ -f \"$DOTNET_GLOBAL_FILE\" ]]; then\n DOTNET_VERSION=$(FirstJsonValue \"version\" \"$(cat \"$DOTNET_GLOBAL_FILE\")\")\n if [[ \"$DOTNET_VERSION\" == \"\" ]]; then\n unset DOTNET_VERSION\n fi\n fi\n\n # Install by channel or version\n DOTNET_DIRECTORY=\"$TEMP_DIRECTORY/dotnet-unix\"\n if [[ -z ${DOTNET_VERSION+x} ]]; then\n \"$DOTNET_INSTALL_FILE\" --install-dir \"$DOTNET_DIRECTORY\" --channel \"$DOTNET_CHANNEL\" --no-path\n else\n \"$DOTNET_INSTALL_FILE\" --install-dir \"$DOTNET_DIRECTORY\" --version \"$DOTNET_VERSION\" --no-path\n fi\n export DOTNET_EXE=\"$DOTNET_DIRECTORY/dotnet\"\nfi\n\necho \"Microsoft (R) .NET Core SDK version $(\"$DOTNET_EXE\" --version)\"\n\n\"$DOTNET_EXE\" build \"$BUILD_PROJECT_FILE\" /nodeReuse:false /p:UseSharedCompilation=false -nologo -clp:NoSummary --verbosity quiet\n\"$DOTNET_EXE\" run --project \"$BUILD_PROJECT_FILE\" --no-build -- \"$@\"\n"
},
{
"path": "docker-compose.yml",
"content": "version: '3.4'\n\nservices:\n\n backend:\n container_name: mymeetings_backend\n build:\n context: ./src/\n ports:\n - \"5000:8080\"\n networks:\n - starfish-crm-network\n environment:\n - Meetings_MeetingsConnectionString=Server=mymeetingsdb,1433;Database=MyMeetings;User=sa;Password=Test@12345;Encrypt=False;\n depends_on:\n - migrator\n restart: on-failure\n\n mymeetingsdb:\n build: ./src/Database/\n platform: linux/amd64\n ports:\n - 1445:1433\n networks:\n - starfish-crm-network\n\n migrator:\n container_name: mymeetings_db_migrator\n build:\n context: ./src/\n dockerfile: ./Database/Dockerfile_DatabaseMigrator\n networks:\n - starfish-crm-network\n environment:\n - ASPNETCORE_MyMeetings_IntegrationTests_ConnectionString=Server=mymeetingsdb,1433;Database=MyMeetings;User=sa;Password=Test@12345;Encrypt=False;\n command:\n [\n \"./wait-for-it.sh\",\n \"mymeetingsdb:1433\",\n \"--timeout=60\",\n \"--\",\n \"/bin/bash\",\n \"/entrypoint_DatabaseMigrator.sh\"\n ]\n restart: on-failure\n\nnetworks:\n starfish-crm-network:\n"
},
{
"path": "docs/C4/c1_system_context.puml",
"content": "@startuml C1 System Context\n!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Context.puml\n\nPerson(memberPerson, \"Member\", \"Organizer of meeting groups, meetings, member of group, meeting attendee\")\nPerson(adminPerson, \"Administrator\", \"Administrator of the system\")\n\nSystem(myMeetingsSystem, \"My Meetings\")\nSystem_Ext(emailSystem, \"Email Service\")\nSystem_Ext(paymentGatewaySystem, \"Payment Gateway\")\n\nRel(memberPerson, myMeetingsSystem, \"Organize meeting groups and participate in meetings\")\nRel(adminPerson, myMeetingsSystem, \"Manage members, meeting groups, meetings\")\nRel(myMeetingsSystem, emailSystem, \"Request email send\")\nRel(emailSystem, memberPerson, \"Send email\")\nRel(emailSystem, adminPerson, \"Send email\")\nRel(myMeetingsSystem, paymentGatewaySystem, \"Delegate the payment\")\nRel(paymentGatewaySystem, myMeetingsSystem , \"Return info about payment\")\nRel(memberPerson, paymentGatewaySystem , \"Pay in\")\n\nLAYOUT_WITH_LEGEND()\n@enduml"
},
{
"path": "docs/C4/c2_container.puml",
"content": "@startuml C2 Containers\n!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Container.puml\n\nPerson(memberPerson, \"Member\", \"Organizer of meeting groups, meetings, member of group, meeting attendee\")\nPerson(adminPerson, \"Administrator\", \"Administrator of the system\")\n\nSystem_Boundary(c1, \"My Meetings System\") {\n Container(spa, \"SPA\", \"ReactJS\", \"GUI for the application\")\n Container(api, \"My Meetings API\", \".NET Core\", \"Backend\")\n ContainerDb(database, \"Database\", \"Microsoft SQL\", \"Data about meeting groups, members, meetings etc\", \"msql_server\")\n}\nSystem_Ext(emailSystem, \"Email System\", \"3rd party SMTP server\")\nSystem_Ext(paymentGateway, \"Payment Gateway\", \"3rd party payment service\")\n\nRel(memberPerson, spa, \"Uses\", \"HTTP\")\nRel(adminPerson, spa, \"Uses\", \"HTTP\")\nRel(spa, api, \"Uses\", \"HTTP\")\nRel_R(api, database, \"Reads/Writes\", \"SQL\")\nRel_L(api, emailSystem, \"Sends email using\", \"SMTP\")\nRel_D(api, paymentGateway, \"Delegate the payment\", \"HTTP\")\nRel(memberPerson, paymentGateway, \"Make payment via\", \"HTTP\")\n\nLAYOUT_WITH_LEGEND()\n\n@enduml"
},
{
"path": "docs/C4/c3_components.puml",
"content": "@startuml C3 Components\n!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Component.puml\n\nSystem_Boundary(c1, \"My Meetings System\") {\n Container(spa, \"SPA\", \"ReactJS\", \"GUI for the application\")\n \n Boundary(myMeetingsApi, \"My Meetings API\") {\n Component(api, \"API\", \".NET Core API\")\n Component(meetingsModule, \"Meetings\", \".NET Libraries\")\n Component(administrationModule, \"Administration\", \".NET Libraries\")\n Component(userAccessModule, \"User Access\", \".NET Libraries\")\n Component(paymentsModule, \"Payments\", \".NET Libraries\")\n Component(registrationsModule, \"Registrations\", \".NET Libraries\")\n ComponentQueue(eventsBus, \"Events Bus\", \"In memory\")\n \n Boundary(database, \"Database\") {\n ComponentDb(meetingsModuleData, \"Meetings data\", \"schema\")\n ComponentDb(administrationData, \"Administration data\", \"schema\")\n ComponentDb(userAccessData, \"User Access data\", \"schema\")\n ComponentDb(paymentsData, \"Payments data\", \"schema\")\n ComponentDb(registrationsData, \"Registrations data\", \"schema\")\n }\n }\n}\n\nRel(spa, api, \"Uses\", \"HTTP\")\nRel(api, meetingsModule, \"Uses\")\nRel(api, administrationModule, \"Uses\")\nRel(api, userAccessModule, \"Uses\")\nRel(api, paymentsModule, \"Uses\")\nRel(api, registrationsModule, \"Uses\")\nRel(meetingsModule, eventsBus, \"Publishes event to / subscribes\")\nRel(administrationModule, eventsBus, \"Publishes event to / subscribes\")\nRel(userAccessModule, eventsBus, \"Publishes event to / subscribes\")\nRel(paymentsModule, eventsBus, \"Publishes event to / subscribes\")\nRel(registrationsModule, eventsBus, \"Publishes event to / subscribes\")\n\nRel(meetingsModule, meetingsModuleData, \"Store / retrieve\")\nRel(administrationModule, administrationData, \"Store / retrieve\")\nRel(userAccessModule, userAccessData, \"Store / retrieve\")\nRel(paymentsModule, paymentsData, \"Store / retrieve\")\nRel(registrationsModule, registrationsData, \"Store / retrieve\")\n\nRel_R(registrationsModule, userAccessModule, \"Uses\")\n\nLAYOUT_WITH_LEGEND()\n\n@enduml"
},
{
"path": "docs/C4/c3_components_module.puml",
"content": "@startuml C3 Components Module (zoom-in)\n!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Component.puml\n\nAddComponentTag(\"meetings\", $bgColor=\"#4ce065\")\nAddComponentTag(\"administration\", $bgColor=\"#e3b868\")\nAddComponentTag(\"eventsBus\", $bgColor=\"#29118a\", $fontColor=\"#ffffff\")\n\nSystem_Boundary(c1, \"My Meetings System\") {\n Boundary(myMeetingsApi, \"My Meetings API\") {\n Component(api, \"API\", \".NET Core API\")\n \n Boundary(meetingsModule, \"Meetings Module\") {\n Component(meetingsInfrastructure, \"Meetings.Infrastructure\", \".NET Library\", $tags=\"meetings\")\n Component(meetingsApplication, \"Meetings.Application\", \".NET Library\", $tags=\"meetings\")\n Component(meetingsDomain, \"Meetings.Domain\", \".NET Library\", $tags=\"meetings\")\n Component(meetingsIntegrationEvents, \"Meetings.IntegrationEvents\", \".NET Library\", $tags=\"meetings\")\n ComponentDb(meetingsData, \"Meetings data\", \"schema\", $tags=\"meetings\")\n }\n\n Boundary(administrationModule, \"Administration Module\") {\n Component(administrationInfrastructure, \"Administration.Infrastructure\", \".NET Library\", $tags=\"administration\")\n Component(administrationApplication, \"Administration.Application\", \".NET Library\", $tags=\"administration\")\n Component(administrationDomain, \"Administration.Domain\", \".NET Library\", $tags=\"administration\")\n Component(administrationIntegrationEvents, \"Administration.IntegrationEvents\", \".NET Library\", $tags=\"administration\")\n ComponentDb(administrationData, \"Administration data\", \"schema\", $tags=\"administration\")\n }\n\n ComponentQueue(eventsBus, \"Events Bus\", \"In memory\", $tags=\"eventsBus\")\n }\n}\n\n\nRel(api, meetingsInfrastructure, \"Uses\")\nRel(api, meetingsApplication, \"Uses\")\nRel(meetingsInfrastructure, meetingsApplication, \"Uses\")\nRel(meetingsInfrastructure, meetingsDomain, \"Uses\")\nRel(meetingsApplication, meetingsDomain, \"Uses\")\nRel(meetingsApplication, meetingsIntegrationEvents, \"Uses\")\nRel(meetingsInfrastructure, meetingsData, \"Uses\")\nRel(meetingsInfrastructure, eventsBus, \"Uses\")\n\nRel(api, administrationInfrastructure, \"Uses\")\nRel(api, administrationApplication, \"Uses\")\nRel(administrationInfrastructure, administrationApplication, \"Uses\")\nRel(administrationInfrastructure, administrationDomain, \"Uses\")\nRel(administrationApplication, administrationDomain, \"Uses\")\nRel(administrationApplication, administrationIntegrationEvents, \"Uses\")\nRel(administrationInfrastructure, administrationData, \"Uses\")\nRel(administrationInfrastructure, eventsBus, \"Uses\")\n\nRel(administrationApplication, meetingsIntegrationEvents, \"Uses\")\nRel(meetingsApplication, administrationIntegrationEvents, \"Uses\")\n\n@enduml"
},
{
"path": "docs/C4/c4_class.puml",
"content": "@startuml C4 Code\n\npackage \"Meeting Groups Aggregate\" <> {\n\n class \"MeetingGroupId\" << VO >> { \n\n }\n \n class \"MeetingGroup\" << Entity, AR >> {\n -string: _description\n -DateTime: _createDate\n -DateTime: _paymentDateTo\n {static} MeetingGroup CreateBasedOnProposal()\n Meeting CreateMeeting(..)\n void SetExpirationDate(DateTime dateTo)\n void JoinToGroupMember(MemberId memberId)\n void LeaveGroup(MemberId memberId)\n void EditGeneralAttributes(...)\n bool IsMemberOfGroup(MemberId attendeeId)\n bool IsOrganizer(MemberId memberId)\n }\n\n class \"MeetingGroupLocation\" << VO >> {\n string City\n string CountryCode\n {static} MeetingGroupLocation Create(...)\n\n }\n\n class \"MeetingGroupMember\" << Entity >> {\n ~DateTime JoinedDate\n -bool _isActive\n -DateTime? _leaveDate\n {static} MeetingGroupMember CreateNew(...)\n void Leave()\n ~bool IsMember(MemberId memberId)\n ~bool IsOrganizer(MemberId memberId)\n }\n\n class \"MemberId\" << VO >> {\n\n }\n\n class \"MeetingGroupMemberRole\" << VO >> {\n string Value\n }\n}\n\nclass \"Member\" << Entity, AR >> {\n\n}\n\n\"MeetingGroup\" *-- \"MeetingGroupId\" : of\n\"MeetingGroup\" *-- \"MeetingGroupLocation\" : for\n\"MeetingGroup\" \"1\" *-- \"0..*\" \"MeetingGroupMember\" : member of\n\"MeetingGroupMember\" *-- \"MemberId\" : assigned to\n\"MeetingGroupMemberRole\" --* \"MeetingGroupMember\" : is assigned to\n\n\"Member\" o-- \"MemberId\" : of\n\n@enduml"
},
{
"path": "docs/PlantUML/Commenting_Conceptual_Model.puml",
"content": "@startuml\n\nobject \"Meeting\" as Meeting\nobject \"Member\" as Member\nobject \"Meeting Commenting Configuration\" as MeetingCommentingConfiguration\nobject \"Meeting Comment\" as MeetingComment\nobject \"Meeting Member Comment Like\" as MeetingMemberCommentLike\n\nMeeting \"1\"-->\"0..*\" MeetingComment : has\nMeetingCommentingConfiguration \"1\"-->\"1\" Meeting : enables\\ncommenting\\nof\nMeetingComment \"1\"-->\"0..*\" MeetingMemberCommentLike : has\nMeetingComment \"1\"-->\"0..*\" MeetingComment : is reply to\nMember --> Meeting : comments\nMember --> MeetingComment : replies to,\\nlikes\nMember --> MeetingCommentingConfiguration : configures\n\n@enduml"
},
{
"path": "docs/PlantUML/Conceptual_Model.puml",
"content": "@startuml\nscale max 2000 width\n\npackage \"User Access\" #f3e8f8 {\nobject Permission\nobject \"User Role\" as UserRole\nobject User\nobject \"User Registration\" as UserRegistration\nenum \"User Registration Status\" as UserRegistrationStatus\n{\n WaitingForConfirmation\n Confirmed\n Expired\n}\n\nUser \"1\"-->\"0..*\" UserRole : has\nUser --> UserRegistration : created for\nUserRole \"1..*\"-->\"1..*\" Permission : has\nUserRegistration --> UserRegistrationStatus : is in\n\n}\n\npackage \"Administration\" #ffeddb {\n\nobject Administrator\nobject \"Meeting Group Proposal\" as Administration.MeetingGroupProposal\nenum \"Meeting Group Proposal Decision\" as MeetingGroupProposalDecision\n{\n Accept\n Reject\n}\nenum \"Meeting Group Proposal Status\" as Administration.MeetingGroupProposalDecisionStatus\n{\n Accepted\n InVerification\n Rejected\n}\n\nAdministrator \"1\"-->\"0..*\" MeetingGroupProposalDecision : makes\nMeetingGroupProposalDecision --> Administration.MeetingGroupProposal : for\nAdministration.MeetingGroupProposal --> Administration.MeetingGroupProposalDecisionStatus: is in\n\n\nAdministrator --> User : is a\n\n}\n\n\npackage \"Meetings\" #e4f7e4 {\n\nobject \"Meeting\" as Meeting\nobject \"Member\" as Member\nobject \"Meeting Group Proposal\" as Meeting.MeetingGroupProposal\nobject \"Meeting Attendee\" as MeetingAttendee\nobject \"Meeting Group\" as MeetingGroup\nobject \"Meeting Not Attendee\" as MeetingNotAttendee\nobject \"Meeting Waitlist Member\" as MeetingWaitlistMember\nobject \"Meeting Location\" as MeetingLocation\nobject \"Member Subscription\" as Meeting.MemberSubscription\nenum \"Meeting Group Proposal Status\" as Meeting.MeetingGroupProposalStatus\n{\n InVerification\n Accepted\n Rejected\n}\n\nMember --> Meeting.MeetingGroupProposal : proposes\nMember \"1\"-->\"0..*\" MeetingAttendee : is a\nMember \"1\"-->\"0..*\" MeetingNotAttendee : is a\nMember \"1\"-->\"0..*\" MeetingWaitlistMember : is a\nMember --> Meeting.MemberSubscription : has\n\nMeeting \"1\"-->\"1..*\" MeetingAttendee : attendees\nMeeting \"1\"-->\"0..*\" MeetingNotAttendee : not attendees\nMeeting --> MeetingLocation : has\n\nMeeting.MeetingGroupProposal --> Meeting.MeetingGroupProposalStatus : is in\nMeetingGroup \"1\"-->\"0..*\" Meetings : organizes\nMeetingGroup \"0..1\"-->\"1\" Meeting.MeetingGroupProposal : created after acceptance of\n\nMeetingWaitlistMember \"0..*\"-->\"1\" Meeting : waits for place for\n\nMeeting.MemberSubscription --> MeetingGroup : covers\n\n\nMember --> User: is a\nMeeting.MeetingGroupProposal --> Administration.MeetingGroupProposal : sent to verification\n\n}\n\n\npackage \"Payments\" #ffc1c1 {\n\nobject \"Payer\" as Payer\nobject \"Meeting Fee\" as MeetingFee\nobject \"Meeting Fee Payment\" as MeetingFeePayment\nobject \"Subscription\" as Payments.Subscription\nobject \"Subscription Payment\" as SubscriptionPayment\nobject \"Subscription Renewal Payment\" as SubscriptionRenewalPayment\nobject \"Price List\" as PriceList\nobject \"Price List Item\" as PriceListItem\n\nenum \"Subscription Status\" as SubscriptionStatus\n{\n Active\n Expired\n}\nenum \"Subscription Payment Status\" as SubscriptionPaymentStatus\n{\n WaitingForPayment\n Paid\n Expired\n}\nenum \"Subscription Renewal Payment Status\" as SubscriptionRenewalPaymentStatus\n{\n WaitingForPayment\n Paid\n Expired\n}\nenum \"Meeting Fee Payment Status\" as MeetingFeePaymentStatus\n{\n WaitingForPayment\n Paid\n Expired\n}\nenum \"Price List Item Category\" as PriceListItemCategory\n{\n New\n Renewal\n}\nenum \"Subscription Period\" as SubscriptionPeriod\n{\n Month\n HalfYear\n}\n\n\n\nPayer \"1\"-->\"0..*\" MeetingFee : pays for\nPayer \"1\"--> \"0..*\" Payments.Subscription : buys\n\nMeetingFeePayment \"0..*\"-->\"1\" MeetingFee : for\nMeetingFeePayment --> MeetingFeePaymentStatus : is in\n\nPayments.Subscription \"1\"-->\"0..*\" SubscriptionRenewalPayment: extended by\nPayments.Subscription --> SubscriptionStatus : is in\nPayments.Subscription --> SubscriptionPeriod : is for\n\nSubscriptionPayment \"1..*\"-->\"1\" Payments.Subscription : is for\nSubscriptionPayment --> SubscriptionPaymentStatus : is in\nSubscriptionPayment --> SubscriptionPeriod : is for\n\nSubscriptionRenewalPayment --> SubscriptionRenewalPaymentStatus: is in\nSubscriptionRenewalPayment --> SubscriptionPeriod : is for\n\nPriceListItem --> SubscriptionPeriod : is for\nPriceListItem \"0..*\"-->\"1\" Country: is for\nPriceListItem --> PriceListItemCategory : is for\n\nPriceList \"1\"-->\"1..*\" PriceListItem : contains\n\n\nPayer --> Member: is a\nPayer --> User: is a\n\nPayments.Subscription -- Meeting.MemberSubscription\n}\n@enduml\n"
},
{
"path": "docs/architecture-decision-log/0001-record-architecture-decisions.md",
"content": "# 1. Record architecture decisions\n\nDate: 2019-10-28\n\n## Status\n\nAccepted\n\n## Context\n\nAs the project is an example of a more advanced monolith architecture, it is necessary to save all architectural decisions in one place.\n\n## Decision\n\nFor all architectural decisions Architecture Decision Log (ADL) is created. All decisions will be recorded as Architecture Decision Records (ADR). \n\nEach ADR will be recorded using [Michael Nygard template](http://thinkrelevance.com/blog/2011/11/15/documenting-architecture-decisions), which contains following sections: Status, Context, Decision and Consequences.\n\n## Consequences\n\nAll architectural decisions should be recorded in log. Old decisions should be recorded as well with an approximate decision date. New decisions should be recorded on a regular basis."
},
{
"path": "docs/architecture-decision-log/0002-use_modular-monolith-system-architecture.md",
"content": "# 2. Use Modular Monolith System Architecture\n\nDate: 2019-07-01\n\nLog date: 2019-10-28\n\n## Status\n\nAccepted\n\n## Context\n\nAn advanced example of Modular Monolith architecture and tactical DDD implementation in .NET is missing on the internet.\n\n## Decision\n\nI decided to create nontrivial application using Modular Monolith architecture and Domain-Driven Design tactical patterns.\n\n## Consequences\n\n- All modules must run in one single process as single application (Monolith)\n- All modules should have maximum autonomy (Modular)\n- DDD Bounded Contexts will be used to divide monolith into modules\n- DDD tactical patterns will be used to implement most of modules"
},
{
"path": "docs/architecture-decision-log/0003-use_dotnetcore_and_csharp.md",
"content": "# 3. Use .NET Core and C# language\n\nDate: 2019-07-01\n\nLog date: 2019-10-28\n\n## Status\n\nAccepted\n\n## Context\n\nAs it is monolith, only one language (or platform) must be selected for implementation.\n\n## Decision\n\nI decided to use:\n\n- .NET Core platform - it is new generation multi-platform, fully supported by Microsoft and open-source community, optimized and designed to replace old .NET Framework\n- C# language - most popuplar language in .NET ecosystem, I have 12 years commercial experience\n- F# will not be used, I don't have commercial experience with it\n\n## Consequences\n\n- Whole application will be implemented in C# object-oriented language in .NET Core framework\n- .NET Core applications can be executed on Windows, MacOS, Linux"
},
{
"path": "docs/architecture-decision-log/0004-divide-the-system-into-4-modules.md",
"content": "# 4. Divide the system into 4 modules \n\nDate: 2019-07-01\n\nLog date: 2019-11-02\n\n## Status\n\nAccepted\n\n## Context\n\nThe MyMeetings domain contains 4 main subdomains: Meetings (core domain), Administration (supporting subdomain), Payments (supporting subdomain) and User Access (generic domain).\n\nWe use Modular Monolith architecture so we need to implement one application which solves all requirements from all domains listed above.\n\nWe need to modularize our system.\n\n## Possible solutions\n1. Create one \"MyMeetings\" module and divide it into sub-modules. This solution is simpler to implement at the beginning. We do not have to set module boundaries and think how to communicate between them. On the other hand, this causes a lack of autonomy and can lead to Big Ball Of Mud anti-pattern.\n2. Create 4 modules based on Bounded Contexts which in this scenario maps 1:1 to domains. This solution is more difficult at the beginning. We need to set modules boundaries, communication strategy between modules and have more advanced infrastructure code. It is a more complex solution. On the other hand, it supports autonomy, maintainability, readability. We can develop our Domain Models in all of the Bounded Contexts independently.\n\n## Decision\n\nSolution 2.\n\nWe created 4 modules: Meetings, Administration, Payments, User Access. The key factor here is module autonomy and maintainability. We want to develop each module independently. This is more cleaner solution. It involves more work at the beginning but we want to invest.\n\n## Consequences\n- We can implement each module/Bounded Context independently.\n- We need to set clear boundaries between modules and communication strategy between modules (and implement them)\n- We need to define the API of each module\n- The API/GUI layer needs to know about all of the modules\n- We need to create shared libraries/classes to limit boilerplate code which will be the same in all modules\n- Complexity of the whole solution will increase\n- Complexity of each module will decrease\n- We will have clear separation of concerns\n- In addition to the application, we must divide the data\n- We will have business concepts modeled in a proper way - without \"godclasses\" which do everything\n- We can delegate development of particular module to defined team, work should be done without any conflicts on codebase"
},
{
"path": "docs/architecture-decision-log/0005-create-one-rest-api-module.md",
"content": "# 5. Create one REST API module\n\nDate: 2019-07-01\n\nLog date: 2019-11-04\n\n## Status\n\nAccepted\n\n## Context\n\nWe need to expose the API of our application to the outside world. For now, we expect one client of our application - FrontEnd SPA application.\n\n## Possible solutions\n1. Create one .NET Core MVC host application which contains all endpoints. This host application will have references to all business modules and communicates with them directly:\n\nHost/API references:\nAdministration module\nMeetings module\nPayments module\nUser Access module\n\n2. Create one .NET Core MVC host application and multiple APIs projects per module. Each API project should have endpoints which are handled by particular business module: \n\nHost references:\nAdministration API references Administration module\nMeetings API references Meetings module\nPayments API references Payments module\nUser Access API references User Access module\n\n## Decision\n\nSolution 1.\n\nCreating separate API projects for each module will add complexity and little value. Grouping endpoints for a particular business module in a special directory is enough. Another layer on top of the module is unnecessary.\n\n## Consequences\n- We will have only one API layer/module\n- Each controller has responsibility to delegate Command/Query processing to appropriate module\n- We don't need to scan other projects than host for controllers, routes and other MVC mechanisms\n- API configuration is easier\n- Overall complexity of API layer is lower\n- Complexity of each controller is a little bit higher\n- Build time will be shorter (less projects)"
},
{
"path": "docs/architecture-decision-log/0006-create-facade-between-api-and-business-module.md",
"content": "# 6. Create façade between API and business module\n\nDate: 2019-07-01\n\nLog date: 2019-11-04\n\n## Status\n\nAccepted\n\n## Context\n\nOur API layer should communicate with business modules to fulfill client requests. To support the maximum level of autonomy, each module should expose a minimal set of operations (the module API/contract/interface).\n\n## Decision\n\nEach module will provide implementation for one interface with 3 methods:\n\n```csharp\nTask ExecuteCommandAsync(ICommand command);\n\nTask ExecuteCommandAsync(ICommand command);\n\nTask ExecuteQueryAsync(IQuery query);\n```\n\nThis interface will act as a façade (Façade pattern) between API and module. Only Commands, Queries and returned objects (which are part of this interface) should be visible to the API. Everything else should be hidden behind the façade (module encapsulation).\n\n## Consequences\n- API can communicate with the module only by façade (the interface).\n- Implementation of API is simpler\n- We can change module implementation and API does not require change if the interface is not changed\n- We need to focus on module encapsulation, sometimes it involves additional work (like instantiation using internal constructors)"
},
{
"path": "docs/architecture-decision-log/0007-use-cqrs-architectural-style.md",
"content": "# 7. Use CQRS architectural style\n\nDate: 2019-07-01\n\nLog date: 2019-11-04\n\n## Status\n\nAccepted\n\n## Context\n\nOur application should handle 2 types of requests - reading and writing. \n\nFor now, it looks like:\n\n- for reading, we need data model in relational form to return data in tabular/flattened way (tables, lists, dictionaries).\n- for writing, we need to have a graph of objects to perform more sophisticated work like validations, business rules checks, calculations.\n\n## Decision\n\nWe applied the CQRS architectural style/pattern for each business module. Each module will have a separate model for reading and writing. For now, it will be the simplest CQRS implementation when the read model is immediate consistent. This kind of separation is useful even in simple modules like User Access.\n\n## Consequences\n- Façade method of each module should take as parameter only Command or Query object\n- We have optimized models for writes and reads (SRP principle).\n- We can process Commands and Queries in different ways\n- As Command or Query is an object, we can easily serialize them and save/log them."
},
{
"path": "docs/architecture-decision-log/0008-allow-return-result-after-command-processing.md",
"content": "# 8. Allow return result after command processing\n\nDate: 2019-07-01\n\nLog date: 2019-11-04\n\n## Status\n\nAccepted\n\n## Context\n\nThe theory of the CQRS and the CQS principle says that we should not return any information as the result of Command processing. The result should be always \"void\". However, sometimes we need to return some data immediately as part of the same request.\n\n## Decision\n\nWe decided to allow in some cases return results after command processing. Especially, when we create something and we need to return the ID of created object or don't know if request is Command or Query (like Authentication).\n\n## Consequences\n- We will have two definitions of Commands and CommandHandlers - with and without result\n- It will add some complexity to processing commands (like implementation of decorators)\n- We can immediately return the ID of created object/resource. We don't need a second call (query) to retrieve this ID.\n- We should be careful to not overuse this approach (sticking as much as possible to the CQRS)"
},
{
"path": "docs/architecture-decision-log/0009-use-2-layered-architectural-style-for-reads.md",
"content": "# 9. Use 2 layered architectural style for reads\n\nDate: 2019-07-01\n\nLog date: 2019-11-04\n\n## Status\n\nAccepted\n\n## Context\n\nWe applied the CQRS style (see [ADR 7. Use CQRS architectural style](007-use-cqrs-architectural-style.md)), now we need to decide how to handle reading (querying) requests.\n\n## Decision\n\nWe will use 2 layered architecture to handle queries: API layer and Application Service layer. As we applied the CQRS and created a separated read model, querying should be straightforward so 2 layers are enough. The API layer is responsible for Query creation based on HTTP request and the module Application layer is responsible for query handling.\n\n## Consequences\n- Whole query handling logic is in Application Service layer\n- Application Service layer is coupled to the database and querying framework\n- Solution is simple, easy to understand\n- We don't abstract over database\n- Performance is better (no object mapping between layers, querying database almost immediately)"
},
{
"path": "docs/architecture-decision-log/0010-use-clean-architecture-for-writes.md",
"content": "# 10. Use Clean Architecture for writes\n\nDate: 2019-07-01\n\nLog date: 2019-11-05\n\n## Status\n\nAccepted\n\n## Context\n\nWe applied the CQRS style (see [ADR #7](0007-use-cqrs-architectural-style.md)), now we need to decide how to handle writing operations (Commands).\n\n## Decision\n\nWe will use **Clean Architecture** to handle commands with 4 layers: **API layer**, **Application Service layer**, **Infrastructure layer** and **Domain layer**. \nWe need to add Domain layer because domain logic will be complex and we want to isolate this logic from other stuff like infrastructure or API. Isolation of domain logic supports testing, maintainability and readability.\n\n## Consequences\n- Complexity of the whole solution is higher - we need to add two more layers - domain and infrastructure\n- Complexity of implementation of business logic will be smaller - we can focus only on business concerns on this layer\n- Complexity of implementation of infrastructure will be smaller - we can focus only on infrastructure concerns on this layer\n- Business logic will be testable (no references to other layers)\n- Business logic will be independent of persistence (to some level)\n- In the Domain layer, we will have the same level of abstraction (close to business)\n- Application layer will have louse coupling to the Domain layer and Infrastructure layer (depend on abstractions only)\n- We use one of the most popular application architecture - developers are familiar with it\n"
},
{
"path": "docs/architecture-decision-log/0011-create-rich-domain-models.md",
"content": "# 11. Create rich Domain Models\n\nDate: 2019-07-01\n\nLog date: 2019-11-05\n\n## Status\n\nAccepted\n\n## Context\n\nWe need to create Domain Models for all of the modules. Each Domain Model should represent a solution that solves a particular set of Domain problems (implements business logic).\n\n## Possible solutions\n1. Create Anemic Domain Model (Data Model) and implement *Transaction Script* pattern together with *Active Record* pattern\n2. Put all business logic to database in stored procedures\n3. Create a Rich Domain Model\n\n## Decision\n\nSolution number 3 - Rich Domain Model\n\n1 - no, because the procedural style of coding will not be enough. We want to focus on behavior, not on the data.\n2 - no, keeping business logic in the database is not a good idea in that case, object-oriented programming is better than T-SQL to model our domain and we don't have performance architectural drivers to resign from OOD.\n\nWe expect complex business logic with different rules, calculations and processing so we want to get as much as possible from Object-Oriented Design principles like abstraction, encapsulation, polymorphism. We want to mutate the state of our objects only through methods (abstraction) to encapsulate all logic and hide implementation details from the client (the Application Service Layer and Unit Tests).\n\n## Consequences\n- All objects should be encapsulated (private by default principle) \n- Encapsulation of objects implies more work in infrastructure (mapping to private fields, collections is harder)\n- Encapsulation of objects decreases to some level testability of these objects (Object-Oriented Design vs Testable Design)\n- All public methods of domain objects create Domain Model API\n- Implementation details of business logic are hidden\n- Clients of Domain Model are easier to implement\n- Better object-oriented programming skills are required to implement Rich Domain Model\n- Is easier to protect business rules/invariants using Rich Domain Model"
},
{
"path": "docs/architecture-decision-log/0012-use-domain-driven-design-tactical-patterns.md",
"content": "# 12. Use Domain-Driven Design tactical patterns\n\nDate: 2019-07-01\n\nLog date: 2019-11-05\n\n## Status\n\nAccepted\n\n## Context\n\nWe decided to use the Clean Architecture ([ADR #10](0010-use-clean-architecture-for-writes.md)) and create Rich Domain Models ([ADR #11](0011-create-rich-domain-models.md)) for each module. We need to define or use some construction elements / building blocks to implement our architecture and business logic.\n\n## Decision\n\nWe decided to use **Domain-Driven Design** tactical patterns. They focus on the Domain Model implementation. Especially we will use the following building blocks:\n\n- Command - public method on Aggregate (behavior)\n- Domain Event - the immutable class which represents important fact occurred on a special point of time (behavior)\n- Entity - class with identity (identity cannot change) with mutable attributes which represents concept from domain\n- Value Object - immutable class without an identity which represents concept from domain\n- Aggregate - cluster of domain objects (Entities, Value Objects) with one class entry point (Entity as Aggregate Root) which defines the boundary of transaction/consistency and protects business rules and invariants\n- Repository - collection-like abstraction to persist and load particular Aggregate\n- Domain Service - stateless service to execute some business logic which does not belong to any of Entity/Value Object\n\n## Consequences\n- We need to define entities and value objects\n- We need to define aggregates boundaries\n- We need to add repositories for each aggregate\n- We can invoke only public methods on Aggregate Roots, everything else should be hidden\n- Developers need to be familiar with DDD tactical patterns"
},
{
"path": "docs/architecture-decision-log/0013-protect-business-invariants-using-exceptions.md",
"content": "# 13. Protect business invariants using exceptions\n\nDate: 2019-07-01\n\nLog date: 2019-11-05\n\n## Status\n\nAccepted\n\n## Context\n\nAggregates should check business invariants. When the invariant is broken, we should stop processing and return an error immediately to the client.\n\n## Possible solutions\n\n### 1. Use exceptions\n#### Pros\n- we can stop processing immediately (fail-fast)\n- popular approach in C# \n- we don't need to check the result of each method (if-else statements)\n- we can catch all Business Exceptions in one place and translate them (for example in the API layer to some HTTP response code). \n#### Cons\n- indirection \n- little performance impact \n- for special cases, we need to add a specific catch.\n### 2. Return Result object\n#### Pros \n- no indirection\n- no performance impact\n- signature method is more descriptive. \n### Cons \n- we need to add checks result of each method (if-else statements)\n- approach is less-known in the C# world \n- it needs a library or more coding to support Results\n\n## Decision\n\nSolution number 1 - Use exceptions. \n\nPerformance cost of throwing an exception is irrelevant, we don't want too many if/else statements in entities, more familiar with exceptions approach.\n\n## Consequences\n- We need to add special *BusinessException* class to separate business rules validation exceptions from other exceptions\n- We need to create different business exceptions for each business rule\n- We will have a small performance impact (throwing exceptions)\n- We will have generic mechanism which catches *BusinessException*\n- We will not have a lot of if/else statements in Entities/Value Objects to check method results\n- Some monitoring tools logs automatically each exception. If we want to use one of this tool we should be aware of this and figure it out proper solution"
},
{
"path": "docs/architecture-decision-log/0014-event-driven-communication-between-modules.md",
"content": "# 14. Event-driven communication between modules\n\nDate: 2019-07-15\n\nLog date: 2019-11-09\n\n## Status\n\nAccepted\n\n## Context\n\nEach module should be autonomous. However, communication between them must take place. We have to decide what will be the preferred way of communication and integration between modules.\n\n## Possible solutions\n\n### 1. Direct method call (synchronous)\n\nEach Module will expose a set of methods (interface, module API) which can be called by other modules directly.\n\n#### Pros\n- easier implementation\n- no indirection\n- more natural in the monolith architecture\n- supports immediate consistency\n#### Cons\n- less autonomy\n- strong coupling between modules\n- direct method call is blocking\n- module has a dependency on another module\n\n### 2. Event-driven (asynchronous)\n\nEach module will publish a specific set of events. Other modules can subscribe to specific events. It is the implementation of _Publish/Subscribe_ pattern.\n\n#### Pros\n- more autonomy\n- coupling is only to middleware/broker of events\n- no blocking communication\n- stronger modules boundaries\n- module does not have a dependency on another module\n#### Cons\n- indirection\n- more complex solution\n- middleware/broker is needed\n- does not support immediate consistency\n\n## Decision\n\nSolution number 2 - Event-driven (asynchronous)\n\nWe want to achieve the maximum level of autonomy and loose coupling between modules. Moreover, we don't want dependencies between modules. We allow direct calls in the future, but this should be an exception, not a rule.\n\n## Consequences\n- We need to implement the Publish/Subscribe pattern\n- Solution will be more complex\n- Modules will have more autonomy\n- Modules will have coupling to broker/middleware\n- During modules integration, eventual consistency will occur (asynchronous communication)\n- Events become Published Language of our Bounded Contexts (modules)\n- Events structure should be stable as much as possible"
},
{
"path": "docs/architecture-decision-log/0015-use-in-memory-events-bus.md",
"content": "# 15. Use In-Memory Events Bus\n\nDate: 2019-07-15\n\nLog date: 2019-11-09\n\n## Status\n\nAccepted\n\n## Context\n\nAs we want to base inter-modular communication on asynchronous communication in the form of event-driven architecture, we need some \"events bus\" to do that.\n\n## Possible solutions\n\n### 1. In Memory Events Bus\n\nIn memory Publish/Subscribe implementation without any external component.\n\n#### Pros\n- very easy to implement\n- no network communication needed\n- performance (it depends)\n- no need to learn anything\n- simple solution\n#### Cons\n- does not support more advanced integration scenarios, everything needs to be implemented\n- does not have configuration\n- does not have other features (who have messaging brokers)\n\n### 2. Message Broker\n\nExternal middleware component. It could be a low-level broker (like RabbitMQ) or a high-level broker (like MassTransit, NServiceBus). \n\n#### Pros\n- only integration with platform code needed\n- more advanced integration scenarios\n- richness of configuration\n- a lot of features\n#### Cons\n- complex solution\n- network communication\n- new platform learning needed\n- performance (it depends)\n\n## Decision\n\nSolution number 1 - In Memory Events Bus\n\nAt that moment we don't see more advanced integration scenarios in our system than simple publish/subscribe scenario. We decided to follow the simplest scenario and if it will be necessary - move to more advanced.\n\n## Consequences\n- We need to implement Publish/Subscribe in memory\n- All modules will have dependency to In Memory Events Bus to publish events/subscribe to events\n- if we ever want to separate a module to another process (microservices architecture), we will need to switch to middleware"
},
{
"path": "docs/architecture-decision-log/0016-create-ioc-container-per-module.md",
"content": "# 16. Create an IoC Container per module\n\nDate: 2019-07-15\n\nLog date: 2019-11-09\n\n## Status\n\nAccepted\n\n## Context\n\nFor each module, when we process particular Command or Query, we need to resolve a graph of objects. We need to decide how dependencies of objects will be resolved.\n\n## Possible solutions\n\n### 1. One IoC Container for whole application\n\nOne IoC container located in the host project.\n\n#### Pros\n- standard approach\n- dependencies configured in one place\n#### Cons\n- couples host application with all of projects, libraries\n- modules autonomy decreases\n- strong coupling\n\n### 2. IoC Container per module\n\nMultiple IoC containers per modules.\n\n#### Pros\n- module autonomy\n- loose coupling \n- host application has dependency only to Application Service Layer\n#### Cons\n- duplicated code\n- non-standard approach\n\n## Decision\n\nSolution number 2 - IoC Container per module\n\nIoC Container per module supports the autonomy of the module and louse coupling so this is a more important aspect for us than duplicated code in some places.\n\n## Consequences\n- Create and maintain an IoC Container for each module\n- Implementation is not standard, but still acceptable easy\n- We can add dependencies to module and other modules are intact"
},
{
"path": "docs/architecture-decision-log/0017-implement-archictecture-tests.md",
"content": "# 17. Implement Architecture Tests\n\nDate: 2019-11-16\n\n## Status\n\nAccepted\n\n## Context\n\nIn some cases it is not possible to enforce the application architecture, design or established conventions using compiler (compile-time). For this reason, code implementations can diverge from the original design and architecture. We want to minimize this behavior, not only by code review.\n\n## Decision\n\nWe decided to implement Unit Tests for our architecture. \nWe will implement tests for each module separately and one tests library for general architecture. We will use _NetArchTest_ library which was created exactly for this purpose.\n\n## Consequences\n- We will have quick feedback about breaking the design rules\n- Unit tests for architecture are documenting our architecture to some level\n- We will have dependency to external library\n- We need to implement some _\"reflection-based\"_ code to check some rules, because library does not provide everything what we need\n- This kind of tests are a bit slower than normal unit tests (because of reflection)\n- More tests to maintain"
},
{
"path": "docs/catalog-of-terms/Aggregate-DDD/README.md",
"content": "# Aggregate (DDD)\n\n## Definition\n\n*Cluster ENTITES and VALUE OBJECTS into AGGREGATES and define boundaries around each. Choose one ENTITY to be the root of each AGGREGATE, and control all access to the objects inside the boundary through the root. Transient references to internal members can be passed out for use within a single operation only. Because the root controls access, it cannot be blindsided by changes to the internals. This arrangement makes it practical to enforce all invariants for objects in the AGGREGATE and for the AGGREGATE as a whole in any state change.*\n\nSource: [Domain-Driven Design: Tackling Complexity in the Heart of Software, Eric Evans](https://www.amazon.com/Domain-Driven-Design-Tackling-Complexity-Software/dp/0321125215)\n\n## Example\n\n### Model\n\n\n\n### Code\n\n```csharp\n\npublic class MeetingGroup : Entity, IAggregateRoot\n{\n public MeetingGroupId Id { get; private set; }\n\n private string _name;\n\n private string _description;\n\n private MeetingGroupLocation _location;\n\n private MemberId _creatorId;\n\n private List _members;\n\n private DateTime _createDate;\n\n private DateTime? _paymentDateTo;\n\n internal static MeetingGroup CreateBasedOnProposal(\n MeetingGroupProposalId meetingGroupProposalId,\n string name,\n string description,\n MeetingGroupLocation location,\n MemberId creatorId)\n {\n return new MeetingGroup(meetingGroupProposalId, name, description, location, creatorId);\n }\n\n private MeetingGroup()\n {\n // Only for EF.\n }\n\n private MeetingGroup(MeetingGroupProposalId meetingGroupProposalId, string name, string description, MeetingGroupLocation location, MemberId creatorId)\n {\n this.Id = new MeetingGroupId(meetingGroupProposalId.Value);\n this._name = name;\n this._description = description;\n this._creatorId = creatorId;\n this._location = location;\n this._createDate = SystemClock.Now;\n\n this.AddDomainEvent(new MeetingGroupCreatedDomainEvent(this.Id, creatorId));\n\n this._members = new List();\n this._members.Add(MeetingGroupMember.CreateNew(this.Id, this._creatorId, MeetingGroupMemberRole.Organizer));\n }\n\n public void EditGeneralAttributes(string name, string description, MeetingGroupLocation location)\n {\n this._name = name;\n this._description = description;\n this._location = location;\n\n this.AddDomainEvent(new MeetingGroupGeneralAttributesEditedDomainEvent(this._name, this._description, this._location));\n }\n\n public void JoinToGroupMember(MemberId memberId)\n {\n this.CheckRule(new MeetingGroupMemberCannotBeAddedTwiceRule(_members, memberId));\n\n this._members.Add(MeetingGroupMember.CreateNew(this.Id, memberId, MeetingGroupMemberRole.Member));\n }\n\n public void LeaveGroup(MemberId memberId)\n {\n this.CheckRule(new NotActualGroupMemberCannotLeaveGroupRule(_members, memberId));\n\n var member = this._members.Single(x => x.IsMember(memberId));\n\n member.Leave();\n }\n\n public void SetExpirationDate(DateTime dateTo)\n {\n _paymentDateTo = dateTo;\n\n this.AddDomainEvent(new MeetingGroupPaymentInfoUpdatedDomainEvent(this.Id, _paymentDateTo.Value));\n }\n\n public Meeting CreateMeeting(\n string title,\n MeetingTerm term,\n string description,\n MeetingLocation location,\n int? attendeesLimit,\n int guestsLimit,\n Term rsvpTerm,\n MoneyValue eventFee,\n List hostsMembersIds,\n MemberId creatorId)\n {\n this.CheckRule(new MeetingCanBeOrganizedOnlyByPayedGroupRule(_paymentDateTo));\n\n this.CheckRule(new MeetingHostMustBeAMeetingGroupMemberRule(creatorId, hostsMembersIds, _members));\n\n return Meeting.CreateNew(\n this.Id,\n title,\n term,\n description,\n location,\n MeetingLimits.Create(attendeesLimit, guestsLimit),\n rsvpTerm,\n eventFee,\n hostsMembersIds,\n creatorId);\n }\n\n internal bool IsMemberOfGroup(MemberId attendeeId)\n {\n return _members.Any(x => x.IsMember(attendeeId));\n }\n\n internal bool IsOrganizer(MemberId memberId)\n {\n return _members.Any(x => x.IsOrganizer(memberId));\n }\n}\n\n```\n\n### Description\n\nClasses `MeetingGroup`, `MeetingGroupLocation`, `MeetingGroupId`, `MeetingGroupMember', 'MeetingGroupMemberRole` form the **Aggregate**. `MeetingGroup` acts as the **AggregateRoot** (*Choose one ENTITY to be the root of each AGGREGATE*). AggregateRoot has a global identifier (`Id`) and public methods to change state of the *Aggregate*. The rest is encapsulated (*Because the root controls access, it cannot be blindsided by changes to the internals*). For each public method, the invariants are checked first (`CheckRule`) (*This arrangement makes it practical to enforce all invariants for objects in the AGGREGATE and for the AGGREGATE as a whole in any state change*).\n\n## Additional References\n\n- [DDD_Aggregate (Martin Fowler)](https://martinfowler.com/bliki/DDD_Aggregate.html)"
},
{
"path": "docs/catalog-of-terms/Aggregate-DDD/aggregate-ddd.puml",
"content": "@startuml Aggregate\n\npackage \"Meeting Groups Aggregate\" <> {\n\n class \"MeetingGroupId\" << VO >> { \n\n }\n \n class \"MeetingGroup\" << Entity, AR >> {\n -string: _description\n -DateTime: _createDate\n -DateTime: _paymentDateTo\n {static} MeetingGroup CreateBasedOnProposal()\n Meeting CreateMeeting(..)\n void SetExpirationDate(DateTime dateTo)\n void JoinToGroupMember(MemberId memberId)\n void LeaveGroup(MemberId memberId)\n void EditGeneralAttributes(...)\n bool IsMemberOfGroup(MemberId attendeeId)\n bool IsOrganizer(MemberId memberId)\n }\n\n class \"MeetingGroupLocation\" << VO >> {\n string City\n string CountryCode\n {static} MeetingGroupLocation Create(...)\n\n }\n\n class \"MeetingGroupMember\" << Entity >> {\n ~DateTime JoinedDate\n -bool _isActive\n -DateTime? _leaveDate\n {static} MeetingGroupMember CreateNew(...)\n void Leave()\n ~bool IsMember(MemberId memberId)\n ~bool IsOrganizer(MemberId memberId)\n }\n\n class \"MemberId\" << VO >> {\n\n }\n\n class \"MeetingGroupMemberRole\" << VO >> {\n string Value\n }\n}\n\nclass \"Member\" << Entity, AR >> {\n\n}\n\n\"MeetingGroup\" *-- \"MeetingGroupId\" : of\n\"MeetingGroup\" *-- \"MeetingGroupLocation\" : for\n\"MeetingGroup\" \"1\" *-- \"0..*\" \"MeetingGroupMember\" : member of\n\"MeetingGroupMember\" *-- \"MemberId\" : assigned to\n\"MeetingGroupMemberRole\" --* \"MeetingGroupMember\" : is assigned to\n\n\"Member\" o-- \"MemberId\" : of\n\n@enduml"
},
{
"path": "docs/catalog-of-terms/Command/README.md",
"content": "# Command\n\n## Definition\n\n*A command is a request made to do something. A command represents the intention of a system’s user regarding what the system will do to change its state.*\n\n*Command characteristics:*\n\n- *The result of a command can be either success or failure; the result is an [Event(s)](../Event/)*\n\n- *In case of success, state change(s) must have occurred somewhere (otherwise nothing happened)*\n\n- *Commands should be named with a verb, in the present tense or infinitive, and a nominal group coming from the domain (entity of aggregate type)*\n\nSource: [Open Agile Architecture](https://pubs.opengroup.org/architecture/o-aa-standard/#KLP-EDA-event-command)\n\n\n## Example\n\n### Model\n\n### Code\n\n`Meeting` class in [Domain Model](../Domain-Model/):\n\n```csharp\n\npublic void Cancel(MemberId cancelMemberId)\n{\n this.CheckRule(new MeetingCannotBeChangedAfterStartRule(_term));\n\n if (!_isCanceled)\n {\n _isCanceled = true;\n _cancelDate = SystemClock.Now;\n _cancelMemberId = cancelMemberId;\n\n this.AddDomainEvent(new MeetingCanceledDomainEvent(this.Id, _cancelMemberId, _cancelDate.Value));\n }\n}\n\n```\n\n`CancelMeetingCommand` class in [Application Layer](../Application-Layer/)\n\n```csharp\n\npublic class CancelMeetingCommand : CommandBase\n{\n public CancelMeetingCommand(Guid meetingId)\n {\n MeetingId = meetingId;\n }\n\n public Guid MeetingId { get; }\n}\n\ninternal class CancelMeetingCommandHandler : ICommandHandler\n{\n private readonly IMeetingRepository _meetingRepository;\n private readonly IMemberContext _memberContext;\n\n internal CancelMeetingCommandHandler(IMeetingRepository meetingRepository, IMemberContext memberContext)\n {\n _meetingRepository = meetingRepository;\n _memberContext = memberContext;\n }\n\n public async Task Handle(CancelMeetingCommand request, CancellationToken cancellationToken)\n {\n var meeting = await _meetingRepository.GetByIdAsync(new MeetingId(request.MeetingId));\n\n meeting.Cancel(_memberContext.MemberId);\n\n return Unit.Value;\n }\n}\n\n```\n\n### Description\n\nIn the example above, we can distinguish between 2 types of Commands:\n- as an object in the application layer [Parameter Object Pattern](../Parameter-Object-Pattern/)\n- in the form of a method on the object (in DDD on the [Aggregate](../Aggregate-DDD/)\n\nThe most important thing is that the Command can be rejected until the state changes. In both the `CommandHandler` (invalid MeetingId) and the `Cancel` method (business rule broken), an exception can be thrown and the Command is then rejected and all uncomitted changes are rolled back (state does not change). "
},
{
"path": "docs/catalog-of-terms/Command/command.puml",
"content": "@startuml Command\n\nclass CancelMeetingCommand {\n MeetingGroupId: Id\n}\n\nnote top of CancelMeetingCommand : Command as part of Application Layer\n\nclass Meeting {\n void Cancel(MemberId cancelMemberId)\n}\n\nnote top of Meeting : Command defined in Domain Model (on an Aggregate)\n\n@enduml"
},
{
"path": "docs/catalog-of-terms/Decorator-Pattern/README.md",
"content": "# Decorator Pattern\n\n## Definition\n\n*In object-oriented programming, the decorator pattern is a design pattern that allows behavior to be added to an individual object, dynamically, without affecting the behavior of other objects from the same class. The decorator pattern is often useful for adhering to the [Single Responsibility Principle](../Single-Responsibility-Principle/), as it allows functionality to be divided between classes with unique areas of concern.*\n\nSource: [Wikipedia](https://en.wikipedia.org/wiki/Decorator_pattern)\n\n\n## Example\n\n### Model\n\n\n\n### Code\n\n```csharp\n\ninternal class LoggingCommandHandlerDecorator : ICommandHandler where T:ICommand\n{\n private readonly ILogger _logger;\n private readonly IExecutionContextAccessor _executionContextAccessor;\n private readonly ICommandHandler _decorated;\n\n public LoggingCommandHandlerDecorator(\n ILogger logger,\n IExecutionContextAccessor executionContextAccessor,\n ICommandHandler decorated)\n {\n _logger = logger;\n _executionContextAccessor = executionContextAccessor;\n _decorated = decorated;\n }\n public async Task Handle(T command, CancellationToken cancellationToken)\n {\n if (command is IRecurringCommand)\n {\n return await _decorated.Handle(command, cancellationToken);\n }\n using (\n LogContext.Push(\n new RequestLogEnricher(_executionContextAccessor),\n new CommandLogEnricher(command)))\n {\n try\n {\n this._logger.Information(\n \"Executing command {Command}\",\n command.GetType().Name);\n\n var result = await _decorated.Handle(command, cancellationToken);\n\n this._logger.Information(\"Command {Command} processed successful\", command.GetType().Name);\n\n return result;\n }\n catch (Exception exception)\n {\n this._logger.Error(exception, \"Command {Command} processing failed\", command.GetType().Name);\n throw;\n }\n }\n }\n\n private class CommandLogEnricher : ILogEventEnricher\n {\n private readonly ICommand _command;\n\n public CommandLogEnricher(ICommand command)\n {\n _command = command;\n }\n public void Enrich(LogEvent logEvent, ILogEventPropertyFactory propertyFactory)\n {\n logEvent.AddOrUpdateProperty(new LogEventProperty(\"Context\", new ScalarValue($\"Command:{_command.Id.ToString()}\")));\n }\n }\n\n private class RequestLogEnricher : ILogEventEnricher\n {\n private readonly IExecutionContextAccessor _executionContextAccessor;\n public RequestLogEnricher(IExecutionContextAccessor executionContextAccessor)\n {\n _executionContextAccessor = executionContextAccessor;\n }\n public void Enrich(LogEvent logEvent, ILogEventPropertyFactory propertyFactory)\n {\n if (_executionContextAccessor.IsAvailable)\n {\n logEvent.AddOrUpdateProperty(new LogEventProperty(\"CorrelationId\", new ScalarValue(_executionContextAccessor.CorrelationId)));\n }\n }\n }\n}\n\n```\n### Description\n\nThe Logging decorator logs execution, arguments and processing of each Command. This way each log inside a processor has the log context of the processing command.\n\nA unique trade of a decorator is that it does both:\n* It implements `ICommandHandler` (known also as the *component*).\n* It accepts an implementation of `ICommandHandler` (known also as the *concrete component*). Usually that is done via [Dependency Injection](../Dependency-Injection/).\n\nThe decorator builds on top of existing functionality provided by the injected `ICommandHandler`, but it does not change the behavior of it.\n\n---\n\nDecorator should not be confused with [Strategy](../Strategy-Pattern/)!!!\n*A decorator lets you change the skin of an object, while Strategy lets you change the guts.*"
},
{
"path": "docs/catalog-of-terms/Decorator-Pattern/decorator-pattern.puml",
"content": "@startuml\nclass MeetingsController {\n +AddMeetingAttendee()\n +RemoveMeetingAttendee()\n}\n\nclass AddMeetingAttendeeCommand\nclass RemoveMeetingAttendeeCommand\n\nclass Mediator {\n +Send()\n}\n\ninterface ICommandHandler {\n +Handle(TCommand, CancellationToken)\n}\n\n~class AddMeetingAttendeeCommandHandler {\n +Handle(AddMeetingAttendeeCommand, CancellationToken)\n}\n\n~class RemoveMeetingAttendeeCommandHandler {\n +Handle(RemoveMeetingAttendeeCommand, CancellationToken)\n}\n\n~class LoggingCommandHandlerDecorator {\n +Handle(T, CancellationToken)\n -Log() \n}\n\nnote left of LoggingCommandHandlerDecorator::Log\n Performs logging, but doesn't\n change how Handle operates\nend note\n\nhide empty members\n\nMeetingsController -down-> Mediator: informs\nMeetingsController -down-> Mediator: informs\n\nMediator -down-> AddMeetingAttendeeCommand: sends\nMediator -down-> RemoveMeetingAttendeeCommand: sends\n\nAddMeetingAttendeeCommandHandler -up-> AddMeetingAttendeeCommand: handles\nRemoveMeetingAttendeeCommandHandler -up-> RemoveMeetingAttendeeCommand: handles\n\nAddMeetingAttendeeCommandHandler .right.|> ICommandHandler: implements \nRemoveMeetingAttendeeCommandHandler .right.|> ICommandHandler: implements \n\nLoggingCommandHandlerDecorator ..|> ICommandHandler: implements\nLoggingCommandHandlerDecorator *..|> ICommandHandler: decorates\n@enduml"
},
{
"path": "docs/catalog-of-terms/Dependency-Injection/README.md",
"content": "# Dependency Injection\n\n## Definition\n\n*Dependency Injection is a technique in which an object receives other objects that it depends on. These other objects are called dependencies.*\n\nSource: [Wikipedia](https://en.wikipedia.org/wiki/Dependency_injection)\n\n## Example\n\n### Model\n\n\n\n### Code\n\n```csharp\n\ninternal class CancelMeetingCommandHandler : ICommandHandler\n{\n private readonly IMeetingRepository _meetingRepository;\n private readonly IMemberContext _memberContext;\n\n internal CancelMeetingCommandHandler(IMeetingRepository meetingRepository, IMemberContext memberContext)\n {\n _meetingRepository = meetingRepository;\n _memberContext = memberContext;\n }\n\n public async Task Handle(CancelMeetingCommand request, CancellationToken cancellationToken)\n {\n var meeting = await _meetingRepository.GetByIdAsync(new MeetingId(request.MeetingId));\n\n meeting.Cancel(_memberContext.MemberId);\n\n return Unit.Value;\n }\n}\n\n```\n### Description\n\nA `CancelMeetingCommandHandler` needs two collaborators (dependencies) to fulfill its job - repository of meetings (`IMeetingRepository`) and information about member context (`IMemberContext`). It doesn't instance implementation of these interfaces itself - they are provided (injected) via construction (*Constructor Injection*)."
},
{
"path": "docs/catalog-of-terms/Dependency-Injection/dependency-injection.puml",
"content": "@startuml Dependency Injection\n\nclass \"CancelMeetingCommandHandler\" {\nCancelMeetingCommandHandler(IMeetingRepository meetingRepository, IMemberContext memberContext)\n}\n\ninterface \"IMeetingRepository\" {\n\n}\n\ninterface \"IMemberContext\" {\n\n}\n\n\"CancelMeetingCommandHandler\" -> \"IMeetingRepository\" : uses\n\"CancelMeetingCommandHandler\" -> \"IMemberContext\" : uses\n\n@enduml"
},
{
"path": "docs/catalog-of-terms/Domain-Event/README.md",
"content": "# Domain Event\n\n## Definition\n\n*An event is something that has happened in the past. A **domain event** is, something that happened in the domain that you want other parts of the same domain (in-process) to be aware of. The notified parts usually react somehow to the events.*\n\nSource: [Domain events: design and implementation](https://docs.microsoft.com/en-us/dotnet/architecture/microservices/microservice-ddd-cqrs-patterns/domain-events-design-implementation)\n\n## Example\n\n### Model\n\n\n\n### Code\n\n```csharp\n\npublic class SubscriptionPaymentCreatedDomainEvent : DomainEventBase\n{\n public SubscriptionPaymentCreatedDomainEvent(\n Guid subscriptionPaymentId,\n Guid payerId,\n string subscriptionPeriodCode,\n string countryCode,\n string status,\n decimal value,\n string currency)\n {\n SubscriptionPaymentId = subscriptionPaymentId;\n PayerId = payerId;\n SubscriptionPeriodCode = subscriptionPeriodCode;\n CountryCode = countryCode;\n Status = status;\n Value = value;\n Currency = currency;\n }\n\n public Guid SubscriptionPaymentId { get; }\n public Guid PayerId { get; }\n public string SubscriptionPeriodCode { get; }\n public string CountryCode { get; }\n public string Status { get; }\n public decimal Value { get; }\n public string Currency { get; }\n}\n\npublic class DomainEventBase : IDomainEvent\n{\n public Guid Id { get; }\n public DateTime OccurredOn { get; }\n\n public DomainEventBase()\n {\n this.Id = Guid.NewGuid();\n this.OccurredOn = DateTime.UtcNow;\n }\n}\n\n```\n### Description\n\nA `SubscriptionPaymentCreatedDomainEvent` gets fired within the `SubscriptionPayment` aggregate root. This happens whenever a `Member` who is also a `Payer`, issues a command to buy a `Subscription`. \n\nAll properties are `get` only, because an event is something that has happened in the past, and you can not change the past.\n\nEvent details:\n* `SubscriptionPaymentId` - Auto generated unique Id for the subscription payment.\n* `PayerId` - The Id of the payer wanting to buy a subscription.\n* `SubscriptionPeriodCode` - The period of validity for this subscription:\n * 1 Month\n * 6 Months\n * Custom\n* `CountryCode` - The code of the country that the payer is issuing from.\n* `Status` - Automatically set to *WaitingForPayment*.\n* `Value` - The amount to be paid for the chosen subscription period.\n* `Currecy` - The currency of choice of the payer.\n\n---\nBusiness domain events extend `DomainEventBase` which in-turn implements the `IDomainEvent` interface.\n\nBase event details:\n* `Id` - Auto generated unique Id for the event itself.\n* `OccurredOn` - The point-in-time when the event happened. "
},
{
"path": "docs/catalog-of-terms/Domain-Event/domain-event.puml",
"content": "@startuml\nclass SubscriptionPaymentCreatedDomainEvent {\n +SubscriptionPaymentId\n +PayerId\n +SubscriptionPeriodCode\n +CountryCode\n +Status\n +Value\n +Currency\n}\nclass DomainEventBase\ninterface IDomainEvent {\n +Id\n +OccurredOn\n}\n\nIDomainEvent <|-- DomainEventBase: implements\nDomainEventBase <|-- SubscriptionPaymentCreatedDomainEvent: extends\n@enduml"
},
{
"path": "docs/catalog-of-terms/Entity-DDD/README.md",
"content": "# Entity (DDD)\n\n## Definition\n\n*When an object is distinguished by its identity, rather than its attributes, make this primary to its definition in the model. Keep the class definition simple and focused on life cycle continuity and identity. Define a means of distinguishing each object regardless of its form or history.*\n\nSource: [Domain-Driven Design: Tackling Complexity in the Heart of Software, Eric Evans](https://www.amazon.com/Domain-Driven-Design-Tackling-Complexity-Software/dp/0321125215)\n\n## Example\n\n### Model\n\n\n\n### Code\n\n```csharp\n\npublic class MeetingGroup : Entity, IAggregateRoot\n{\n public MeetingGroupId Id { get; private set; }\n\n private string _name;\n\n private string _description;\n\n private MeetingGroupLocation _location;\n\n private MemberId _creatorId;\n\n private List _members;\n\n private DateTime _createDate;\n\n private DateTime? _paymentDateTo;\n\n internal static MeetingGroup CreateBasedOnProposal(\n MeetingGroupProposalId meetingGroupProposalId,\n string name,\n string description,\n MeetingGroupLocation location,\n MemberId creatorId)\n {\n return new MeetingGroup(meetingGroupProposalId, name, description, location, creatorId);\n }\n\n private MeetingGroup()\n {\n // Only for EF.\n }\n\n private MeetingGroup(MeetingGroupProposalId meetingGroupProposalId, string name, string description, MeetingGroupLocation location, MemberId creatorId)\n {\n this.Id = new MeetingGroupId(meetingGroupProposalId.Value);\n this._name = name;\n this._description = description;\n this._creatorId = creatorId;\n this._location = location;\n this._createDate = SystemClock.Now;\n\n this.AddDomainEvent(new MeetingGroupCreatedDomainEvent(this.Id, creatorId));\n\n this._members = new List();\n this._members.Add(MeetingGroupMember.CreateNew(this.Id, this._creatorId, MeetingGroupMemberRole.Organizer));\n }\n\n public void EditGeneralAttributes(string name, string description, MeetingGroupLocation location)\n {\n this._name = name;\n this._description = description;\n this._location = location;\n\n this.AddDomainEvent(new MeetingGroupGeneralAttributesEditedDomainEvent(this._name, this._description, this._location));\n }\n\n public void JoinToGroupMember(MemberId memberId)\n {\n this.CheckRule(new MeetingGroupMemberCannotBeAddedTwiceRule(_members, memberId));\n\n this._members.Add(MeetingGroupMember.CreateNew(this.Id, memberId, MeetingGroupMemberRole.Member));\n }\n\n public void LeaveGroup(MemberId memberId)\n {\n this.CheckRule(new NotActualGroupMemberCannotLeaveGroupRule(_members, memberId));\n\n var member = this._members.Single(x => x.IsMember(memberId));\n\n member.Leave();\n }\n\n public void SetExpirationDate(DateTime dateTo)\n {\n _paymentDateTo = dateTo;\n\n this.AddDomainEvent(new MeetingGroupPaymentInfoUpdatedDomainEvent(this.Id, _paymentDateTo.Value));\n }\n\n public Meeting CreateMeeting(\n string title,\n MeetingTerm term,\n string description,\n MeetingLocation location,\n int? attendeesLimit,\n int guestsLimit,\n Term rsvpTerm,\n MoneyValue eventFee,\n List hostsMembersIds,\n MemberId creatorId)\n {\n this.CheckRule(new MeetingCanBeOrganizedOnlyByPayedGroupRule(_paymentDateTo));\n\n this.CheckRule(new MeetingHostMustBeAMeetingGroupMemberRule(creatorId, hostsMembersIds, _members));\n\n return Meeting.CreateNew(\n this.Id,\n title,\n term,\n description,\n location,\n MeetingLimits.Create(attendeesLimit, guestsLimit),\n rsvpTerm,\n eventFee,\n hostsMembersIds,\n creatorId);\n }\n\n internal bool IsMemberOfGroup(MemberId attendeeId)\n {\n return _members.Any(x => x.IsMember(attendeeId));\n }\n\n internal bool IsOrganizer(MemberId memberId)\n {\n return _members.Any(x => x.IsOrganizer(memberId));\n }\n}\n\n```\n\n### Description\n\nA *Meeting Group* is something we want to follow in time (it has a life cycle). For this reason, it has its unique identifier (`Id`). Is should be fully encapsulated - you can only mutate its state via exposed *behavior* (no setters)."
},
{
"path": "docs/catalog-of-terms/Entity-DDD/entity-ddd.puml",
"content": "@startuml Entity\n\nclass \"MeetingGroup\" << Entity >> {\n MeetingGroupId: Id\n -string: _description\n -DateTime: _createDate\n -DateTime: _paymentDateTo\n {static} MeetingGroup CreateBasedOnProposal()\n Meeting CreateMeeting(..)\n void SetExpirationDate(DateTime dateTo)\n void JoinToGroupMember(MemberId memberId)\n void LeaveGroup(MemberId memberId)\n void EditGeneralAttributes(...)\n bool IsMemberOfGroup(MemberId attendeeId)\n bool IsOrganizer(MemberId memberId)\n}\n\n@enduml"
},
{
"path": "docs/catalog-of-terms/Event/README.md",
"content": "# Event\n\n## Definition\n\n*An event is something that has happened in the past.*\n\nSource: [Domain events: design and implementation](https://docs.microsoft.com/en-us/dotnet/architecture/microservices/microservice-ddd-cqrs-patterns/domain-events-design-implementation)\n\n## Example\n\nFor examples, see specific kind of events: \n- [Domain Event](../Domain-Event/)\n- [Integration Event](../Integration-Event/)\n\n## Related\n\n- [Event Driven Architecture](../Event-Driven-Architecture/)\n- [Event Storming](../Event-Storming/)\n- [Event Sourcing](../Event-Sourcing/)"
},
{
"path": "docs/catalog-of-terms/Event-Driven-Architecture/README.md",
"content": "# Event Driven Architecture\n\nTODO"
},
{
"path": "docs/catalog-of-terms/Event-Sourcing/README.md",
"content": "# Event Sourcing\n\nTODO"
},
{
"path": "docs/catalog-of-terms/Event-Storming/README.md",
"content": "# Event Storming\n\nTODO"
},
{
"path": "docs/catalog-of-terms/Integration-Event/README.md",
"content": "# Integration Event\n\nTODO"
},
{
"path": "docs/catalog-of-terms/README.md",
"content": "# Catalog of terms\n\n- Act/Arrange/Assert\n- Actor (Event Storming)\n- API\n- Application Layer\n- [Aggregate (DDD)](Aggregate-DDD/)\n- Architecture Decision Record (ADR)\n- Architecture Test\n- Asynchronous Communication\n- Audit Log/Trail\n- Authentication\n- Authorization\n- Bounded Context (DDD)\n- C4 Model\n- Chain Of Command Pattern\n- [Command](Command/)\n- Composition Root\n- Continuous Integration\n- Contract\n- CQRS\n- Database Change Management\n- [Decorator Pattern](Decorator-Pattern/)\n- [Dependency Injection](Dependency-Injection/)\n- Dependency Inversion\n- Diagram as text\n- Domain Centric Architecture\n- [Domain Event](Domain-Event/)\n- Domain Layer\n- Domain Model\n- Domain Primitive\n- Domain Services (DDD)\n- Don't Repeat Yourself Principle\n- Encapsulation\n- [Entity (DDD)](Entity-DDD/)\n- [Event](Event/)\n- Eventual Consistency\n- [Event Driven Architecture](Event-Driven-Architecture/)\n- [Event Sourcing](Event-Sourcing/)\n- [Event Storming](Event-Storming/)\n- Events Stream\n- External System (Event Storming)\n- Facade Pattern\n- Factory Pattern\n- Given When Then\n- Layered Architecture\n- Mediator Pattern\n- Message (Messaging)\n- Mock\n- Modularity\n- Module\n- Monolith\n- Idempotency\n- Immediate Consistency\n- Immutability\n- Infrastructure Layer\n- [Integration Event](Integration-Event/)\n- Interface\n- Interface Segregation Principle\n- Inversion Of Control\n- Integration Test\n- Outbox Pattern (aka Store And Forward)\n- Parameter Object Pattern\n- Persistence Ignorance\n- POCO\n- Policy (EventStorming)\n- Projection (EventSourcing)\n- Pure Function\n- Rich Domain Model\n- Role-based Access Control\n- Query\n- Read Model\n- Repositories (DDD)\n- Single Responsibility Principle\n- [Strategy Pattern](Strategy-Pattern/)\n- Stub\n- Synchronous Communication\n- Transaction (Database)\n- Ubiquitous Language (DDD)\n- Unit Of Work Pattern\n- Unit Test\n- Write Model\n- [ValueObject (DDD)](ValueObject-DDD/)"
},
{
"path": "docs/catalog-of-terms/Strategy-Pattern/README.md",
"content": "# Strategy Pattern\n\n## Definition\n\n*The strategy pattern (also known as the policy pattern) is a behavioral software design pattern that enables selecting an algorithm at runtime. Instead of implementing a single algorithm directly, code receives run-time instructions as to which in a family of algorithms to use.*\n\nSource: [Wikipedia](https://en.wikipedia.org/wiki/Strategy_pattern)\n\n## Example\n\n### Model\n\n\n\n### Code\n\n```csharp\n\ninternal class BuySubscriptionCommandHandler : ICommandHandler\n {\n private readonly IAggregateStore _aggregateStore;\n\n private readonly IPayerContext _payerContext;\n\n private readonly ISqlConnectionFactory _sqlConnectionFactory;\n\n internal BuySubscriptionCommandHandler(\n IAggregateStore aggregateStore,\n IPayerContext payerContext,\n ISqlConnectionFactory sqlConnectionFactory)\n {\n _aggregateStore = aggregateStore;\n _payerContext = payerContext;\n _sqlConnectionFactory = sqlConnectionFactory;\n }\n\n public async Task Handle(BuySubscriptionCommand command, CancellationToken cancellationToken)\n {\n var priceList = await PriceListFactory.CreatePriceList(_sqlConnectionFactory.GetOpenConnection());\n\n var subscription = SubscriptionPayment.Buy(\n _payerContext.PayerId,\n SubscriptionPeriod.Of(command.SubscriptionTypeCode),\n command.CountryCode,\n MoneyValue.Of(command.Value, command.Currency),\n priceList);\n\n _aggregateStore.AppendChanges(subscription);\n\n return subscription.Id;\n }\n }\n\npublic static class PriceListFactory\n {\n public static async Task CreatePriceList(IDbConnection connection)\n {\n var priceListItemList = await GetPriceListItems(connection);\n\n var priceListItems = priceListItemList\n .Select(x =>\n new PriceListItemData(\n x.CountryCode,\n SubscriptionPeriod.Of(x.SubscriptionPeriodCode),\n MoneyValue.Of(x.MoneyValue, x.MoneyCurrency),\n PriceListItemCategory.Of(x.CategoryCode)))\n .ToList();\n\n // This is place for selecting pricing strategy based on provided data and the system state.\n IPricingStrategy pricingStrategy = new DirectValueFromPriceListPricingStrategy(priceListItems);\n\n return PriceList.Create(\n priceListItems,\n pricingStrategy);\n }\n\n public static async Task> GetPriceListItems(IDbConnection connection)\n {\n var priceListItems = await connection.QueryAsync(\"SELECT \" +\n$\"[PriceListItem].[CountryCode] AS [{nameof(PriceListItemDto.CountryCode)}], \" +\n$\"[PriceListItem].[SubscriptionPeriodCode] AS [{nameof(PriceListItemDto.SubscriptionPeriodCode)}], \" +\n$\"[PriceListItem].[MoneyValue] AS [{nameof(PriceListItemDto.MoneyValue)}], \" +\n$\"[PriceListItem].[MoneyCurrency] AS [{nameof(PriceListItemDto.MoneyCurrency)}], \" +\n$\"[PriceListItem].[CategoryCode] AS [{nameof(PriceListItemDto.CategoryCode)}] \" +\n\"FROM [payments].[PriceListItems] AS [PriceListItem] \" +\n\"WHERE [PriceListItem].[IsActive] = 1\");\n\n var priceListItemList = priceListItems.AsList();\n return priceListItemList;\n }\n }\n\npublic class PriceList : ValueObject\n {\n private readonly List _items;\n\n private readonly IPricingStrategy _pricingStrategy;\n\n private PriceList(\n List items,\n IPricingStrategy pricingStrategy)\n {\n _items = items;\n _pricingStrategy = pricingStrategy;\n }\n\n public static PriceList Create(\n List items,\n IPricingStrategy pricingStrategy)\n {\n return new PriceList(items, pricingStrategy);\n }\n\n public MoneyValue GetPrice(\n string countryCode,\n SubscriptionPeriod subscriptionPeriod,\n PriceListItemCategory category)\n {\n CheckRule(new PriceForSubscriptionMustBeDefinedRule(countryCode, subscriptionPeriod, _items, category));\n\n return _pricingStrategy.GetPrice(countryCode, subscriptionPeriod, category);\n }\n }\n\npublic interface IPricingStrategy\n {\n MoneyValue GetPrice(\n string countryCode,\n SubscriptionPeriod subscriptionPeriod,\n PriceListItemCategory category);\n }\n\npublic class DiscountedValueFromPriceListPricingStrategy : IPricingStrategy\n {\n private readonly List _items;\n\n private readonly MoneyValue _discountValue;\n\n public DiscountedValueFromPriceListPricingStrategy(\n List items,\n MoneyValue discountValue)\n {\n _items = items;\n _discountValue = discountValue;\n }\n\n public MoneyValue GetPrice(string countryCode, SubscriptionPeriod subscriptionPeriod, PriceListItemCategory category)\n {\n var priceListItem = _items.Single(x =>\n x.CountryCode == countryCode && x.SubscriptionPeriod == subscriptionPeriod &&\n x.Category == category);\n\n return priceListItem.Value - _discountValue;\n }\n }\n\n public class DirectValuePricingStrategy : IPricingStrategy\n {\n private readonly MoneyValue _directValue;\n\n public DirectValuePricingStrategy(MoneyValue directValue)\n {\n _directValue = directValue;\n }\n\n public MoneyValue GetPrice(string countryCode, SubscriptionPeriod subscriptionPeriod, PriceListItemCategory category)\n {\n return _directValue;\n }\n }\n\npublic class DirectValueFromPriceListPricingStrategy : IPricingStrategy\n {\n private readonly List _items;\n\n public DirectValueFromPriceListPricingStrategy(List items)\n {\n _items = items;\n }\n\n public MoneyValue GetPrice(\n string countryCode,\n SubscriptionPeriod subscriptionPeriod,\n PriceListItemCategory category)\n {\n var priceListItem = _items.Single(x =>\n x.CountryCode == countryCode && x.SubscriptionPeriod == subscriptionPeriod &&\n x.Category == category);\n\n return priceListItem.Value;\n }\n }\n```\n### Description\n\nLet's introduce the concepts of the strategy pattern, so we can understand how the above example fits this pattern.\n\n* **Client** - The calling code.\n* **Context** - An object which maintains a reference to one of the *concrete strategies* and communicates with the *client*.\n* **Strategy interface** - An interface or abstract class that the *client* can use to set a concrete strategy at run-time, through the *context*.\n* **Concrete strategies** - One or more implementations of the *strategy interface*.\n\n---\n\nIf we have a close look at our example of buying a `Subscription`, we can notice the elements of the strategy pattern.\n\n* `BuySubscriptionCommandHandler` is the calling code! Also the handler, indirectly via the `PriceListFactory` sets the current *strategy* of `PriceList`, so their combined interaction represents the **Client**. \n* `PriceList` is the object which maintains a reference to a pricing strategy, so it represents the **Context**. \n* `IPricingStrategy` represents the **Strategy interface**.\n* `DiscountedValueFromPriceListPricingStrategy`, `DirectValueFromPriceListPricingStrategy` and `DirectValuePricingStrategy` are the implementations of `IPricingStrategy` so they represent the **Concrete strategies**.\n\n---\n\n The interaction of the `BuySubscriptionCommandHandler` and `PriceListFactory` is a good example of leveraging multiple design patterns. Check out [Factory Pattern](../Factory-Pattern/) to learn more.\n\nStrategy should not be confused with [Decorator](../Decorator-Pattern/)!!!\n*A strategy lets you change the guts of an object, while decorator lets you change the skin.*"
},
{
"path": "docs/catalog-of-terms/Strategy-Pattern/strategy-pattern.puml",
"content": "@startuml\npackage \"Generic\" #DDDDDD {\nclass Client {\n - context\n}\n\nclass Context {\n - strategy\n + setStrategy(strategy)\n + do()\n}\n\ninterface Strategy {\n + execute()\n}\n\nclass ConcreteStrategyA {\n + execute()\n}\n\nclass ConcreteStrategyB {\n + execute()\n}\n}\n\npackage \"BuySubscription\" #DDDDDD {\nclass BuySubscriptionCommandHandler {\n - connection\n - PriceListFactory.CreatePriceList(connection)\n}\n\nclass PriceList {\n - _pricingStrategy\n + Create(items, pricingStrategy)\n + GetPrice(countryCode, subscriptionPeriod, category)\n}\n\ninterface IPricingStrategy {\n + GetPrice(countryCode, subscriptionPeriod, category)\n}\n\nclass DirectValueFromPriceListPricingStrategy {\n + GetPrice(countryCode, subscriptionPeriod, category)\n}\n\nclass DirectValuePricingStrategy {\n + GetPrice(countryCode, subscriptionPeriod, category)\n}\n\nclass DiscountedValueFromPriceListPricingStrategy {\n + GetPrice(countryCode, subscriptionPeriod, category)\n}\n}\n\nhide empty members\n\nClient -down-|> Context\nContext *-- Strategy\nStrategy <|-- ConcreteStrategyA\nStrategy <|-- ConcreteStrategyB\n\nnote left of Context::do \n Calls strategy.execute()\nend note\n\n\nBuySubscriptionCommandHandler -down-> PriceList\nPriceList *-- IPricingStrategy\nIPricingStrategy <|-- DirectValueFromPriceListPricingStrategy\nIPricingStrategy <|-- DirectValuePricingStrategy\nIPricingStrategy <|-- DiscountedValueFromPriceListPricingStrategy\n\nnote left of PriceList::GetPrice \n Calls _pricingStrategy.GetPrice(...)\nend note\n@enduml"
},
{
"path": "docs/catalog-of-terms/ValueObject-DDD/README.md",
"content": "# ValueObject (DDD)\n\n## Definition\n\n*When you care only about the attributes of an element of the model, classify it as a VALUE OBJECT. Make it express the meaning of the attributes it conveys and give it related functionality. Treat the VALUE OBJECT as immutable. Don't give it any identity and avoid the design complexities necessary to maintain ENTITIES.*\n\nSource: [Domain-Driven Design: Tackling Complexity in the Heart of Software, Eric Evans](https://www.amazon.com/Domain-Driven-Design-Tackling-Complexity-Software/dp/0321125215)\n\n## Example\n\n### Model\n\n\n\n### Code\n\n```csharp\n\npublic class MoneyValue : ValueObject\n{\n public decimal Value { get; }\n\n public string Currency { get; }\n\n private MoneyValue(decimal value, string currency)\n {\n this.Value = value;\n this.Currency = currency;\n }\n\n public static MoneyValue Of(decimal value, string currency)\n {\n CheckRule(new ValueOfMoneyMustNotBeNegativeRule(value));\n\n return new MoneyValue(value, currency);\n }\n\n public static bool operator >(decimal left, MoneyValue right) => left > right.Value;\n\n public static bool operator <(decimal left, MoneyValue right) => left < right.Value;\n\n public static bool operator >=(decimal left, MoneyValue right) => left >= right.Value;\n\n public static bool operator <=(decimal left, MoneyValue right) => left <= right.Value;\n\n public static bool operator >(MoneyValue left, decimal right) => left.Value > right;\n\n public static bool operator <(MoneyValue left, decimal right) => left.Value < right;\n\n public static bool operator >=(MoneyValue left, decimal right) => left.Value >= right;\n\n public static bool operator <=(MoneyValue left, decimal right) => left.Value <= right;\n}\n\n```\n\n### Description\n\nA *Money Value* class represents concept of money. In our Domain, we don't want to follow money in time (it does not have a life cycle). It does not have an identity either. Whole object is **immutable** (`Value` and `Currency` defined as readonly). The comparison is done by comparing attribute values, not identifiers (see `ValueObject` abstract class)."
},
{
"path": "docs/catalog-of-terms/ValueObject-DDD/value-object-ddd.puml",
"content": "@startuml ValueObject\n\nclass \"MeetingGroup\" << ValueObject >> {\n decimal: Value {readonly}\n string: Currency {readonly}\n}\n\n@enduml"
},
{
"path": "docs/mutation-tests-reports/mutation-report.html",
"content": "\n\n \n \n \n \n \n \n \n Your browser doesn't support custom elements.\n Please use a latest version of an evergreen browser (Firefox, Chrome, Safari, Opera, etc).\n \n \n \n\n\n"
},
{
"path": "runIntegrationTests.cmd",
"content": "@ECHO OFF\nSETLOCAL\nSET CONTAINER_ID=\nFOR /f %%i IN ('docker ps -q -f name^=myMeetings-integration-db') DO SET CONTAINER_ID=%%i\n\nIF \"%CONTAINER_ID%\"==\"\" (\n ECHO \"not found\"\n) ELSE (\n\tdocker rm --force myMeetings-integration-db\n)\n\ndocker run --rm --name myMeetings-integration-db -e \"ACCEPT_EULA=Y\" -e \"SA_PASSWORD=61cD4gE6!\" -e \"MSSQL_PID=Express\" -p 1439:1433 -d mcr.microsoft.com/mssql/server:2017-latest-ubuntu\nTIMEOUT 30\ndocker cp ./src/Database/CompanyName.MyMeetings.Database/Scripts/CreateDatabase_Linux.sql myMeetings-integration-db:/\ndocker exec -i myMeetings-integration-db sh -c \"/opt/mssql-tools/bin/sqlcmd -d master -i /CreateDatabase_Linux.sql -U sa -P 61cD4gE6!\"\ndotnet build src/ --configuration Release --no-restore\nSET ASPNETCORE_MyMeetings_IntegrationTests_ConnectionString=Server=localhost,1439;Database=MyMeetings;User=sa;Password=61cD4gE6!\ndotnet \"src/Database/DatabaseMigrator/bin/Release/netcoreapp3.1/DatabaseMigrator.dll\" %ASPNETCORE_MyMeetings_IntegrationTests_ConnectionString% \"src/Database/CompanyName.MyMeetings.Database/Scripts/Migrations\"\ndotnet test --configuration Release --no-build --verbosity normal src/Modules/Administration/Tests/IntegrationTests/CompanyName.MyMeetings.Modules.Administration.IntegrationTests.csproj\ndotnet test --configuration Release --no-build --verbosity normal src/Modules/Payments/Tests/IntegrationTests/CompanyName.MyMeetings.Modules.Payments.IntegrationTests.csproj\ndotnet test --configuration Release --no-build --verbosity normal src/Modules/UserAccess/Tests/IntegrationTests/CompanyNames.MyMeetings.Modules.UserAccess.IntegrationTests.csproj\ndotnet test --configuration Release --no-build --verbosity normal src/Modules/Meetings/Tests/IntegrationTests/CompanyName.MyMeetings.Modules.Meetings.IntegrationTests.csproj\ndotnet test --configuration Release --no-build --verbosity normal src/Tests/IntegrationTests/CompanyName.MyMeetings.IntegrationTests.csproj\n"
},
{
"path": "src/.dockerignore",
"content": "**/.classpath\n**/.dockerignore\n**/.env\n**/.git\n**/.gitignore\n**/.project\n**/.settings\n**/.toolstarget\n**/.vs\n**/.vscode\n**/*.*proj.user\n**/*.dbmdl\n**/*.jfm\n**/azds.yaml\n**/bin\n**/charts\n**/docker-compose*\n**/Dockerfile*\n**/node_modules\n**/npm-debug.log\n**/obj\n**/secrets.dev.yaml\n**/values.dev.yaml\nLICENSE\nREADME.md"
},
{
"path": "src/.editorconfig",
"content": "[*.cs]\n\n# SA1309: Field names should not begin with underscore\ndotnet_diagnostic.SA1309.severity = none\n\n# SA1600: Elements should be documented\ndotnet_diagnostic.SA1600.severity = none\n\n# SA1633: File should have header\ndotnet_diagnostic.SA1633.severity = none\n\n# SA1200: Using directives should be placed correctly\ndotnet_diagnostic.SA1200.severity = none\n\n# SA1402: File may only contain a single type\ndotnet_diagnostic.SA1402.severity = suggestion\n\n# SA1101: Prefix local calls with this\ndotnet_diagnostic.SA1101.severity = none\n\n# SA0001: All diagnostics of XML documentation comments has been disabled due to the current project configuration.\ndotnet_diagnostic.SA0001.severity = none\n\n# SA1201: Elements should appear in the correct order\ndotnet_diagnostic.SA1201.severity = none\n\n# SA1204: Static elements should appear before instance elements\ndotnet_diagnostic.SA1204.severity = none\n\n# SA1413: Use trailing comma in multi-line initializers\ndotnet_diagnostic.SA1413.severity = none\n\n# SA1623: Property summary documentation should match accessors\ndotnet_diagnostic.SA1623.severity = none\n"
},
{
"path": "src/API/CompanyName.MyMeetings.API/CompanyName.MyMeetings.API.csproj",
"content": "\n \n true\n InProcess\n 2b9855d3-f073-44d2-aa45-b15e896794b9\n Linux\n ..\\..\n \n \n bin\\Debug\\CompanyName.MyMeetings.API.xml\n \n \n \n \n\n"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Configuration/Authorization/AttributeAuthorizationHandler.cs",
"content": "using Microsoft.AspNetCore.Authorization;\n\nnamespace CompanyName.MyMeetings.API.Configuration.Authorization\n{\n public abstract class AttributeAuthorizationHandler\n : AuthorizationHandler\n where TRequirement : IAuthorizationRequirement\n where TAttribute : Attribute\n {\n protected override Task HandleRequirementAsync(AuthorizationHandlerContext context, TRequirement requirement)\n {\n var endpoint = (context.Resource as HttpContext).GetEndpoint() as RouteEndpoint;\n var attribute = endpoint?.Metadata.GetMetadata();\n\n return HandleRequirementAsync(context, requirement, attribute);\n }\n\n protected abstract Task HandleRequirementAsync(\n AuthorizationHandlerContext context,\n TRequirement requirement,\n TAttribute attribute);\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Configuration/Authorization/AuthorizationChecker.cs",
"content": "using System.Reflection;\nusing System.Text;\nusing Microsoft.AspNetCore.Mvc;\n\nnamespace CompanyName.MyMeetings.API.Configuration.Authorization\n{\n public static class AuthorizationChecker\n {\n public static void CheckAllEndpoints()\n {\n var assembly = typeof(Startup).Assembly;\n var allControllerTypes = assembly.GetTypes().Where(x => x.IsSubclassOf(typeof(ControllerBase)));\n\n List notProtectedActionMethods = [];\n foreach (var controllerType in allControllerTypes)\n {\n var controllerHasPermissionAttribute = controllerType.GetCustomAttribute();\n if (controllerHasPermissionAttribute != null)\n {\n continue;\n }\n\n var actionMethods = controllerType.GetMethods()\n .Where(x => x.IsPublic && x.DeclaringType == controllerType)\n .ToList();\n\n foreach (var publicMethod in actionMethods)\n {\n var hasPermissionAttribute = publicMethod.GetCustomAttribute();\n if (hasPermissionAttribute == null)\n {\n var noPermissionRequired = publicMethod.GetCustomAttribute();\n\n if (noPermissionRequired == null)\n {\n notProtectedActionMethods.Add($\"{controllerType.Name}.{publicMethod.Name}\");\n }\n }\n }\n }\n\n if (notProtectedActionMethods.Any())\n {\n var errorBuilder = new StringBuilder();\n errorBuilder.AppendLine(\"Invalid authorization configuration: \");\n\n foreach (var notProtectedActionMethod in notProtectedActionMethods)\n {\n errorBuilder.AppendLine($\"Method {notProtectedActionMethod} is not protected. \");\n }\n\n throw new ApplicationException(errorBuilder.ToString());\n }\n }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Configuration/Authorization/HasPermissionAttribute.cs",
"content": "using Microsoft.AspNetCore.Authorization;\n\nnamespace CompanyName.MyMeetings.API.Configuration.Authorization\n{\n [AttributeUsage(AttributeTargets.Class | AttributeTargets.Method, AllowMultiple = true)]\n internal class HasPermissionAttribute : AuthorizeAttribute\n {\n internal const string HasPermissionPolicyName = \"HasPermission\";\n\n public HasPermissionAttribute(string name)\n : base(HasPermissionPolicyName)\n {\n Name = name;\n }\n\n public string Name { get; }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Configuration/Authorization/HasPermissionAuthorizationHandler.cs",
"content": "using CompanyName.MyMeetings.BuildingBlocks.Application;\nusing CompanyName.MyMeetings.Modules.UserAccess.Application.Authorization.GetUserPermissions;\nusing CompanyName.MyMeetings.Modules.UserAccess.Application.Contracts;\nusing Microsoft.AspNetCore.Authorization;\n\nnamespace CompanyName.MyMeetings.API.Configuration.Authorization\n{\n internal class HasPermissionAuthorizationHandler : AttributeAuthorizationHandler<\n HasPermissionAuthorizationRequirement, HasPermissionAttribute>\n {\n private readonly IExecutionContextAccessor _executionContextAccessor;\n private readonly IUserAccessModule _userAccessModule;\n\n public HasPermissionAuthorizationHandler(\n IExecutionContextAccessor executionContextAccessor,\n IUserAccessModule userAccessModule)\n {\n _executionContextAccessor = executionContextAccessor;\n _userAccessModule = userAccessModule;\n }\n\n protected override async Task HandleRequirementAsync(\n AuthorizationHandlerContext context,\n HasPermissionAuthorizationRequirement requirement,\n HasPermissionAttribute attribute)\n {\n var permissions = await _userAccessModule.ExecuteQueryAsync(new GetUserPermissionsQuery(_executionContextAccessor.UserId));\n\n if (!await AuthorizeAsync(attribute.Name, permissions))\n {\n context.Fail();\n return;\n }\n\n context.Succeed(requirement);\n }\n\n private Task AuthorizeAsync(string permission, List permissions)\n {\n#if !DEBUG\n return Task.FromResult(true);\n#endif\n#pragma warning disable CS0162 // Unreachable code detected\n return Task.FromResult(permissions.Any(x => x.Code == permission));\n#pragma warning restore CS0162 // Unreachable code detected\n }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Configuration/Authorization/HasPermissionAuthorizationRequirement.cs",
"content": "using Microsoft.AspNetCore.Authorization;\n\nnamespace CompanyName.MyMeetings.API.Configuration.Authorization\n{\n public class HasPermissionAuthorizationRequirement : IAuthorizationRequirement\n {\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Configuration/Authorization/NoPermissionRequiredAttribute.cs",
"content": "namespace CompanyName.MyMeetings.API.Configuration.Authorization\n{\n [AttributeUsage(AttributeTargets.Method, AllowMultiple = true)]\n public class NoPermissionRequiredAttribute : Attribute\n {\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Configuration/ExecutionContext/CorrelationMiddleware.cs",
"content": "namespace CompanyName.MyMeetings.API.Configuration.ExecutionContext\n{\n internal class CorrelationMiddleware\n {\n internal const string CorrelationHeaderKey = \"CorrelationId\";\n private readonly RequestDelegate _next;\n\n public CorrelationMiddleware(RequestDelegate next)\n {\n _next = next;\n }\n\n public async Task Invoke(HttpContext context)\n {\n var correlationId = Guid.NewGuid();\n\n context.Request?.Headers.Append(CorrelationHeaderKey, correlationId.ToString());\n\n await _next.Invoke(context);\n }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Configuration/ExecutionContext/ExecutionContextAccessor.cs",
"content": "using CompanyName.MyMeetings.BuildingBlocks.Application;\n\nnamespace CompanyName.MyMeetings.API.Configuration.ExecutionContext\n{\n public class ExecutionContextAccessor : IExecutionContextAccessor\n {\n private readonly IHttpContextAccessor _httpContextAccessor;\n\n public ExecutionContextAccessor(IHttpContextAccessor httpContextAccessor)\n {\n _httpContextAccessor = httpContextAccessor;\n }\n\n public Guid UserId\n {\n get\n {\n if (_httpContextAccessor\n .HttpContext?\n .User?\n .Claims?\n .SingleOrDefault(x => x.Type == \"sub\")?\n .Value != null)\n {\n return Guid.Parse(_httpContextAccessor.HttpContext.User.Claims.Single(\n x => x.Type == \"sub\").Value);\n }\n\n throw new ApplicationException(\"User context is not available\");\n }\n }\n\n public Guid CorrelationId\n {\n get\n {\n if (IsAvailable && _httpContextAccessor.HttpContext.Request.Headers.Keys.Any(\n x => x == CorrelationMiddleware.CorrelationHeaderKey))\n {\n return Guid.Parse(\n _httpContextAccessor.HttpContext.Request.Headers[CorrelationMiddleware.CorrelationHeaderKey]);\n }\n\n throw new ApplicationException(\"Http context and correlation id is not available\");\n }\n }\n\n public bool IsAvailable => _httpContextAccessor.HttpContext != null;\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Configuration/Extensions/SwaggerExtensions.cs",
"content": "using System.Reflection;\r\nusing Microsoft.OpenApi.Models;\r\n\r\nnamespace CompanyName.MyMeetings.API.Configuration.Extensions\r\n{\r\n internal static class SwaggerExtensions\r\n {\r\n internal static IServiceCollection AddSwaggerDocumentation(this IServiceCollection services)\r\n {\r\n services.AddSwaggerGen(options =>\r\n {\r\n options.SwaggerDoc(\"v1\", new OpenApiInfo\r\n {\r\n Title = \"MyMeetings API\",\r\n Version = \"v1\",\r\n Description = \"MyMeetings API for modular monolith .NET application.\"\r\n });\r\n options.CustomSchemaIds(t => t.ToString());\r\n\r\n var baseDirectory = AppDomain.CurrentDomain.BaseDirectory;\r\n var commentsFileName = $\"{Assembly.GetExecutingAssembly().GetName().Name}.xml\";\r\n var commentsFile = Path.Combine(baseDirectory, commentsFileName);\r\n options.IncludeXmlComments(commentsFile);\r\n\r\n options.AddSecurityDefinition(\"Bearer\", new OpenApiSecurityScheme\r\n {\r\n Description =\r\n \"JWT Authorization header using the Bearer scheme. Example: \\\"Authorization: Bearer {token}\\\"\",\r\n Name = \"Authorization\",\r\n In = ParameterLocation.Header,\r\n Type = SecuritySchemeType.ApiKey\r\n });\r\n\r\n options.AddSecurityRequirement(new OpenApiSecurityRequirement\r\n {\r\n {\r\n new OpenApiSecurityScheme\r\n {\r\n Reference = new OpenApiReference\r\n {\r\n Type = ReferenceType.SecurityScheme,\r\n Id = \"Bearer\"\r\n },\r\n Scheme = \"oauth2\",\r\n Name = \"Bearer\",\r\n In = ParameterLocation.Header\r\n },\r\n new List()\r\n }\r\n });\r\n });\r\n\r\n return services;\r\n }\r\n\r\n internal static IApplicationBuilder UseSwaggerDocumentation(this IApplicationBuilder app)\r\n {\r\n app.UseSwagger();\r\n\r\n app.UseSwaggerUI(c => { c.SwaggerEndpoint(\"/swagger/v1/swagger.json\", \"MyMeetings API\"); });\r\n\r\n return app;\r\n }\r\n }\r\n}\r\n"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Configuration/Validation/BusinessRuleValidationExceptionProblemDetails.cs",
"content": "using CompanyName.MyMeetings.BuildingBlocks.Domain;\nusing Microsoft.AspNetCore.Mvc;\n\nnamespace CompanyName.MyMeetings.API.Configuration.Validation\n{\n public class BusinessRuleValidationExceptionProblemDetails : ProblemDetails\n {\n public BusinessRuleValidationExceptionProblemDetails(BusinessRuleValidationException exception)\n {\n Title = \"Business rule broken\";\n Status = StatusCodes.Status409Conflict;\n Detail = exception.Message;\n Type = \"https://somedomain/business-rule-validation-error\";\n }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Configuration/Validation/InvalidCommandProblemDetails.cs",
"content": "using CompanyName.MyMeetings.BuildingBlocks.Application;\nusing Microsoft.AspNetCore.Mvc;\n\nnamespace CompanyName.MyMeetings.API.Configuration.Validation\n{\n public class InvalidCommandProblemDetails : ProblemDetails\n {\n public InvalidCommandProblemDetails(InvalidCommandException exception)\n {\n Title = \"Command validation error\";\n Status = StatusCodes.Status400BadRequest;\n Type = \"https://somedomain/validation-error\";\n Errors = exception.Errors;\n }\n\n public List Errors { get; }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Modules/Administration/AdministrationAutofacModule.cs",
"content": "using Autofac;\nusing CompanyName.MyMeetings.Modules.Administration.Application.Contracts;\nusing CompanyName.MyMeetings.Modules.Administration.Infrastructure;\n\nnamespace CompanyName.MyMeetings.API.Modules.Administration\n{\n internal class AdministrationAutofacModule : Module\n {\n protected override void Load(ContainerBuilder builder)\n {\n builder.RegisterType()\n .As()\n .InstancePerLifetimeScope();\n }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Modules/Administration/AdministrationPermissions.cs",
"content": "namespace CompanyName.MyMeetings.API.Modules.Administration\n{\n public class AdministrationPermissions\n {\n public const string AcceptMeetingGroupProposal = \"AcceptMeetingGroupProposal\";\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Modules/Administration/MeetingGroupProposals/MeetingGroupProposalsController.cs",
"content": "using CompanyName.MyMeetings.API.Configuration.Authorization;\nusing CompanyName.MyMeetings.Modules.Administration.Application.Contracts;\nusing CompanyName.MyMeetings.Modules.Administration.Application.MeetingGroupProposals.AcceptMeetingGroupProposal;\nusing CompanyName.MyMeetings.Modules.Administration.Application.MeetingGroupProposals.GetMeetingGroupProposal;\nusing CompanyName.MyMeetings.Modules.Administration.Application.MeetingGroupProposals.GetMeetingGroupProposals;\nusing Microsoft.AspNetCore.Mvc;\n\nnamespace CompanyName.MyMeetings.API.Modules.Administration.MeetingGroupProposals\n{\n [Route(\"api/administration/meetingGroupProposals\")]\n [ApiController]\n public class MeetingGroupProposalsController : ControllerBase\n {\n private readonly IAdministrationModule _administrationModule;\n\n public MeetingGroupProposalsController(IAdministrationModule administrationModule)\n {\n _administrationModule = administrationModule;\n }\n\n [HttpGet(\"\")]\n [HasPermission(AdministrationPermissions.AcceptMeetingGroupProposal)]\n [ProducesResponseType(typeof(List), StatusCodes.Status200OK)]\n public async Task GetMeetingGroupProposals()\n {\n var meetingGroupProposals =\n await _administrationModule.ExecuteQueryAsync(new GetMeetingGroupProposalsQuery());\n\n return Ok(meetingGroupProposals);\n }\n\n [HttpPatch(\"{meetingGroupProposalId}/accept\")]\n [HasPermission(AdministrationPermissions.AcceptMeetingGroupProposal)]\n [ProducesResponseType(StatusCodes.Status200OK)]\n public async Task AcceptMeetingGroupProposal(Guid meetingGroupProposalId)\n {\n await _administrationModule.ExecuteCommandAsync(\n new AcceptMeetingGroupProposalCommand(meetingGroupProposalId));\n\n return Ok();\n }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Modules/Meetings/Countries/CountriesController.cs",
"content": "using CompanyName.MyMeetings.API.Configuration.Authorization;\nusing CompanyName.MyMeetings.Modules.Meetings.Application.Contracts;\nusing CompanyName.MyMeetings.Modules.Meetings.Application.Countries;\nusing Microsoft.AspNetCore.Mvc;\n\nnamespace CompanyName.MyMeetings.API.Modules.Meetings.Countries\n{\n [Route(\"api/meetings/countries\")]\n [ApiController]\n public class CountriesController : ControllerBase\n {\n private readonly IMeetingsModule _meetingsModule;\n\n public CountriesController(IMeetingsModule meetingsModule)\n {\n _meetingsModule = meetingsModule;\n }\n\n [HttpGet(\"\")]\n [HasPermission(MeetingsPermissions.GetMeetingGroupProposals)]\n [ProducesResponseType(typeof(List), StatusCodes.Status200OK)]\n public async Task GetAllCountries(int? page, int? perPage)\n {\n var countries = await _meetingsModule.ExecuteQueryAsync(\n new GetAllCountriesQuery());\n\n return Ok(countries);\n }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Modules/Meetings/MeetingCommentingConfiguration/MeetingCommentingConfigurationController.cs",
"content": "using CompanyName.MyMeetings.API.Configuration.Authorization;\nusing CompanyName.MyMeetings.Modules.Meetings.Application.Contracts;\nusing CompanyName.MyMeetings.Modules.Meetings.Application.MeetingCommentingConfigurations.DisableMeetingCommentingConfiguration;\nusing CompanyName.MyMeetings.Modules.Meetings.Application.MeetingCommentingConfigurations.EnableMeetingCommentingConfiguration;\nusing Microsoft.AspNetCore.Mvc;\n\nnamespace CompanyName.MyMeetings.API.Modules.Meetings.MeetingCommentingConfiguration\n{\n [Route(\"api/meetings/meetings/{meetingId}/configuration/commenting\")]\n [ApiController]\n public class MeetingCommentingConfigurationController : ControllerBase\n {\n private readonly IMeetingsModule _meetingsModule;\n\n public MeetingCommentingConfigurationController(IMeetingsModule meetingsModule)\n {\n _meetingsModule = meetingsModule;\n }\n\n [HttpPatch(\"disable\")]\n [HasPermission(MeetingsPermissions.DisableMeetingCommenting)]\n [ProducesResponseType(StatusCodes.Status200OK)]\n public async Task DisableCommenting(Guid meetingId)\n {\n await _meetingsModule.ExecuteCommandAsync(new DisableMeetingCommentingConfigurationCommand(meetingId));\n return Ok();\n }\n\n [HttpPatch(\"enable\")]\n [HasPermission(MeetingsPermissions.EnableMeetingCommenting)]\n [ProducesResponseType(StatusCodes.Status200OK)]\n public async Task EnableCommenting(Guid meetingId)\n {\n await _meetingsModule.ExecuteCommandAsync(new EnableMeetingCommentingConfigurationCommand(meetingId));\n return Ok();\n }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Modules/Meetings/MeetingComments/AddMeetingCommentRequest.cs",
"content": "namespace CompanyName.MyMeetings.API.Modules.Meetings.MeetingComments\n{\n public class AddMeetingCommentRequest\n {\n public Guid MeetingId { get; set; }\n\n public string Comment { get; set; }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Modules/Meetings/MeetingComments/EditMeetingCommentRequest.cs",
"content": "namespace CompanyName.MyMeetings.API.Modules.Meetings.MeetingComments\n{\n public class EditMeetingCommentRequest\n {\n public string EditedComment { get; set; }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Modules/Meetings/MeetingComments/MeetingCommentsController.cs",
"content": "using CompanyName.MyMeetings.API.Configuration.Authorization;\nusing CompanyName.MyMeetings.Modules.Meetings.Application.Contracts;\nusing CompanyName.MyMeetings.Modules.Meetings.Application.MeetingComments.AddMeetingComment;\nusing CompanyName.MyMeetings.Modules.Meetings.Application.MeetingComments.AddMeetingCommentLike;\nusing CompanyName.MyMeetings.Modules.Meetings.Application.MeetingComments.AddMeetingCommentReply;\nusing CompanyName.MyMeetings.Modules.Meetings.Application.MeetingComments.EditMeetingComment;\nusing CompanyName.MyMeetings.Modules.Meetings.Application.MeetingComments.RemoveMeetingComment;\nusing CompanyName.MyMeetings.Modules.Meetings.Application.MeetingComments.RemoveMeetingCommentLike;\nusing Microsoft.AspNetCore.Mvc;\n\nnamespace CompanyName.MyMeetings.API.Modules.Meetings.MeetingComments\n{\n [Route(\"api/meetings/[controller]\")]\n [ApiController]\n public class MeetingCommentsController : ControllerBase\n {\n private readonly IMeetingsModule _meetingModule;\n\n public MeetingCommentsController(IMeetingsModule meetingModule)\n {\n _meetingModule = meetingModule;\n }\n\n [HttpPost]\n [HasPermission(MeetingsPermissions.AddMeetingComment)]\n [ProducesResponseType(typeof(Guid), StatusCodes.Status200OK)]\n public async Task AddComment([FromBody] AddMeetingCommentRequest request)\n {\n var commentId =\n await _meetingModule.ExecuteCommandAsync(new AddMeetingCommentCommand(\n request.MeetingId,\n request.Comment));\n\n return Ok(commentId);\n }\n\n [HttpPut(\"{meetingCommentId}\")]\n [HasPermission(MeetingsPermissions.EditMeetingComment)]\n [ProducesResponseType(StatusCodes.Status200OK)]\n public async Task EditComment(\n [FromRoute] Guid meetingCommentId,\n [FromBody] EditMeetingCommentRequest request)\n {\n await _meetingModule.ExecuteCommandAsync(new EditMeetingCommentCommand(\n meetingCommentId,\n request.EditedComment));\n\n return Ok();\n }\n\n [HttpDelete(\"{meetingCommentId}\")]\n [HasPermission(MeetingsPermissions.RemoveMeetingComment)]\n [ProducesResponseType(StatusCodes.Status200OK)]\n public async Task DeleteComment([FromRoute] Guid meetingCommentId, [FromQuery] string reason)\n {\n await _meetingModule.ExecuteCommandAsync(\n new RemoveMeetingCommentCommand(meetingCommentId, reason));\n\n return Ok();\n }\n\n [HttpPost(\"{meetingCommentId}/replies\")]\n [HasPermission(MeetingsPermissions.AddMeetingCommentReply)]\n [ProducesResponseType(StatusCodes.Status200OK)]\n public async Task AddReply([FromRoute] Guid meetingCommentId, [FromBody] string reply)\n {\n await _meetingModule.ExecuteCommandAsync(new AddReplyToMeetingCommentCommand(meetingCommentId, reply));\n\n return Ok();\n }\n\n [HttpPost(\"{meetingCommentId}/likes\")]\n [HasPermission(MeetingsPermissions.LikeMeetingComment)]\n [ProducesResponseType(StatusCodes.Status200OK)]\n public async Task LikeComment([FromRoute] Guid meetingCommentId)\n {\n await _meetingModule.ExecuteCommandAsync(\n new AddMeetingCommentLikeCommand(meetingCommentId));\n\n return Ok();\n }\n\n [HttpDelete(\"{meetingCommentId}/likes\")]\n [HasPermission(MeetingsPermissions.UnlikeMeetingComment)]\n [ProducesResponseType(StatusCodes.Status200OK)]\n public async Task UnlikeComment([FromRoute] Guid meetingCommentId)\n {\n await _meetingModule.ExecuteCommandAsync(\n new RemoveMeetingCommentLikeCommand(meetingCommentId));\n\n return Ok();\n }\n }\n}\n"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Modules/Meetings/MeetingGroupProposals/MeetingGroupProposalsController.cs",
"content": "using CompanyName.MyMeetings.API.Configuration.Authorization;\nusing CompanyName.MyMeetings.Modules.Meetings.Application.Contracts;\nusing CompanyName.MyMeetings.Modules.Meetings.Application.MeetingGroupProposals.GetAllMeetingGroupProposals;\nusing CompanyName.MyMeetings.Modules.Meetings.Application.MeetingGroupProposals.GetMeetingGroupProposal;\nusing CompanyName.MyMeetings.Modules.Meetings.Application.MeetingGroupProposals.GetMemberMeetingGroupProposals;\nusing CompanyName.MyMeetings.Modules.Meetings.Application.MeetingGroupProposals.ProposeMeetingGroup;\nusing Microsoft.AspNetCore.Mvc;\n\nnamespace CompanyName.MyMeetings.API.Modules.Meetings.MeetingGroupProposals\n{\n [Route(\"api/meetings/[controller]\")]\n [ApiController]\n public class MeetingGroupProposalsController : ControllerBase\n {\n private readonly IMeetingsModule _meetingsModule;\n\n public MeetingGroupProposalsController(IMeetingsModule meetingsModule)\n {\n _meetingsModule = meetingsModule;\n }\n\n [HttpGet(\"\")]\n [HasPermission(MeetingsPermissions.GetMeetingGroupProposals)]\n [ProducesResponseType(typeof(List), StatusCodes.Status200OK)]\n public async Task GetMemberMeetingGroupProposals()\n {\n var meetingGroupProposals = await _meetingsModule.ExecuteQueryAsync(\n new GetMemberMeetingGroupProposalsQuery());\n\n return Ok(meetingGroupProposals);\n }\n\n [HttpGet(\"all\")]\n [HasPermission(MeetingsPermissions.GetMeetingGroupProposals)]\n [ProducesResponseType(typeof(List), StatusCodes.Status200OK)]\n public async Task GetAllMeetingGroupProposals(int? page, int? perPage)\n {\n var meetingGroupProposals = await _meetingsModule.ExecuteQueryAsync(\n new GetAllMeetingGroupProposalsQuery(page, perPage));\n\n return Ok(meetingGroupProposals);\n }\n\n [HttpPost(\"\")]\n [HasPermission(MeetingsPermissions.ProposeMeetingGroup)]\n [ProducesResponseType(StatusCodes.Status200OK)]\n public async Task ProposeMeetingGroup(ProposeMeetingGroupRequest request)\n {\n await _meetingsModule.ExecuteCommandAsync(\n new ProposeMeetingGroupCommand(\n request.Name,\n request.Description,\n request.LocationCity,\n request.LocationCountryCode));\n\n return Ok();\n }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Modules/Meetings/MeetingGroupProposals/ProposeMeetingGroupRequest.cs",
"content": "namespace CompanyName.MyMeetings.API.Modules.Meetings.MeetingGroupProposals\n{\n public class ProposeMeetingGroupRequest\n {\n public string Name { get; set; }\n\n public string Description { get; set; }\n\n public string LocationCity { get; set; }\n\n public string LocationCountryCode { get; set; }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Modules/Meetings/MeetingGroups/CreateNewMeetingGroupRequest.cs",
"content": "namespace CompanyName.MyMeetings.API.Modules.Meetings.MeetingGroups\n{\n public class CreateNewMeetingGroupRequest\n {\n public string Name { get; set; }\n\n public string Description { get; set; }\n\n public string LocationCity { get; set; }\n\n public string LocationCountry { get; set; }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Modules/Meetings/MeetingGroups/EditMeetingGroupGeneralAttributesRequest.cs",
"content": "namespace CompanyName.MyMeetings.API.Modules.Meetings.MeetingGroups\n{\n public class EditMeetingGroupGeneralAttributesRequest\n {\n public string Name { get; set; }\n\n public string Description { get; set; }\n\n public string LocationCity { get; set; }\n\n public string LocationCountry { get; set; }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Modules/Meetings/MeetingGroups/MeetingGroupsController.cs",
"content": "using CompanyName.MyMeetings.API.Configuration.Authorization;\nusing CompanyName.MyMeetings.Modules.Meetings.Application.Contracts;\nusing CompanyName.MyMeetings.Modules.Meetings.Application.MeetingGroups.EditMeetingGroupGeneralAttributes;\nusing CompanyName.MyMeetings.Modules.Meetings.Application.MeetingGroups.GetAllMeetingGroups;\nusing CompanyName.MyMeetings.Modules.Meetings.Application.MeetingGroups.GetAuthenticationMemberMeetingGroups;\nusing CompanyName.MyMeetings.Modules.Meetings.Application.MeetingGroups.GetMeetingGroupDetails;\nusing CompanyName.MyMeetings.Modules.Meetings.Application.MeetingGroups.JoinToGroup;\nusing CompanyName.MyMeetings.Modules.Meetings.Application.MeetingGroups.LeaveMeetingGroup;\nusing Microsoft.AspNetCore.Mvc;\n\nnamespace CompanyName.MyMeetings.API.Modules.Meetings.MeetingGroups\n{\n [Route(\"api/meetings/[controller]\")]\n [ApiController]\n public class MeetingGroupsController : ControllerBase\n {\n private readonly IMeetingsModule _meetingsModule;\n\n public MeetingGroupsController(IMeetingsModule meetingsModule)\n {\n _meetingsModule = meetingsModule;\n }\n\n [HttpGet(\"\")]\n [HasPermission(MeetingsPermissions.GetAuthenticatedMemberMeetingGroups)]\n [ProducesResponseType(typeof(List), StatusCodes.Status200OK)]\n public async Task GetAuthenticatedMemberMeetingGroups()\n {\n var meetingGroups = await _meetingsModule.ExecuteQueryAsync(\n new GetAuthenticationMemberMeetingGroupsQuery());\n\n return Ok(meetingGroups);\n }\n\n [HttpGet(\"{meetingGroupId}\")]\n [HasPermission(MeetingsPermissions.GetMeetingGroupDetails)]\n [ProducesResponseType(typeof(MeetingGroupDetailsDto), StatusCodes.Status200OK)]\n public async Task GetMeetingGroupDetails(Guid meetingGroupId)\n {\n var meetingGroupDetails = await _meetingsModule.ExecuteQueryAsync(\n new GetMeetingGroupDetailsQuery(meetingGroupId));\n\n return Ok(meetingGroupDetails);\n }\n\n [HttpGet(\"all\")]\n [HasPermission(MeetingsPermissions.GetAllMeetingGroups)]\n [ProducesResponseType(typeof(List), StatusCodes.Status200OK)]\n public async Task GetAllMeetingGroups()\n {\n var meetingGroups = await _meetingsModule.ExecuteQueryAsync(new GetAllMeetingGroupsQuery());\n\n return Ok(meetingGroups);\n }\n\n [HttpPut(\"{meetingGroupId}\")]\n [HasPermission(MeetingsPermissions.EditMeetingGroupGeneralAttributes)]\n [ProducesResponseType(StatusCodes.Status200OK)]\n public async Task EditMeetingGroupGeneralAttributes(\n [FromRoute] Guid meetingGroupId,\n [FromBody] EditMeetingGroupGeneralAttributesRequest request)\n {\n await _meetingsModule.ExecuteCommandAsync(new EditMeetingGroupGeneralAttributesCommand(\n meetingGroupId,\n request.Name,\n request.Description,\n request.LocationCity,\n request.LocationCountry));\n\n return Ok();\n }\n\n [HttpPost(\"{meetingGroupId}/members\")]\n [HasPermission(MeetingsPermissions.JoinToGroup)]\n [ProducesResponseType(StatusCodes.Status200OK)]\n public async Task JoinToGroup(Guid meetingGroupId)\n {\n await _meetingsModule.ExecuteCommandAsync(new JoinToGroupCommand(meetingGroupId));\n\n return Ok();\n }\n\n [HttpDelete(\"{meetingGroupId}/members\")]\n [HasPermission(MeetingsPermissions.LeaveMeetingGroup)]\n [ProducesResponseType(StatusCodes.Status200OK)]\n public async Task LeaveMeetingGroup(Guid meetingGroupId)\n {\n await _meetingsModule.ExecuteCommandAsync(new LeaveMeetingGroupCommand(meetingGroupId));\n\n return Ok();\n }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Modules/Meetings/Meetings/AddMeetingAttendeeRequest.cs",
"content": "namespace CompanyName.MyMeetings.API.Modules.Meetings.Meetings\n{\n public class AddMeetingAttendeeRequest\n {\n public int GuestsNumber { get; set; }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Modules/Meetings/Meetings/ChangeMeetingMainAttributesRequest.cs",
"content": "namespace CompanyName.MyMeetings.API.Modules.Meetings.Meetings\n{\n public class ChangeMeetingMainAttributesRequest\n {\n public Guid MeetingId { get; set; }\n\n public string Title { get; set; }\n\n public DateTime TermStartDate { get; set; }\n\n public DateTime TermEndDate { get; set; }\n\n public string Description { get; set; }\n\n public string MeetingLocationName { get; set; }\n\n public string MeetingLocationAddress { get; set; }\n\n public string MeetingLocationPostalCode { get; set; }\n\n public string MeetingLocationCity { get; set; }\n\n public int? AttendeesLimit { get; set; }\n\n public int GuestsLimit { get; set; }\n\n public DateTime? RSVPTermStartDate { get; set; }\n\n public DateTime? RSVPTermEndDate { get; set; }\n\n public decimal? EventFeeValue { get; set; }\n\n public string EventFeeCurrency { get; set; }\n\n public List HostMemberIds { get; set; }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Modules/Meetings/Meetings/CreateMeetingRequest.cs",
"content": "namespace CompanyName.MyMeetings.API.Modules.Meetings.Meetings\n{\n public class CreateMeetingRequest\n {\n public Guid MeetingGroupId { get; set; }\n\n public string Title { get; set; }\n\n public DateTime TermStartDate { get; set; }\n\n public DateTime TermEndDate { get; set; }\n\n public string Description { get; set; }\n\n public string MeetingLocationName { get; set; }\n\n public string MeetingLocationAddress { get; set; }\n\n public string MeetingLocationPostalCode { get; set; }\n\n public string MeetingLocationCity { get; set; }\n\n public int? AttendeesLimit { get; set; }\n\n public int GuestsLimit { get; set; }\n\n public DateTime? RSVPTermStartDate { get; set; }\n\n public DateTime? RSVPTermEndDate { get; set; }\n\n public decimal? EventFeeValue { get; set; }\n\n public string EventFeeCurrency { get; set; }\n\n public List HostMemberIds { get; set; }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Modules/Meetings/Meetings/MeetingsController.cs",
"content": "using CompanyName.MyMeetings.API.Configuration.Authorization;\nusing CompanyName.MyMeetings.Modules.Meetings.Application.Contracts;\nusing CompanyName.MyMeetings.Modules.Meetings.Application.Meetings.AddMeetingAttendee;\nusing CompanyName.MyMeetings.Modules.Meetings.Application.Meetings.AddMeetingNotAttendee;\nusing CompanyName.MyMeetings.Modules.Meetings.Application.Meetings.CancelMeeting;\nusing CompanyName.MyMeetings.Modules.Meetings.Application.Meetings.ChangeMeetingMainAttributes;\nusing CompanyName.MyMeetings.Modules.Meetings.Application.Meetings.ChangeNotAttendeeDecision;\nusing CompanyName.MyMeetings.Modules.Meetings.Application.Meetings.CreateMeeting;\nusing CompanyName.MyMeetings.Modules.Meetings.Application.Meetings.GetAuthenticatedMemberMeetings;\nusing CompanyName.MyMeetings.Modules.Meetings.Application.Meetings.GetMeetingAttendees;\nusing CompanyName.MyMeetings.Modules.Meetings.Application.Meetings.GetMeetingDetails;\nusing CompanyName.MyMeetings.Modules.Meetings.Application.Meetings.RemoveMeetingAttendee;\nusing CompanyName.MyMeetings.Modules.Meetings.Application.Meetings.SetMeetingAttendeeRole;\nusing CompanyName.MyMeetings.Modules.Meetings.Application.Meetings.SetMeetingHostRole;\nusing CompanyName.MyMeetings.Modules.Meetings.Application.Meetings.SignOffMemberFromWaitlist;\nusing CompanyName.MyMeetings.Modules.Meetings.Application.Meetings.SignUpMemberToWaitlist;\nusing Microsoft.AspNetCore.Mvc;\n\nnamespace CompanyName.MyMeetings.API.Modules.Meetings.Meetings\n{\n [Route(\"api/meetings/meetings\")]\n [ApiController]\n public class MeetingsController : ControllerBase\n {\n private readonly IMeetingsModule _meetingsModule;\n\n public MeetingsController(IMeetingsModule meetingsModule)\n {\n _meetingsModule = meetingsModule;\n }\n\n [HttpGet(\"\")]\n [HasPermission(MeetingsPermissions.GetAuthenticatedMemberMeetings)]\n [ProducesResponseType(typeof(List), StatusCodes.Status200OK)]\n public async Task GetAuthenticatedMemberMeetings()\n {\n var meetings = await _meetingsModule.ExecuteQueryAsync(new GetAuthenticatedMemberMeetingsQuery());\n\n return Ok(meetings);\n }\n\n [HttpGet(\"{meetingId}\")]\n [HasPermission(MeetingsPermissions.GetMeetingDetails)]\n [ProducesResponseType(typeof(MeetingDetailsDto), StatusCodes.Status200OK)]\n public async Task GetMeetingDetails(Guid meetingId)\n {\n var meetingDetails = await _meetingsModule.ExecuteQueryAsync(new GetMeetingDetailsQuery(meetingId));\n\n return Ok(meetingDetails);\n }\n\n [HttpPost(\"\")]\n [HasPermission(MeetingsPermissions.CreateNewMeeting)]\n [ProducesResponseType(StatusCodes.Status200OK)]\n public async Task CreateNewMeeting([FromBody] CreateMeetingRequest request)\n {\n await _meetingsModule.ExecuteCommandAsync(new CreateMeetingCommand(\n request.MeetingGroupId,\n request.Title,\n request.TermStartDate,\n request.TermEndDate,\n request.Description,\n request.MeetingLocationName,\n request.MeetingLocationAddress,\n request.MeetingLocationPostalCode,\n request.MeetingLocationCity,\n request.AttendeesLimit,\n request.GuestsLimit,\n request.RSVPTermStartDate,\n request.RSVPTermEndDate,\n request.EventFeeValue,\n request.EventFeeCurrency,\n request.HostMemberIds));\n\n return Ok();\n }\n\n [HttpPut(\"{meetingId}\")]\n [HasPermission(MeetingsPermissions.EditMeeting)]\n [ProducesResponseType(StatusCodes.Status200OK)]\n public async Task EditMeeting(\n [FromRoute] Guid meetingId,\n [FromBody] ChangeMeetingMainAttributesRequest mainAttributesRequest)\n {\n await _meetingsModule.ExecuteCommandAsync(new ChangeMeetingMainAttributesCommand(\n meetingId,\n mainAttributesRequest.Title,\n mainAttributesRequest.TermStartDate,\n mainAttributesRequest.TermEndDate,\n mainAttributesRequest.Description,\n mainAttributesRequest.MeetingLocationName,\n mainAttributesRequest.MeetingLocationAddress,\n mainAttributesRequest.MeetingLocationPostalCode,\n mainAttributesRequest.MeetingLocationCity,\n mainAttributesRequest.AttendeesLimit,\n mainAttributesRequest.GuestsLimit,\n mainAttributesRequest.RSVPTermStartDate,\n mainAttributesRequest.RSVPTermEndDate,\n mainAttributesRequest.EventFeeValue,\n mainAttributesRequest.EventFeeCurrency));\n\n return Ok();\n }\n\n [HttpGet(\"{meetingId}/attendees\")]\n [HasPermission(MeetingsPermissions.GetMeetingAttendees)]\n [ProducesResponseType(typeof(List), StatusCodes.Status200OK)]\n public async Task GetMeetingAttendees(Guid meetingId)\n {\n var meetingAttendees = await _meetingsModule.ExecuteQueryAsync(new GetMeetingAttendeesQuery(meetingId));\n\n return Ok(meetingAttendees);\n }\n\n [HttpPost(\"{meetingId}/attendees\")]\n [HasPermission(MeetingsPermissions.AddMeetingAttendee)]\n [ProducesResponseType(StatusCodes.Status200OK)]\n public async Task AddMeetingAttendee(\n [FromRoute] Guid meetingId,\n [FromBody] AddMeetingAttendeeRequest attendeeRequest)\n {\n await _meetingsModule.ExecuteCommandAsync(new AddMeetingAttendeeCommand(\n meetingId,\n attendeeRequest.GuestsNumber));\n\n return Ok();\n }\n\n [HttpDelete(\"{meetingId}/attendees/{attendeeId}\")]\n [HasPermission(MeetingsPermissions.RemoveMeetingAttendee)]\n [ProducesResponseType(StatusCodes.Status200OK)]\n public async Task RemoveMeetingAttendee(\n Guid meetingId,\n Guid attendeeId,\n RemoveMeetingAttendeeRequest request)\n {\n await _meetingsModule.ExecuteCommandAsync(\n new RemoveMeetingAttendeeCommand(meetingId, attendeeId, request.RemovingReason));\n\n return Ok();\n }\n\n [HttpPost(\"{meetingId}/notAttendees\")]\n [HasPermission(MeetingsPermissions.AddNotAttendee)]\n [ProducesResponseType(StatusCodes.Status200OK)]\n public async Task AddNotAttendee(Guid meetingId)\n {\n await _meetingsModule.ExecuteCommandAsync(new AddMeetingNotAttendeeCommand(meetingId));\n\n return Ok();\n }\n\n [HttpDelete(\"{meetingId}/notAttendees\")]\n [HasPermission(MeetingsPermissions.ChangeNotAttendeeDecision)]\n [ProducesResponseType(StatusCodes.Status200OK)]\n public async Task ChangeNotAttendeeDecision(Guid meetingId)\n {\n await _meetingsModule.ExecuteCommandAsync(new ChangeNotAttendeeDecisionCommand(meetingId));\n\n return Ok();\n }\n\n [HttpPost(\"{meetingId}/waitlistMembers\")]\n [HasPermission(MeetingsPermissions.SignUpMemberToWaitlist)]\n [ProducesResponseType(StatusCodes.Status200OK)]\n public async Task SignUpMemberToWaitlist(Guid meetingId)\n {\n await _meetingsModule.ExecuteCommandAsync(new SignUpMemberToWaitlistCommand(meetingId));\n\n return Ok();\n }\n\n [HttpDelete(\"{meetingId}/waitlistMembers\")]\n [HasPermission(MeetingsPermissions.SignOffMemberFromWaitlist)]\n [ProducesResponseType(StatusCodes.Status200OK)]\n public async Task SignOffMemberFromWaitlist(Guid meetingId)\n {\n await _meetingsModule.ExecuteCommandAsync(new SignOffMemberFromWaitlistCommand(meetingId));\n\n return Ok();\n }\n\n [HttpPost(\"{meetingId}/hosts\")]\n [HasPermission(MeetingsPermissions.SetMeetingHostRole)]\n [ProducesResponseType(StatusCodes.Status200OK)]\n public async Task SetMeetingHostRole(Guid meetingId, SetMeetingHostRequest request)\n {\n await _meetingsModule.ExecuteCommandAsync(new SetMeetingHostRoleCommand(request.AttendeeId, meetingId));\n\n return Ok();\n }\n\n [HttpPost(\"{meetingId}/attendees/attendeeRole\")]\n [HasPermission(MeetingsPermissions.SetMeetingAttendeeRole)]\n [ProducesResponseType(StatusCodes.Status200OK)]\n public async Task SetMeetingAttendeeRole(Guid meetingId, SetMeetingHostRequest request)\n {\n await _meetingsModule.ExecuteCommandAsync(new SetMeetingAttendeeRoleCommand(request.AttendeeId, meetingId));\n\n return Ok();\n }\n\n [HttpPatch(\"{meetingId}/cancel\")]\n [HasPermission(MeetingsPermissions.CancelMeeting)]\n [ProducesResponseType(StatusCodes.Status200OK)]\n public async Task CancelMeeting(Guid meetingId)\n {\n await _meetingsModule.ExecuteCommandAsync(new CancelMeetingCommand(meetingId));\n\n return Ok();\n }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Modules/Meetings/Meetings/RemoveMeetingAttendeeRequest.cs",
"content": "namespace CompanyName.MyMeetings.API.Modules.Meetings.Meetings\n{\n public class RemoveMeetingAttendeeRequest\n {\n public string RemovingReason { get; set; }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Modules/Meetings/Meetings/SetMeetingAttendeeRequest.cs",
"content": "namespace CompanyName.MyMeetings.API.Modules.Meetings.Meetings\n{\n public class SetMeetingAttendeeRequest\n {\n public Guid AttendeeId { get; set; }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Modules/Meetings/Meetings/SetMeetingHostRequest.cs",
"content": "namespace CompanyName.MyMeetings.API.Modules.Meetings.Meetings\n{\n public class SetMeetingHostRequest\n {\n public Guid AttendeeId { get; set; }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Modules/Meetings/MeetingsAutofacModule.cs",
"content": "using Autofac;\nusing CompanyName.MyMeetings.Modules.Meetings.Application.Contracts;\nusing CompanyName.MyMeetings.Modules.Meetings.Infrastructure;\n\nnamespace CompanyName.MyMeetings.API.Modules.Meetings\n{\n public class MeetingsAutofacModule : Module\n {\n protected override void Load(ContainerBuilder builder)\n {\n builder.RegisterType()\n .As()\n .InstancePerLifetimeScope();\n }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Modules/Meetings/MeetingsPermissions.cs",
"content": "namespace CompanyName.MyMeetings.API.Modules.Meetings\n{\n public class MeetingsPermissions\n {\n public const string GetMeetingGroupProposals = \"GetMeetingGroupProposals\";\n public const string ProposeMeetingGroup = \"ProposeMeetingGroup\";\n public const string CreateNewMeeting = \"CreateNewMeeting\";\n public const string EditMeeting = \"EditMeeting\";\n public const string AddMeetingAttendee = \"AddMeetingAttendee\";\n public const string RemoveMeetingAttendee = \"RemoveMeetingAttendee\";\n public const string AddNotAttendee = \"AddNotAttendee\";\n public const string ChangeNotAttendeeDecision = \"ChangeNotAttendeeDecision\";\n public const string SignUpMemberToWaitlist = \"SignUpMemberToWaitlist\";\n public const string SignOffMemberFromWaitlist = \"SignOffMemberFromWaitlist\";\n public const string SetMeetingHostRole = \"SetMeetingHostRole\";\n public const string SetMeetingAttendeeRole = \"SetMeetingAttendeeRole\";\n public const string CancelMeeting = \"CancelMeeting\";\n public const string GetAllMeetingGroups = \"GetAllMeetingGroups\";\n public const string EditMeetingGroupGeneralAttributes = \"EditMeetingGroupGeneralAttributes\";\n public const string JoinToGroup = \"JoinToGroup\";\n public const string LeaveMeetingGroup = \"LeaveMeetingGroup\";\n public const string AddMeetingComment = \"AddMeetingComment\";\n public const string EditMeetingComment = \"EditMeetingComment\";\n public const string RemoveMeetingComment = \"RemoveMeetingComment\";\n public const string AddMeetingCommentReply = \"AddMeetingCommentReply\";\n public const string LikeMeetingComment = \"LikeMeetingComment\";\n public const string UnlikeMeetingComment = \"UnlikeMeetingComment\";\n public const string EnableMeetingCommenting = \"EnableMeetingCommenting\";\n public const string DisableMeetingCommenting = \"DisableMeetingCommenting\";\n public const string GetAuthenticatedMemberMeetingGroups = \"GetAuthenticatedMemberMeetingGroups\";\n public const string GetMeetingGroupDetails = \"GetMeetingGroupDetails\";\n public const string GetMeetingDetails = \"GetMeetingDetails\";\n public const string GetAuthenticatedMemberMeetings = \"GetAuthenticatedMemberMeetings\";\n public const string GetMeetingAttendees = \"GetMeetingAttendees\";\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Modules/Payments/MeetingFees/CreateMeetingFeePaymentRequest.cs",
"content": "namespace CompanyName.MyMeetings.API.Modules.Payments.MeetingFees\n{\n public class CreateMeetingFeePaymentRequest\n {\n public Guid MeetingFeeId { get; set; }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Modules/Payments/MeetingFees/MeetingFeePaymentsController.cs",
"content": "using CompanyName.MyMeetings.API.Configuration.Authorization;\nusing CompanyName.MyMeetings.Modules.Payments.Application.Contracts;\nusing CompanyName.MyMeetings.Modules.Payments.Application.MeetingFees.CreateMeetingFeePayment;\nusing CompanyName.MyMeetings.Modules.Payments.Application.MeetingFees.MarkMeetingFeePaymentAsPaid;\nusing Microsoft.AspNetCore.Mvc;\n\nnamespace CompanyName.MyMeetings.API.Modules.Payments.MeetingFees\n{\n [Route(\"api/payments/meetingFeePayments\")]\n [ApiController]\n public class MeetingFeePaymentsController : ControllerBase\n {\n private readonly IPaymentsModule _meetingsModule;\n\n public MeetingFeePaymentsController(IPaymentsModule meetingsModule)\n {\n _meetingsModule = meetingsModule;\n }\n\n [HttpPost]\n [HasPermission(PaymentsPermissions.RegisterPayment)]\n [ProducesResponseType(StatusCodes.Status200OK)]\n public async Task CreateMeetingFeePayment(CreateMeetingFeePaymentRequest request)\n {\n await _meetingsModule.ExecuteCommandAsync(new CreateMeetingFeePaymentCommand(request.MeetingFeeId));\n\n return Ok();\n }\n\n [HttpPut]\n [Route(\"{meetingFeePaymentId}/purchased\")]\n [HasPermission(PaymentsPermissions.RegisterPayment)]\n [ProducesResponseType(StatusCodes.Status200OK)]\n public async Task RegisterMeetingFeePayment(\n Guid meetingFeePaymentId)\n {\n await _meetingsModule.ExecuteCommandAsync(new MarkMeetingFeePaymentAsPaidCommand(meetingFeePaymentId));\n\n return Ok();\n }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Modules/Payments/MeetingFees/RegisterMeetingFeePaymentRequest.cs",
"content": "namespace CompanyName.MyMeetings.API.Modules.Payments.MeetingFees\n{\n public class RegisterMeetingFeePaymentRequest\n {\n public Guid PaymentId { get; set; }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Modules/Payments/Payers/PayersController.cs",
"content": "using CompanyName.MyMeetings.API.Configuration.Authorization;\nusing CompanyName.MyMeetings.Modules.Payments.Application.Contracts;\nusing CompanyName.MyMeetings.Modules.Payments.Application.Subscriptions.GetPayerSubscription;\nusing CompanyName.MyMeetings.Modules.Payments.Application.Subscriptions.GetSubscriptionDetails;\nusing Microsoft.AspNetCore.Mvc;\n\nnamespace CompanyName.MyMeetings.API.Modules.Payments.Payers\n{\n [Route(\"api/payments/payers\")]\n [ApiController]\n public class PayersController : ControllerBase\n {\n private readonly IPaymentsModule _paymentsModule;\n\n public PayersController(IPaymentsModule paymentsModule)\n {\n _paymentsModule = paymentsModule;\n }\n\n [HttpGet(\"authenticated/subscription\")]\n [HasPermission(PaymentsPermissions.GetAuthenticatedPayerSubscription)]\n [ProducesResponseType(typeof(SubscriptionDetailsDto), StatusCodes.Status200OK)]\n public async Task GetAuthenticatedPayerSubscription()\n {\n var subscription = await _paymentsModule.ExecuteQueryAsync(new GetAuthenticatedPayerSubscriptionQuery());\n\n return Ok(subscription);\n }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Modules/Payments/PaymentsAutofacModule.cs",
"content": "using Autofac;\nusing CompanyName.MyMeetings.Modules.Payments.Application.Contracts;\nusing CompanyName.MyMeetings.Modules.Payments.Infrastructure;\n\nnamespace CompanyName.MyMeetings.API.Modules.Payments\n{\n public class PaymentsAutofacModule : Module\n {\n protected override void Load(ContainerBuilder builder)\n {\n builder.RegisterType()\n .As()\n .InstancePerLifetimeScope();\n }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Modules/Payments/PaymentsPermissions.cs",
"content": "namespace CompanyName.MyMeetings.API.Modules.Payments\n{\n public class PaymentsPermissions\n {\n public const string RegisterPayment = \"RegisterPayment\";\n public const string BuySubscription = \"BuySubscription\";\n public const string RenewSubscription = \"RenewSubscription\";\n public const string CreatePriceListItem = \"CreatePriceListItem\";\n public const string ActivatePriceListItem = \"ActivatePriceListItem\";\n public const string DeactivatePriceListItem = \"DeactivatePriceListItem\";\n public const string ChangePriceListItemAttributes = \"ChangePriceListItemAttributes\";\n public const string GetAuthenticatedPayerSubscription = \"GetAuthenticatedPayerSubscription\";\n public const string GetPriceListItem = \"GetPriceListItem\";\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Modules/Payments/PriceListItems/ChangePriceListItemAttributesRequest.cs",
"content": "namespace CompanyName.MyMeetings.API.Modules.Payments.PriceListItems\n{\n public class ChangePriceListItemAttributesRequest\n {\n public Guid PriceListItemId { get; set; }\n\n public string CountryCode { get; set; }\n\n public string SubscriptionPeriodCode { get; set; }\n\n public string CategoryCode { get; set; }\n\n public decimal PriceValue { get; set; }\n\n public string PriceCurrency { get; set; }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Modules/Payments/PriceListItems/CreatePriceListItemRequest.cs",
"content": "namespace CompanyName.MyMeetings.API.Modules.Payments.PriceListItems\n{\n public class CreatePriceListItemRequest\n {\n public string CountryCode { get; set; }\n\n public string SubscriptionPeriodCode { get; set; }\n\n public string CategoryCode { get; set; }\n\n public decimal PriceValue { get; set; }\n\n public string PriceCurrency { get; set; }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Modules/Payments/PriceListItems/GetPriceListItemRequest.cs",
"content": "namespace CompanyName.MyMeetings.API.Modules.Payments.PriceListItems\n{\n public class GetPriceListItemRequest\n {\n public string CountryCode { get; set; }\n\n public string CategoryCode { get; set; }\n\n public string PeriodTypeCode { get; set; }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Modules/Payments/PriceListItems/PriceListItemsController.cs",
"content": "using CompanyName.MyMeetings.API.Configuration.Authorization;\nusing CompanyName.MyMeetings.Modules.Payments.Application.Contracts;\nusing CompanyName.MyMeetings.Modules.Payments.Application.PriceListItems.ActivatePriceListItem;\nusing CompanyName.MyMeetings.Modules.Payments.Application.PriceListItems.ChangePriceListItemAttributes;\nusing CompanyName.MyMeetings.Modules.Payments.Application.PriceListItems.CreatePriceListItem;\nusing CompanyName.MyMeetings.Modules.Payments.Application.PriceListItems.DeactivatePriceListItem;\nusing CompanyName.MyMeetings.Modules.Payments.Application.PriceListItems.GetPriceListItem;\nusing Microsoft.AspNetCore.Mvc;\n\nnamespace CompanyName.MyMeetings.API.Modules.Payments.PriceListItems\n{\n [ApiController]\n [Route(\"api/payments/priceListItems\")]\n public class PriceListItemsController : ControllerBase\n {\n private readonly IPaymentsModule _paymentsModule;\n\n public PriceListItemsController(IPaymentsModule paymentsModule)\n {\n _paymentsModule = paymentsModule;\n }\n\n [HttpGet]\n [HasPermission(PaymentsPermissions.GetPriceListItem)]\n [ProducesResponseType(typeof(PriceListItemMoneyValueDto), StatusCodes.Status200OK)]\n public async Task GetPriceListItem([FromQuery] GetPriceListItemRequest request)\n {\n var priceListItem = await _paymentsModule.ExecuteQueryAsync(new GetPriceListItemQuery(\n request.CountryCode,\n request.CategoryCode,\n request.PeriodTypeCode));\n\n return Ok(priceListItem);\n }\n\n [HttpPost]\n [HasPermission(PaymentsPermissions.CreatePriceListItem)]\n [ProducesResponseType(StatusCodes.Status200OK)]\n public async Task CreatePriceListItem([FromBody] CreatePriceListItemRequest request)\n {\n await _paymentsModule.ExecuteCommandAsync(new CreatePriceListItemCommand(\n request.SubscriptionPeriodCode,\n request.CategoryCode,\n request.CountryCode,\n request.PriceValue,\n request.PriceCurrency));\n\n return Ok();\n }\n\n [HttpPatch(\"{priceListItemId}/activate\")]\n [HasPermission(PaymentsPermissions.ActivatePriceListItem)]\n [ProducesResponseType(StatusCodes.Status200OK)]\n public async Task ActivatePriceListItem([FromRoute] Guid priceListItemId)\n {\n await _paymentsModule.ExecuteCommandAsync(new ActivatePriceListItemCommand(priceListItemId));\n\n return Ok();\n }\n\n [HttpPatch(\"{priceListItemId}/deactivate\")]\n [HasPermission(PaymentsPermissions.DeactivatePriceListItem)]\n [ProducesResponseType(StatusCodes.Status200OK)]\n public async Task DeactivatePriceListItem([FromRoute] Guid priceListItemId)\n {\n await _paymentsModule.ExecuteCommandAsync(new DeactivatePriceListItemCommand(priceListItemId));\n\n return Ok();\n }\n\n [HttpPut]\n [HasPermission(PaymentsPermissions.ChangePriceListItemAttributes)]\n [ProducesResponseType(StatusCodes.Status200OK)]\n public async Task ChangePriceListItemAttributes(\n [FromBody] ChangePriceListItemAttributesRequest request)\n {\n await _paymentsModule.ExecuteCommandAsync(new ChangePriceListItemAttributesCommand(\n request.PriceListItemId,\n request.CountryCode,\n request.SubscriptionPeriodCode,\n request.CategoryCode,\n request.PriceValue,\n request.PriceCurrency));\n\n return Ok();\n }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Modules/Payments/RegisterSubscriptionRenewalPaymentRequest.cs",
"content": "namespace CompanyName.MyMeetings.API.Modules.Payments\n{\n public class RegisterSubscriptionRenewalPaymentRequest\n {\n public Guid PaymentId { get; set; }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Modules/Payments/SubscriptionRenewalsController.cs",
"content": "using CompanyName.MyMeetings.API.Configuration.Authorization;\nusing CompanyName.MyMeetings.Modules.Payments.Application.Contracts;\nusing CompanyName.MyMeetings.Modules.Payments.Application.Subscriptions.MarkSubscriptionRenewalPaymentAsPaid;\nusing Microsoft.AspNetCore.Mvc;\n\nnamespace CompanyName.MyMeetings.API.Modules.Payments\n{\n [Route(\"api/payments/subscriptionRenewals\")]\n [ApiController]\n public class SubscriptionRenewalsController : ControllerBase\n {\n private readonly IPaymentsModule _paymentsModule;\n\n public SubscriptionRenewalsController(IPaymentsModule paymentsModule)\n {\n _paymentsModule = paymentsModule;\n }\n\n [HttpPost]\n [HasPermission(PaymentsPermissions.RegisterPayment)]\n public async Task RegisterSubscriptionPayment(RegisterSubscriptionRenewalPaymentRequest request)\n {\n await _paymentsModule.ExecuteCommandAsync(\n new MarkSubscriptionRenewalPaymentAsPaidCommand(request.PaymentId));\n\n return Ok();\n }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Modules/Payments/Subscriptions/BuySubscriptionRequest.cs",
"content": "namespace CompanyName.MyMeetings.API.Modules.Payments.Subscriptions\n{\n public class BuySubscriptionRequest\n {\n public string SubscriptionTypeCode { get; set; }\n\n public string CountryCode { get; set; }\n\n public decimal Value { get; set; }\n\n public string Currency { get; set; }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Modules/Payments/Subscriptions/RegisterSubscriptionPaymentRequest.cs",
"content": "namespace CompanyName.MyMeetings.API.Modules.Payments.Subscriptions\n{\n public class RegisterSubscriptionPaymentRequest\n {\n public Guid PaymentId { get; set; }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Modules/Payments/Subscriptions/RenewSubscriptionRequest.cs",
"content": "namespace CompanyName.MyMeetings.API.Modules.Payments.Subscriptions\n{\n public class RenewSubscriptionRequest\n {\n public string SubscriptionTypeCode { get; set; }\n\n public string CountryCode { get; set; }\n\n public decimal Value { get; set; }\n\n public string Currency { get; set; }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Modules/Payments/Subscriptions/SubscriptionPaymentsController.cs",
"content": "using CompanyName.MyMeetings.API.Configuration.Authorization;\nusing CompanyName.MyMeetings.Modules.Payments.Application.Contracts;\nusing CompanyName.MyMeetings.Modules.Payments.Application.Subscriptions.MarkSubscriptionPaymentAsPaid;\nusing Microsoft.AspNetCore.Mvc;\n\nnamespace CompanyName.MyMeetings.API.Modules.Payments.Subscriptions\n{\n [Route(\"api/payments/subscriptionPayments\")]\n [ApiController]\n public class SubscriptionPaymentsController : ControllerBase\n {\n private readonly IPaymentsModule _meetingsModule;\n\n public SubscriptionPaymentsController(IPaymentsModule meetingsModule)\n {\n _meetingsModule = meetingsModule;\n }\n\n [HttpPost]\n [HasPermission(PaymentsPermissions.RegisterPayment)]\n [ProducesResponseType(StatusCodes.Status200OK)]\n public async Task RegisterSubscriptionPayment(RegisterSubscriptionPaymentRequest request)\n {\n await _meetingsModule.ExecuteCommandAsync(new MarkSubscriptionPaymentAsPaidCommand(request.PaymentId));\n\n return Ok();\n }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Modules/Payments/Subscriptions/SubscriptionsController.cs",
"content": "using CompanyName.MyMeetings.API.Configuration.Authorization;\nusing CompanyName.MyMeetings.Modules.Payments.Application.Contracts;\nusing CompanyName.MyMeetings.Modules.Payments.Application.Subscriptions.BuySubscription;\nusing CompanyName.MyMeetings.Modules.Payments.Application.Subscriptions.BuySubscriptionRenewal;\nusing Microsoft.AspNetCore.Mvc;\n\nnamespace CompanyName.MyMeetings.API.Modules.Payments.Subscriptions\n{\n [Route(\"api/payments/subscriptions\")]\n [ApiController]\n public class SubscriptionsController : ControllerBase\n {\n private readonly IPaymentsModule _meetingsModule;\n\n public SubscriptionsController(IPaymentsModule meetingsModule)\n {\n _meetingsModule = meetingsModule;\n }\n\n [HttpPost(\"\")]\n [HasPermission(PaymentsPermissions.BuySubscription)]\n public async Task BuySubscription(BuySubscriptionRequest request)\n {\n var paymentId = await _meetingsModule.ExecuteCommandAsync(\n new BuySubscriptionCommand(\n request.SubscriptionTypeCode,\n request.CountryCode,\n request.Value,\n request.Currency));\n\n return Ok(paymentId);\n }\n\n [HttpPost(\"{subscriptionId}/renewals\")]\n [HasPermission(PaymentsPermissions.RenewSubscription)]\n public async Task RenewSubscription(\n Guid subscriptionId,\n RenewSubscriptionRequest request)\n {\n await _meetingsModule.ExecuteCommandAsync(\n new BuySubscriptionRenewalCommand(\n subscriptionId,\n request.SubscriptionTypeCode,\n request.CountryCode,\n request.Value,\n request.Currency));\n\n return Accepted();\n }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Modules/UserAccess/AuthenticatedUserController.cs",
"content": "using CompanyName.MyMeetings.API.Configuration.Authorization;\nusing CompanyName.MyMeetings.Modules.UserAccess.Application.Authorization.GetAuthenticatedUserPermissions;\nusing CompanyName.MyMeetings.Modules.UserAccess.Application.Authorization.GetUserPermissions;\nusing CompanyName.MyMeetings.Modules.UserAccess.Application.Contracts;\nusing CompanyName.MyMeetings.Modules.UserAccess.Application.Users.GetAuthenticatedUser;\nusing CompanyName.MyMeetings.Modules.UserAccess.Application.Users.GetUser;\nusing Microsoft.AspNetCore.Mvc;\n\nnamespace CompanyName.MyMeetings.API.Modules.UserAccess\n{\n [Route(\"api/userAccess/authenticatedUser\")]\n [ApiController]\n public class AuthenticatedUserController : ControllerBase\n {\n private readonly IUserAccessModule _userAccessModule;\n\n public AuthenticatedUserController(IUserAccessModule userAccessModule)\n {\n _userAccessModule = userAccessModule;\n }\n\n [NoPermissionRequired]\n [HttpGet(\"\")]\n [ProducesResponseType(typeof(UserDto), StatusCodes.Status200OK)]\n public async Task GetAuthenticatedUser()\n {\n var user = await _userAccessModule.ExecuteQueryAsync(new GetAuthenticatedUserQuery());\n\n return Ok(user);\n }\n\n [NoPermissionRequired]\n [HttpGet(\"permissions\")]\n [ProducesResponseType(typeof(List), StatusCodes.Status200OK)]\n public async Task GetAuthenticatedUserPermissions()\n {\n var permissions = await _userAccessModule.ExecuteQueryAsync(new GetAuthenticatedUserPermissionsQuery());\n\n return Ok(permissions);\n }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Modules/UserAccess/EmailsController.cs",
"content": "using CompanyName.MyMeetings.API.Configuration.Authorization;\nusing CompanyName.MyMeetings.Modules.UserAccess.Application.Contracts;\nusing CompanyName.MyMeetings.Modules.UserAccess.Application.Emails;\nusing Microsoft.AspNetCore.Authorization;\nusing Microsoft.AspNetCore.Mvc;\n\nnamespace CompanyName.MyMeetings.API.Modules.UserAccess\n{\n [Route(\"api/userAccess/emails\")]\n [ApiController]\n public class EmailsController : ControllerBase\n {\n private readonly IUserAccessModule _userAccessModule;\n\n public EmailsController(IUserAccessModule userAccessModule)\n {\n _userAccessModule = userAccessModule;\n }\n\n [NoPermissionRequired]\n [AllowAnonymous]\n [HttpGet(\"\")]\n public async Task GetEmails()\n {\n var allEmails = await _userAccessModule.ExecuteQueryAsync(new GetAllEmailsQuery());\n\n return Ok(allEmails);\n }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Modules/UserAccess/RegisterNewUserRequest.cs",
"content": "namespace CompanyName.MyMeetings.API.Modules.UserAccess\n{\n public class RegisterNewUserRequest\n {\n public string Login { get; set; }\n\n public string Password { get; set; }\n\n public string Email { get; set; }\n\n public string FirstName { get; set; }\n\n public string LastName { get; set; }\n\n public string ConfirmLink { get; set; }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Modules/UserAccess/UserAccessAutofacModule.cs",
"content": "using Autofac;\nusing CompanyName.MyMeetings.Modules.UserAccess.Application.Contracts;\nusing CompanyName.MyMeetings.Modules.UserAccess.Infrastructure;\n\nnamespace CompanyName.MyMeetings.API.Modules.UserAccess\n{\n public class UserAccessAutofacModule : Module\n {\n protected override void Load(ContainerBuilder builder)\n {\n builder.RegisterType()\n .As()\n .InstancePerLifetimeScope();\n }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Modules/UserAccess/UserRegistrationsController.cs",
"content": "using CompanyName.MyMeetings.API.Configuration.Authorization;\nusing CompanyName.MyMeetings.Modules.Registrations.Application.Contracts;\nusing CompanyName.MyMeetings.Modules.Registrations.Application.UserRegistrations.ConfirmUserRegistration;\nusing CompanyName.MyMeetings.Modules.Registrations.Application.UserRegistrations.RegisterNewUser;\nusing CompanyName.MyMeetings.Modules.UserAccess.Application.Contracts;\nusing Microsoft.AspNetCore.Authorization;\nusing Microsoft.AspNetCore.Mvc;\n\nnamespace CompanyName.MyMeetings.API.Modules.UserAccess\n{\n [Route(\"userAccess/[controller]\")]\n [ApiController]\n public class UserRegistrationsController : ControllerBase\n {\n private readonly IRegistrationsModule _registrationsModule;\n\n public UserRegistrationsController(IRegistrationsModule registrationsModule)\n {\n _registrationsModule = registrationsModule;\n }\n\n [NoPermissionRequired]\n [AllowAnonymous]\n [HttpPost(\"\")]\n [ProducesResponseType(StatusCodes.Status200OK)]\n public async Task RegisterNewUser(RegisterNewUserRequest request)\n {\n await _registrationsModule.ExecuteCommandAsync(new RegisterNewUserCommand(\n request.Login,\n request.Password,\n request.Email,\n request.FirstName,\n request.LastName,\n request.ConfirmLink));\n\n return Ok();\n }\n\n [NoPermissionRequired]\n [AllowAnonymous]\n [HttpPatch(\"{userRegistrationId}/confirm\")]\n [ProducesResponseType(StatusCodes.Status200OK)]\n public async Task ConfirmRegistration(Guid userRegistrationId)\n {\n await _registrationsModule.ExecuteCommandAsync(new ConfirmUserRegistrationCommand(userRegistrationId));\n\n return Ok();\n }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Program.cs",
"content": "using Autofac.Extensions.DependencyInjection;\n\nnamespace CompanyName.MyMeetings.API\n{\n public class Program\n {\n public static void Main(string[] args)\n {\n CreateWebHostBuilder(args).Build().Run();\n }\n\n public static IHostBuilder CreateWebHostBuilder(string[] args)\n {\n return Host.CreateDefaultBuilder(args)\n .UseServiceProviderFactory(new AutofacServiceProviderFactory())\n .ConfigureWebHostDefaults(\n webBuilder => { webBuilder.UseStartup(); });\n }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Properties/launchSettings.json",
"content": "{\n \"iisSettings\": {\n \"windowsAuthentication\": false,\n \"anonymousAuthentication\": true,\n \"iisExpress\": {\n \"applicationUrl\": \"http://localhost:57869\",\n \"sslPort\": 44368\n }\n },\n \"$schema\": \"http://json.schemastore.org/launchsettings.json\",\n \"profiles\": {\n \"IIS Express\": {\n \"commandName\": \"IISExpress\",\n \"launchBrowser\": true,\n \"launchUrl\": \"api/values\",\n \"environmentVariables\": {\n \"ASPNETCORE_ENVIRONMENT\": \"Development\"\n }\n },\n \"DevWorkshops.Meetings.API\": {\n \"commandName\": \"Project\",\n \"launchBrowser\": true,\n \"launchUrl\": \"swagger\",\n \"environmentVariables\": {\n \"ASPNETCORE_ENVIRONMENT\": \"Development\"\n },\n \"applicationUrl\": \"http://localhost:5000\"\n },\n \"Docker\": {\n \"commandName\": \"Docker\",\n \"launchBrowser\": true,\n \"launchUrl\": \"{Scheme}://{ServiceHost}:{ServicePort}/api/values\",\n \"publishAllPorts\": true,\n \"useSSL\": true\n }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/Startup.cs",
"content": "using Autofac;\nusing Autofac.Extensions.DependencyInjection;\nusing CompanyName.MyMeetings.API.Configuration.Authorization;\nusing CompanyName.MyMeetings.API.Configuration.ExecutionContext;\nusing CompanyName.MyMeetings.API.Configuration.Extensions;\nusing CompanyName.MyMeetings.API.Configuration.Validation;\nusing CompanyName.MyMeetings.API.Modules.Administration;\nusing CompanyName.MyMeetings.API.Modules.Meetings;\nusing CompanyName.MyMeetings.API.Modules.Payments;\nusing CompanyName.MyMeetings.API.Modules.UserAccess;\nusing CompanyName.MyMeetings.BuildingBlocks.Application;\nusing CompanyName.MyMeetings.BuildingBlocks.Domain;\nusing CompanyName.MyMeetings.BuildingBlocks.Infrastructure.Emails;\nusing CompanyName.MyMeetings.Modules.Administration.Infrastructure.Configuration;\nusing CompanyName.MyMeetings.Modules.Meetings.Infrastructure.Configuration;\nusing CompanyName.MyMeetings.Modules.Payments.Infrastructure.Configuration;\nusing CompanyName.MyMeetings.Modules.Registrations.Infrastructure.Configuration;\nusing CompanyName.MyMeetings.Modules.UserAccess.Infrastructure.Configuration;\nusing CompanyName.MyMeetings.Modules.UserAccess.Infrastructure.Configuration.Identity;\nusing Hellang.Middleware.ProblemDetails;\nusing Microsoft.AspNetCore.Authentication;\nusing Microsoft.AspNetCore.Authorization;\nusing Microsoft.AspNetCore.Server.HttpSys;\nusing Serilog;\nusing Serilog.Formatting.Compact;\nusing ILogger = Serilog.ILogger;\n\nnamespace CompanyName.MyMeetings.API\n{\n public class Startup\n {\n private const string MeetingsConnectionString = \"MeetingsConnectionString\";\n private static ILogger _logger;\n private static ILogger _loggerForApi;\n private readonly IConfiguration _configuration;\n\n public Startup(IWebHostEnvironment env)\n {\n ConfigureLogger();\n\n _configuration = new ConfigurationBuilder()\n .AddJsonFile(\"appsettings.json\")\n .AddJsonFile($\"appsettings.{env.EnvironmentName}.json\")\n .AddUserSecrets()\n .AddEnvironmentVariables(\"Meetings_\")\n .Build();\n\n _loggerForApi.Information(\"Connection string:\" + _configuration.GetConnectionString(MeetingsConnectionString));\n\n AuthorizationChecker.CheckAllEndpoints();\n }\n\n public void ConfigureServices(IServiceCollection services)\n {\n services.AddControllers();\n\n services.AddSwaggerDocumentation();\n\n services.ConfigureIdentityService();\n\n services.AddSingleton();\n services.AddSingleton();\n\n services.AddProblemDetails(x =>\n {\n x.Map(ex => new InvalidCommandProblemDetails(ex));\n x.Map(ex => new BusinessRuleValidationExceptionProblemDetails(ex));\n });\n\n services.AddAuthorization(options =>\n {\n options.AddPolicy(HasPermissionAttribute.HasPermissionPolicyName, policyBuilder =>\n {\n policyBuilder.Requirements.Add(new HasPermissionAuthorizationRequirement());\n policyBuilder.AddAuthenticationSchemes(\"Bearer\");\n });\n });\n\n services.AddScoped();\n }\n\n public void ConfigureContainer(ContainerBuilder containerBuilder)\n {\n containerBuilder.RegisterModule(new MeetingsAutofacModule());\n containerBuilder.RegisterModule(new AdministrationAutofacModule());\n containerBuilder.RegisterModule(new UserAccessAutofacModule());\n containerBuilder.RegisterModule(new PaymentsAutofacModule());\n }\n\n // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.\n public void Configure(IApplicationBuilder app, IWebHostEnvironment env, IServiceProvider serviceProvider)\n {\n var container = app.ApplicationServices.GetAutofacRoot();\n\n app.UseCors(builder =>\n builder.AllowAnyOrigin().AllowAnyHeader().AllowAnyMethod());\n\n InitializeModules(container);\n\n app.UseMiddleware();\n\n app.UseSwaggerDocumentation();\n\n app.AddIdentityService();\n\n if (env.IsDevelopment())\n {\n app.UseProblemDetails();\n }\n else\n {\n // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.\n app.UseHsts();\n }\n\n app.UseHttpsRedirection();\n\n app.UseRouting();\n\n // app.UseAuthentication();\n app.UseAuthorization();\n\n app.UseEndpoints(endpoints => { endpoints.MapControllers(); });\n }\n\n private static void ConfigureLogger()\n {\n _logger = new LoggerConfiguration()\n .Enrich.FromLogContext()\n .WriteTo.Console(\n outputTemplate:\n \"[{Timestamp:HH:mm:ss} {Level:u3}] [{Module}] [{Context}] {Message:lj}{NewLine}{Exception}\")\n .WriteTo.File(new CompactJsonFormatter(), \"logs/logs\")\n .CreateLogger();\n\n _loggerForApi = _logger.ForContext(\"Module\", \"API\");\n\n _loggerForApi.Information(\"Logger configured\");\n }\n\n private void InitializeModules(ILifetimeScope container)\n {\n var httpContextAccessor = container.Resolve();\n var executionContextAccessor = new ExecutionContextAccessor(httpContextAccessor);\n\n var emailsConfiguration = new EmailsConfiguration(_configuration[\"EmailsConfiguration:FromEmail\"]);\n\n MeetingsStartup.Initialize(\n _configuration.GetConnectionString(MeetingsConnectionString),\n executionContextAccessor,\n _logger,\n emailsConfiguration,\n null);\n\n AdministrationStartup.Initialize(\n _configuration.GetConnectionString(MeetingsConnectionString),\n executionContextAccessor,\n _logger,\n null);\n\n UserAccessStartup.Initialize(\n _configuration.GetConnectionString(MeetingsConnectionString),\n executionContextAccessor,\n _logger,\n emailsConfiguration,\n _configuration[\"Security:TextEncryptionKey\"],\n null,\n null);\n\n PaymentsStartup.Initialize(\n _configuration.GetConnectionString(MeetingsConnectionString),\n executionContextAccessor,\n _logger,\n emailsConfiguration,\n null);\n\n RegistrationsStartup.Initialize(\n _configuration.GetConnectionString(MeetingsConnectionString),\n executionContextAccessor,\n _logger,\n emailsConfiguration,\n _configuration[\"Security:TextEncryptionKey\"],\n null,\n null);\n }\n }\n}"
},
{
"path": "src/API/CompanyName.MyMeetings.API/appsettings.Development.json",
"content": "{\n \"Logging\": {\n \"LogLevel\": {\n \"Default\": \"Debug\",\n \"System\": \"Information\",\n \"Microsoft\": \"Information\"\n }\n }\n}\n"
},
{
"path": "src/API/CompanyName.MyMeetings.API/appsettings.Production.json",
"content": "{\n \"Logging\": {\n \"LogLevel\": {\n \"Default\": \"Debug\",\n \"System\": \"Information\",\n \"Microsoft\": \"Information\"\n }\n }\n}\n"
},
{
"path": "src/API/CompanyName.MyMeetings.API/appsettings.json",
"content": "{\n \"Logging\": {\n \"LogLevel\": {\n \"Default\": \"Trace\",\n \"System\": \"Information\",\n \"Microsoft\": \"None\"\n }\n\n },\n \"AllowedHosts\": \"*\",\n\n \"EmailsConfiguration\": {\n \"FromEmail\": \"no-reply@mymeetings.com\"\n },\n \"Security\": {\n /* NOTE! This is sensitive data and should be stored in secure way (not here). Added only for demo purpose. */\n \"TextEncryptionKey\": \"E546C8DF278CK5990069B522\"\n },\n \"ConnectionStrings\": {\n \"MeetingsConnectionString\": \"YourConnectioString\"\n }\n}\n"
},
{
"path": "src/API/CompanyName.MyMeetings.API/entrypoint.sh",
"content": "#!/bin/bash\nsleep 30 ;\n\ndotnet CompanyName.MyMeetings.API.dll"
},
{
"path": "src/API/CompanyName.MyMeetings.API/tempkey.rsa",
"content": "{\"KeyId\":\"6962297f9adb377dadb20e11b9d82f6c\",\"Parameters\":{\"D\":\"k4wzTPOMjoB3/gKcu/IGMXrLgZlmPR7NbtUb22Dkw8xhUMVGBV2fE7zEEZyR+jkvKTQbzL+vOA9pmAOxtgZk3AnB1c3ntreZjB3tjYdshglRq7I1VhVDdxJ6e8jwcXqdUhUMiXdYScdkA/jKUO9Ls1XVKA4iXl7fJ3nMhLNgsCXAzuS824XvDGEGJ6FZxjCNfGtTIgoZPFTyJvkHAqQ+Ll72BYdb0vS3gY7wNlAYScHdfBOhmeirvkN4Z9uXp1E/m+QGGlfgm7Eqdt0d4AjMQ8BeNR3wrMB4B5QN6ssP0ENVqIDSLxnq4NLL74fiqgBcFlu3nqSRcqgPB0tvMah2aQ==\",\"DP\":\"fTAwFVELf2DVCALpwParCuCChyFRgBWbgHanv4oRstuHHe2hgbasAKnXF+dO00D6k3Kvh5xFKlHr+e3W4hFI7nGM47DfVOX0L+DhsC2sa4qCHpMNU0EpJdrnASpPWWfBAiQPae+VC4WbzJQy1LOoH8Juqm5FqG8evZJ7otMzB9s=\",\"DQ\":\"hBz7Jz9TQoKsV//0KfXMlRFqO3v1qVe4A8b7knrTCL/0IjaD1edZvx3G6H6zkKXZkkXHVTYnJHMxIRm3Ds8C6EYwt9jfNtodQundv9w8xTKNJTemLKLtp9IuBBbL3X4dwZdriiI4woDRhe+ZD5fP25ElqbBlDC4ra1/N6KJUREU=\",\"Exponent\":\"AQAB\",\"InverseQ\":\"MrVycQYUEcmT6ddtkiXV4L3Qg+1iXgIbFF5OAtgXkD+lI+rclgUnFTYG3qgUhMn/ZtV/HhpW2FavUKCsmyv2Lmd1nVHe4LjgAjpKu9NlkripI/ROw8SculZEisI7P2lcAVI5kUSAQumiQg7kQcDqrTnrTI/T5m5LuygcGoYo3kA=\",\"Modulus\":\"nCbBW8+F6FuisseukkmknunroSMyJ8oi/yRyqWWBiVwiWYkvT88SfASyBLciDPXtV0PXsGkmxGyD4z/cQa5O5xU/gRHS3BKvxmuBribI+6JGBF1ukXoMooGIKEunDArgKb8O1bWDX7MyxU8sxyok73qOvtIqEb+ENKd1bFnP4PH/Yi3ZgHyTGcKfdRuB80WJQf8g9p1SFecg4Hhrh+j8XGeQow46bHgoKHelGSFlC6MFt12k0HISfty1AnHxrUP1IT5YpEWIDHNiexqJgc5Q2Bw9Tworux3sR6hQUh588NWSPw/9nhWT/l6AGifp7nJqiIEtgvrhWeVtUXJgZkWgnQ==\",\"P\":\"xSulQHBrGbZPrSqKiPBORAdK+ZHqg0VD6i9pCbzjDBWYGRS/ekbF/JQR81p/Wrm/K6hi1+eeDElZPK2e4WfyqQqVeDs6QQMjXjpSA/65WWdTDjNL7So2fYSUV70dwawo/EWtY1JHmBGEcKKDbeNGMwrP44iGQhE7wsGLQFB1NM8=\",\"Q\":\"yr34862ggc3OsYi8JFy83fmwiurGQc25+0U1UtiT0jhadSXcg+XEHjWUKTpHVJEIF+DKV+lwXTEtF5lsa1BAl5hHDwgcY19TJkaF4QIsfNMp0/s5iWNRdRhWKoqp9QGKxTOF9jpCeJgj0MUwLcFLZQ+UvWnqLv3yjsJ+De69xtM=\"}}"
},
{
"path": "src/API/RequestExamples/Authentication.http",
"content": "### Authenticate Member\nPOST {{baseUrl}}/connect/token\nContent-Type: application/x-www-form-urlencoded\n\ngrant_type=password&username=testMember@mail.com&password=testMemberPass&client_id=ro.client&client_secret=secret\n\n### Authenticate Admin\nPOST {{baseUrl}}/connect/token\nContent-Type: application/x-www-form-urlencoded\n\ngrant_type=password&username=testAdmin@mail.com&password=testAdminPass&client_id=ro.client&client_secret=secret\n\n\n"
},
{
"path": "src/API/RequestExamples/Users.http",
"content": "### Register a new user\nPOST {{baseUrl}}/userAccess/UserRegistrations\nContent-Type: application/json\n\n{\n \"Login\": \"login\",\n \"Password\": \"password\",\n \"Email\": \"email@mail.com\",\n \"FirstName\": \"John\",\n \"LastName\": \"Doe\",\n \"ConfirmLink\": \"Abc\"\n}\n\n\n### User registration confirmation\nPATCH {{baseUrl}}/userAccess/UserRegistrations/e80985c5-bf97-4bb3-b178-9423d70ef87b/confirm"
},
{
"path": "src/API/RequestExamples/http-client.env.json",
"content": "{\n \"dev\": {\n \"baseUrl\": \"http://localhost:5000\"\n }\n}"
},
{
"path": "src/BuildingBlocks/Application/CompanyName.MyMeetings.BuildingBlocks.Application.csproj",
"content": ""
},
{
"path": "src/BuildingBlocks/Application/Data/ISqlConnectionFactory.cs",
"content": "using System.Data;\n\nnamespace CompanyName.MyMeetings.BuildingBlocks.Application.Data\n{\n public interface ISqlConnectionFactory\n {\n IDbConnection GetOpenConnection();\n\n IDbConnection CreateNewConnection();\n\n string GetConnectionString();\n }\n}"
},
{
"path": "src/BuildingBlocks/Application/Emails/EmailMessage.cs",
"content": "namespace CompanyName.MyMeetings.BuildingBlocks.Application.Emails\n{\n public struct EmailMessage\n {\n public string To { get; }\n\n public string Subject { get; }\n\n public string Content { get; }\n\n public EmailMessage(\n string to,\n string subject,\n string content)\n {\n this.To = to;\n this.Subject = subject;\n this.Content = content;\n }\n }\n}"
},
{
"path": "src/BuildingBlocks/Application/Emails/IEmailSender.cs",
"content": "namespace CompanyName.MyMeetings.BuildingBlocks.Application.Emails\n{\n public interface IEmailSender\n {\n Task SendEmail(EmailMessage message);\n }\n}"
},
{
"path": "src/BuildingBlocks/Application/Events/DomainNotificationBase.cs",
"content": "using CompanyName.MyMeetings.BuildingBlocks.Domain;\n\nnamespace CompanyName.MyMeetings.BuildingBlocks.Application.Events\n{\n public class DomainNotificationBase : IDomainEventNotification\n where T : IDomainEvent\n {\n public T DomainEvent { get; }\n\n public Guid Id { get; }\n\n public DomainNotificationBase(T domainEvent, Guid id)\n {\n this.Id = id;\n this.DomainEvent = domainEvent;\n }\n }\n}"
},
{
"path": "src/BuildingBlocks/Application/Events/IDomainEventNotification.cs",
"content": "using MediatR;\n\nnamespace CompanyName.MyMeetings.BuildingBlocks.Application.Events\n{\n public interface IDomainEventNotification : IDomainEventNotification\n {\n TEventType DomainEvent { get; }\n }\n\n public interface IDomainEventNotification : INotification\n {\n Guid Id { get; }\n }\n}"
},
{
"path": "src/BuildingBlocks/Application/IExecutionContextAccessor.cs",
"content": "namespace CompanyName.MyMeetings.BuildingBlocks.Application\n{\n public interface IExecutionContextAccessor\n {\n Guid UserId { get; }\n\n Guid CorrelationId { get; }\n\n bool IsAvailable { get; }\n }\n}"
},
{
"path": "src/BuildingBlocks/Application/InvalidCommandException.cs",
"content": "namespace CompanyName.MyMeetings.BuildingBlocks.Application\n{\n public class InvalidCommandException : Exception\n {\n public List Errors { get; }\n\n public InvalidCommandException(List errors)\n {\n this.Errors = errors;\n }\n }\n}\n"
},
{
"path": "src/BuildingBlocks/Application/Outbox/IOutbox.cs",
"content": "namespace CompanyName.MyMeetings.BuildingBlocks.Application.Outbox\n{\n public interface IOutbox\n {\n void Add(OutboxMessage message);\n\n Task Save();\n }\n}"
},
{
"path": "src/BuildingBlocks/Application/Outbox/OutboxMessage.cs",
"content": "namespace CompanyName.MyMeetings.BuildingBlocks.Application.Outbox\n{\n public class OutboxMessage\n {\n public Guid Id { get; set; }\n\n public DateTime OccurredOn { get; set; }\n\n public string Type { get; set; }\n\n public string Data { get; set; }\n\n public DateTime? ProcessedDate { get; set; }\n\n public OutboxMessage(Guid id, DateTime occurredOn, string type, string data)\n {\n this.Id = id;\n this.OccurredOn = occurredOn;\n this.Type = type;\n this.Data = data;\n }\n\n private OutboxMessage()\n {\n }\n }\n}"
},
{
"path": "src/BuildingBlocks/Application/Queries/IPagedQuery.cs",
"content": "namespace CompanyName.MyMeetings.BuildingBlocks.Application.Queries\n{\n public interface IPagedQuery\n {\n /// \n /// Page number. If null then default is 1.\n /// \n int? Page { get; }\n\n /// \n /// Records number per page (page size).\n /// \n int? PerPage { get; }\n }\n}"
},
{
"path": "src/BuildingBlocks/Application/Queries/PageData.cs",
"content": "namespace CompanyName.MyMeetings.BuildingBlocks.Application.Queries\n{\n public struct PageData\n {\n public int Offset { get; }\n\n public int Next { get; }\n\n public PageData(int offset, int next)\n {\n this.Offset = offset;\n this.Next = next;\n }\n }\n}"
},
{
"path": "src/BuildingBlocks/Application/Queries/PagedQueryHelper.cs",
"content": "namespace CompanyName.MyMeetings.BuildingBlocks.Application.Queries\n{\n public static class PagedQueryHelper\n {\n public const string Offset = \"Offset\";\n\n public const string Next = \"Next\";\n\n public static PageData GetPageData(IPagedQuery query)\n {\n int offset;\n if (!query.Page.HasValue ||\n !query.PerPage.HasValue)\n {\n offset = 0;\n }\n else\n {\n offset = (query.Page.Value - 1) * query.PerPage.Value;\n }\n\n int next;\n if (!query.PerPage.HasValue)\n {\n next = int.MaxValue;\n }\n else\n {\n next = query.PerPage.Value;\n }\n\n return new PageData(offset, next);\n }\n\n public static string AppendPageStatement(string sql)\n {\n return $\"{sql} \" +\n $\"OFFSET @{Offset} ROWS FETCH NEXT @{Next} ROWS ONLY; \";\n }\n }\n}"
},
{
"path": "src/BuildingBlocks/Domain/BusinessRuleValidationException.cs",
"content": "namespace CompanyName.MyMeetings.BuildingBlocks.Domain\n{\n public class BusinessRuleValidationException : Exception\n {\n public IBusinessRule BrokenRule { get; }\n\n public string Details { get; }\n\n public BusinessRuleValidationException(IBusinessRule brokenRule)\n : base(brokenRule.Message)\n {\n BrokenRule = brokenRule;\n this.Details = brokenRule.Message;\n }\n\n public override string ToString()\n {\n return $\"{BrokenRule.GetType().FullName}: {BrokenRule.Message}\";\n }\n }\n}\n"
},
{
"path": "src/BuildingBlocks/Domain/CompanyName.MyMeetings.BuildingBlocks.Domain.csproj",
"content": ""
},
{
"path": "src/BuildingBlocks/Domain/DomainEventBase.cs",
"content": "namespace CompanyName.MyMeetings.BuildingBlocks.Domain\n{\n public class DomainEventBase : IDomainEvent\n {\n public Guid Id { get; }\n\n public DateTime OccurredOn { get; }\n\n public DomainEventBase()\n {\n this.Id = Guid.NewGuid();\n this.OccurredOn = DateTime.UtcNow;\n }\n }\n}"
},
{
"path": "src/BuildingBlocks/Domain/Entity.cs",
"content": "namespace CompanyName.MyMeetings.BuildingBlocks.Domain\n{\n public abstract class Entity\n {\n private List _domainEvents;\n\n /// \n /// Domain events occurred.\n /// \n public IReadOnlyCollection DomainEvents => _domainEvents?.AsReadOnly();\n\n public void ClearDomainEvents()\n {\n _domainEvents?.Clear();\n }\n\n /// \n /// Add domain event.\n /// \n /// Domain event.\n protected void AddDomainEvent(IDomainEvent domainEvent)\n {\n _domainEvents ??= [];\n\n this._domainEvents.Add(domainEvent);\n }\n\n protected void CheckRule(IBusinessRule rule)\n {\n if (rule.IsBroken())\n {\n throw new BusinessRuleValidationException(rule);\n }\n }\n }\n}\n"
},
{
"path": "src/BuildingBlocks/Domain/IAggregateRoot.cs",
"content": "namespace CompanyName.MyMeetings.BuildingBlocks.Domain\n{\n public interface IAggregateRoot\n {\n }\n}\n"
},
{
"path": "src/BuildingBlocks/Domain/IBusinessRule.cs",
"content": "namespace CompanyName.MyMeetings.BuildingBlocks.Domain\n{\n public interface IBusinessRule\n {\n bool IsBroken();\n\n string Message { get; }\n }\n}"
},
{
"path": "src/BuildingBlocks/Domain/IDomainEvent.cs",
"content": "using MediatR;\n\nnamespace CompanyName.MyMeetings.BuildingBlocks.Domain\n{\n public interface IDomainEvent : INotification\n {\n Guid Id { get; }\n\n DateTime OccurredOn { get; }\n }\n}"
},
{
"path": "src/BuildingBlocks/Domain/IgnoreMemberAttribute.cs",
"content": "namespace CompanyName.MyMeetings.BuildingBlocks.Domain\n{\n [AttributeUsage(AttributeTargets.Property | AttributeTargets.Field)]\n public class IgnoreMemberAttribute : Attribute\n {\n }\n}"
},
{
"path": "src/BuildingBlocks/Domain/TypedIdValueBase.cs",
"content": "namespace CompanyName.MyMeetings.BuildingBlocks.Domain\n{\n public abstract class TypedIdValueBase : IEquatable\n {\n public Guid Value { get; }\n\n protected TypedIdValueBase(Guid value)\n {\n if (value == Guid.Empty)\n {\n throw new InvalidOperationException(\"Id value cannot be empty!\");\n }\n\n Value = value;\n }\n\n public override bool Equals(object obj)\n {\n if (ReferenceEquals(null, obj))\n {\n return false;\n }\n\n return obj is TypedIdValueBase other && Equals(other);\n }\n\n public override int GetHashCode()\n {\n return Value.GetHashCode();\n }\n\n public bool Equals(TypedIdValueBase other)\n {\n return this.Value == other?.Value;\n }\n\n public static bool operator ==(TypedIdValueBase obj1, TypedIdValueBase obj2)\n {\n if (object.Equals(obj1, null))\n {\n if (object.Equals(obj2, null))\n {\n return true;\n }\n\n return false;\n }\n\n return obj1.Equals(obj2);\n }\n\n public static bool operator !=(TypedIdValueBase x, TypedIdValueBase y)\n {\n return !(x == y);\n }\n }\n}"
},
{
"path": "src/BuildingBlocks/Domain/ValueObject.cs",
"content": "using System.Reflection;\n\nnamespace CompanyName.MyMeetings.BuildingBlocks.Domain\n{\n public abstract class ValueObject : IEquatable\n {\n private List _properties;\n\n private List _fields;\n\n public static bool operator ==(ValueObject obj1, ValueObject obj2)\n {\n if (object.Equals(obj1, null))\n {\n if (object.Equals(obj2, null))\n {\n return true;\n }\n\n return false;\n }\n\n return obj1.Equals(obj2);\n }\n\n public static bool operator !=(ValueObject obj1, ValueObject obj2)\n {\n return !(obj1 == obj2);\n }\n\n public bool Equals(ValueObject obj)\n {\n return Equals(obj as object);\n }\n\n public override bool Equals(object obj)\n {\n if (obj == null || GetType() != obj.GetType())\n {\n return false;\n }\n\n return GetProperties().All(p => PropertiesAreEqual(obj, p))\n && GetFields().All(f => FieldsAreEqual(obj, f));\n }\n\n public override int GetHashCode()\n {\n unchecked\n {\n int hash = 17;\n foreach (var prop in GetProperties())\n {\n var value = prop.GetValue(this, null);\n hash = HashValue(hash, value);\n }\n\n foreach (var field in GetFields())\n {\n var value = field.GetValue(this);\n hash = HashValue(hash, value);\n }\n\n return hash;\n }\n }\n\n protected static void CheckRule(IBusinessRule rule)\n {\n if (rule.IsBroken())\n {\n throw new BusinessRuleValidationException(rule);\n }\n }\n\n private bool PropertiesAreEqual(object obj, PropertyInfo p)\n {\n return object.Equals(p.GetValue(this, null), p.GetValue(obj, null));\n }\n\n private bool FieldsAreEqual(object obj, FieldInfo f)\n {\n return object.Equals(f.GetValue(this), f.GetValue(obj));\n }\n\n private IEnumerable GetProperties()\n {\n if (this._properties == null)\n {\n this._properties = GetType()\n .GetProperties(BindingFlags.Instance | BindingFlags.Public)\n .Where(p => p.GetCustomAttribute(typeof(IgnoreMemberAttribute)) == null)\n .ToList();\n\n // Not available in Core\n // !Attribute.IsDefined(p, typeof(IgnoreMemberAttribute))).ToList();\n }\n\n return this._properties;\n }\n\n private IEnumerable GetFields()\n {\n if (this._fields == null)\n {\n this._fields = GetType().GetFields(BindingFlags.Instance | BindingFlags.Public | BindingFlags.NonPublic)\n .Where(p => p.GetCustomAttribute(typeof(IgnoreMemberAttribute)) == null)\n .ToList();\n }\n\n return this._fields;\n }\n\n private int HashValue(int seed, object value)\n {\n var currentHash = value?.GetHashCode() ?? 0;\n\n return (seed * 23) + currentHash;\n }\n }\n}"
},
{
"path": "src/BuildingBlocks/Infrastructure/BiDictionary.cs",
"content": "namespace CompanyName.MyMeetings.BuildingBlocks.Infrastructure\n{\n public class BiDictionary\n {\n private readonly IDictionary _firstToSecond = new Dictionary();\n\n private readonly IDictionary _secondToFirst = new Dictionary();\n\n public void Add(TFirst first, TSecond second)\n {\n if (_firstToSecond.ContainsKey(first) ||\n _secondToFirst.ContainsKey(second))\n {\n throw new ArgumentException(\"Duplicate first or second\");\n }\n\n _firstToSecond.Add(first, second);\n _secondToFirst.Add(second, first);\n }\n\n public bool TryGetByFirst(TFirst first, out TSecond second)\n {\n return _firstToSecond.TryGetValue(first, out second);\n }\n\n public bool TryGetBySecond(TSecond second, out TFirst first)\n {\n return _secondToFirst.TryGetValue(second, out first);\n }\n }\n}"
},
{
"path": "src/BuildingBlocks/Infrastructure/CompanyName.MyMeetings.BuildingBlocks.Infrastructure.csproj",
"content": ""
},
{
"path": "src/BuildingBlocks/Infrastructure/DomainEventsDispatching/DomainEventsAccessor.cs",
"content": "using CompanyName.MyMeetings.BuildingBlocks.Domain;\nusing Microsoft.EntityFrameworkCore;\n\nnamespace CompanyName.MyMeetings.BuildingBlocks.Infrastructure.DomainEventsDispatching\n{\n public class DomainEventsAccessor : IDomainEventsAccessor\n {\n private readonly DbContext _dbContext;\n\n public DomainEventsAccessor(DbContext dbContext)\n {\n _dbContext = dbContext;\n }\n\n public IReadOnlyCollection GetAllDomainEvents()\n {\n var domainEntities = this._dbContext.ChangeTracker\n .Entries()\n .Where(x => x.Entity.DomainEvents != null && x.Entity.DomainEvents.Any()).ToList();\n\n return domainEntities\n .SelectMany(x => x.Entity.DomainEvents)\n .ToList();\n }\n\n public void ClearAllDomainEvents()\n {\n var domainEntities = this._dbContext.ChangeTracker\n .Entries()\n .Where(x => x.Entity.DomainEvents != null && x.Entity.DomainEvents.Any()).ToList();\n\n domainEntities\n .ForEach(entity => entity.Entity.ClearDomainEvents());\n }\n }\n}"
},
{
"path": "src/BuildingBlocks/Infrastructure/DomainEventsDispatching/DomainEventsDispatcher.cs",
"content": "using Autofac;\nusing Autofac.Core;\nusing CompanyName.MyMeetings.BuildingBlocks.Application.Events;\nusing CompanyName.MyMeetings.BuildingBlocks.Application.Outbox;\nusing CompanyName.MyMeetings.BuildingBlocks.Domain;\nusing CompanyName.MyMeetings.BuildingBlocks.Infrastructure.Serialization;\nusing MediatR;\nusing Newtonsoft.Json;\n\nnamespace CompanyName.MyMeetings.BuildingBlocks.Infrastructure.DomainEventsDispatching\n{\n public class DomainEventsDispatcher : IDomainEventsDispatcher\n {\n private readonly IMediator _mediator;\n\n private readonly ILifetimeScope _scope;\n\n private readonly IOutbox _outbox;\n\n private readonly IDomainEventsAccessor _domainEventsProvider;\n\n private readonly IDomainNotificationsMapper _domainNotificationsMapper;\n\n public DomainEventsDispatcher(\n IMediator mediator,\n ILifetimeScope scope,\n IOutbox outbox,\n IDomainEventsAccessor domainEventsProvider,\n IDomainNotificationsMapper domainNotificationsMapper)\n {\n _mediator = mediator;\n _scope = scope;\n _outbox = outbox;\n _domainEventsProvider = domainEventsProvider;\n _domainNotificationsMapper = domainNotificationsMapper;\n }\n\n public async Task DispatchEventsAsync()\n {\n var domainEvents = _domainEventsProvider.GetAllDomainEvents();\n\n List> domainEventNotifications = [];\n foreach (var domainEvent in domainEvents)\n {\n Type domainEvenNotificationType = typeof(IDomainEventNotification<>);\n var domainNotificationWithGenericType = domainEvenNotificationType.MakeGenericType(domainEvent.GetType());\n var domainNotification = _scope.ResolveOptional(domainNotificationWithGenericType, new List\n {\n new NamedParameter(\"domainEvent\", domainEvent),\n new NamedParameter(\"id\", domainEvent.Id)\n });\n\n if (domainNotification != null)\n {\n domainEventNotifications.Add(domainNotification as IDomainEventNotification);\n }\n }\n\n _domainEventsProvider.ClearAllDomainEvents();\n\n foreach (var domainEvent in domainEvents)\n {\n await _mediator.Publish(domainEvent);\n }\n\n foreach (var domainEventNotification in domainEventNotifications)\n {\n var type = _domainNotificationsMapper.GetName(domainEventNotification.GetType());\n var data = JsonConvert.SerializeObject(domainEventNotification, new JsonSerializerSettings\n {\n ContractResolver = new AllPropertiesContractResolver()\n });\n\n var outboxMessage = new OutboxMessage(\n domainEventNotification.Id,\n domainEventNotification.DomainEvent.OccurredOn,\n type,\n data);\n\n _outbox.Add(outboxMessage);\n }\n }\n }\n}"
},
{
"path": "src/BuildingBlocks/Infrastructure/DomainEventsDispatching/DomainEventsDispatcherNotificationHandlerDecorator.cs",
"content": "using MediatR;\n\nnamespace CompanyName.MyMeetings.BuildingBlocks.Infrastructure.DomainEventsDispatching\n{\n public class DomainEventsDispatcherNotificationHandlerDecorator : INotificationHandler\n where T : INotification\n {\n private readonly INotificationHandler _decorated;\n private readonly IDomainEventsDispatcher _domainEventsDispatcher;\n\n public DomainEventsDispatcherNotificationHandlerDecorator(\n IDomainEventsDispatcher domainEventsDispatcher,\n INotificationHandler decorated)\n {\n _domainEventsDispatcher = domainEventsDispatcher;\n _decorated = decorated;\n }\n\n public async Task Handle(T notification, CancellationToken cancellationToken)\n {\n await this._decorated.Handle(notification, cancellationToken);\n\n await this._domainEventsDispatcher.DispatchEventsAsync();\n }\n }\n}"
},
{
"path": "src/BuildingBlocks/Infrastructure/DomainEventsDispatching/DomainNotificationsMapper.cs",
"content": "namespace CompanyName.MyMeetings.BuildingBlocks.Infrastructure.DomainEventsDispatching\n{\n public class DomainNotificationsMapper : IDomainNotificationsMapper\n {\n private readonly BiDictionary _domainNotificationsMap;\n\n public DomainNotificationsMapper(BiDictionary domainNotificationsMap)\n {\n _domainNotificationsMap = domainNotificationsMap;\n }\n\n public string GetName(Type type)\n {\n return _domainNotificationsMap.TryGetBySecond(type, out var name) ? name : null;\n }\n\n public Type GetType(string name)\n {\n return _domainNotificationsMap.TryGetByFirst(name, out var type) ? type : null;\n }\n }\n}"
},
{
"path": "src/BuildingBlocks/Infrastructure/DomainEventsDispatching/IDomainEventsAccessor.cs",
"content": "using CompanyName.MyMeetings.BuildingBlocks.Domain;\n\nnamespace CompanyName.MyMeetings.BuildingBlocks.Infrastructure.DomainEventsDispatching\n{\n public interface IDomainEventsAccessor\n {\n IReadOnlyCollection GetAllDomainEvents();\n\n void ClearAllDomainEvents();\n }\n}"
},
{
"path": "src/BuildingBlocks/Infrastructure/DomainEventsDispatching/IDomainEventsDispatcher.cs",
"content": "namespace CompanyName.MyMeetings.BuildingBlocks.Infrastructure.DomainEventsDispatching\n{\n public interface IDomainEventsDispatcher\n {\n Task DispatchEventsAsync();\n }\n}"
},
{
"path": "src/BuildingBlocks/Infrastructure/DomainEventsDispatching/IDomainNotificationsMapper.cs",
"content": "namespace CompanyName.MyMeetings.BuildingBlocks.Infrastructure.DomainEventsDispatching\n{\n public interface IDomainNotificationsMapper\n {\n string GetName(Type type);\n\n Type GetType(string name);\n }\n}"
},
{
"path": "src/BuildingBlocks/Infrastructure/DomainEventsDispatching/UnitOfWorkCommandHandlerDecorator.cs",
"content": "using MediatR;\r\n\r\nnamespace CompanyName.MyMeetings.BuildingBlocks.Infrastructure.DomainEventsDispatching\r\n{\r\n public class UnitOfWorkCommandHandlerDecorator : IRequestHandler\r\n where T : IRequest\r\n {\r\n private readonly IRequestHandler _decorated;\r\n private readonly IUnitOfWork _unitOfWork;\r\n\r\n public UnitOfWorkCommandHandlerDecorator(\r\n IRequestHandler decorated,\r\n IUnitOfWork unitOfWork)\r\n {\r\n _decorated = decorated;\r\n _unitOfWork = unitOfWork;\r\n }\r\n\r\n public async Task Handle(T command, CancellationToken cancellationToken)\r\n {\r\n await this._decorated.Handle(command, cancellationToken);\r\n\r\n await this._unitOfWork.CommitAsync(cancellationToken);\r\n }\r\n }\r\n}"
},
{
"path": "src/BuildingBlocks/Infrastructure/Emails/EmailSender.cs",
"content": "using CompanyName.MyMeetings.BuildingBlocks.Application.Data;\nusing CompanyName.MyMeetings.BuildingBlocks.Application.Emails;\nusing Dapper;\nusing Serilog;\n\nnamespace CompanyName.MyMeetings.BuildingBlocks.Infrastructure.Emails\n{\n public class EmailSender : IEmailSender\n {\n private readonly ILogger _logger;\n\n private readonly EmailsConfiguration _configuration;\n\n private readonly ISqlConnectionFactory _sqlConnectionFactory;\n\n public EmailSender(\n ILogger logger,\n EmailsConfiguration configuration,\n ISqlConnectionFactory sqlConnectionFactory)\n {\n _logger = logger;\n _configuration = configuration;\n _sqlConnectionFactory = sqlConnectionFactory;\n }\n\n public async Task SendEmail(EmailMessage message)\n {\n var sqlConnection = _sqlConnectionFactory.GetOpenConnection();\n\n await sqlConnection.ExecuteScalarAsync(\n \"INSERT INTO [app].[Emails] ([Id], [From], [To], [Subject], [Content], [Date]) \" +\n \"VALUES (@Id, @From, @To, @Subject, @Content, @Date) \",\n new\n {\n Id = Guid.NewGuid(),\n From = _configuration.FromEmail,\n message.To,\n message.Subject,\n message.Content,\n Date = DateTime.UtcNow\n });\n\n _logger.Information(\n \"Email sent. From: {From}, To: {To}, Subject: {Subject}, Content: {Content}.\",\n _configuration.FromEmail,\n message.To,\n message.Subject,\n message.Content);\n }\n }\n}"
},
{
"path": "src/BuildingBlocks/Infrastructure/Emails/EmailsConfiguration.cs",
"content": "namespace CompanyName.MyMeetings.BuildingBlocks.Infrastructure.Emails\n{\n public class EmailsConfiguration\n {\n public EmailsConfiguration(string fromEmail)\n {\n FromEmail = fromEmail;\n }\n\n public string FromEmail { get; }\n }\n}"
},
{
"path": "src/BuildingBlocks/Infrastructure/EventBus/IEventsBus.cs",
"content": "namespace CompanyName.MyMeetings.BuildingBlocks.Infrastructure.EventBus\n{\n public interface IEventsBus : IDisposable\n {\n Task Publish(T @event)\n where T : IntegrationEvent;\n\n void Subscribe(IIntegrationEventHandler handler)\n where T : IntegrationEvent;\n\n void StartConsuming();\n }\n}"
},
{
"path": "src/BuildingBlocks/Infrastructure/EventBus/IIntegrationEventHandler.cs",
"content": "namespace CompanyName.MyMeetings.BuildingBlocks.Infrastructure.EventBus\n{\n public interface IIntegrationEventHandler : IIntegrationEventHandler\n where TIntegrationEvent : IntegrationEvent\n {\n Task Handle(TIntegrationEvent @event);\n }\n\n public interface IIntegrationEventHandler\n {\n }\n}"
},
{
"path": "src/BuildingBlocks/Infrastructure/EventBus/InMemoryEventBus.cs",
"content": "namespace CompanyName.MyMeetings.BuildingBlocks.Infrastructure.EventBus\n{\n public sealed class InMemoryEventBus\n {\n static InMemoryEventBus()\n {\n }\n\n private InMemoryEventBus()\n {\n _handlersDictionary = new Dictionary>();\n }\n\n public static InMemoryEventBus Instance { get; } = new InMemoryEventBus();\n\n private readonly IDictionary> _handlersDictionary;\n\n public void Subscribe(IIntegrationEventHandler handler)\n where T : IntegrationEvent\n {\n var eventType = typeof(T).FullName;\n if (eventType != null)\n {\n if (_handlersDictionary.ContainsKey(eventType))\n {\n var handlers = _handlersDictionary[eventType];\n handlers.Add(handler);\n }\n else\n {\n _handlersDictionary.Add(eventType, [handler]);\n }\n }\n }\n\n public async Task Publish(T @event)\n where T : IntegrationEvent\n {\n var eventType = @event.GetType().FullName;\n\n if (eventType == null)\n {\n return;\n }\n\n List integrationEventHandlers = _handlersDictionary[eventType];\n\n foreach (var integrationEventHandler in integrationEventHandlers)\n {\n if (integrationEventHandler is IIntegrationEventHandler handler)\n {\n await handler.Handle(@event);\n }\n }\n }\n }\n}"
},
{
"path": "src/BuildingBlocks/Infrastructure/EventBus/InMemoryEventBusClient.cs",
"content": "using Serilog;\n\nnamespace CompanyName.MyMeetings.BuildingBlocks.Infrastructure.EventBus\n{\n public class InMemoryEventBusClient : IEventsBus\n {\n private readonly ILogger _logger;\n\n public InMemoryEventBusClient(ILogger logger)\n {\n _logger = logger;\n }\n\n public void Dispose()\n {\n }\n\n public async Task Publish(T @event)\n where T : IntegrationEvent\n {\n _logger.Information(\"Publishing {Event}\", @event.GetType().FullName);\n await InMemoryEventBus.Instance.Publish(@event);\n }\n\n public void Subscribe(IIntegrationEventHandler handler)\n where T : IntegrationEvent\n {\n InMemoryEventBus.Instance.Subscribe(handler);\n }\n\n public void StartConsuming()\n {\n }\n }\n}"
},
{
"path": "src/BuildingBlocks/Infrastructure/EventBus/IntegrationEvent.cs",
"content": "using MediatR;\n\nnamespace CompanyName.MyMeetings.BuildingBlocks.Infrastructure.EventBus\n{\n public abstract class IntegrationEvent : INotification\n {\n public Guid Id { get; }\n\n public DateTime OccurredOn { get; }\n\n protected IntegrationEvent(Guid id, DateTime occurredOn)\n {\n this.Id = id;\n this.OccurredOn = occurredOn;\n }\n }\n}"
},
{
"path": "src/BuildingBlocks/Infrastructure/IUnitOfWork.cs",
"content": "namespace CompanyName.MyMeetings.BuildingBlocks.Infrastructure\n{\n public interface IUnitOfWork\n {\n Task CommitAsync(\n CancellationToken cancellationToken = default,\n Guid? internalCommandId = null);\n }\n}"
},
{
"path": "src/BuildingBlocks/Infrastructure/Inbox/InboxMessage.cs",
"content": "namespace CompanyName.MyMeetings.BuildingBlocks.Infrastructure.Inbox\n{\n public class InboxMessage\n {\n public Guid Id { get; set; }\n\n public DateTime OccurredOn { get; set; }\n\n public string Type { get; set; }\n\n public string Data { get; set; }\n\n public DateTime? ProcessedDate { get; set; }\n\n public InboxMessage(DateTime occurredOn, string type, string data)\n {\n this.Id = Guid.NewGuid();\n this.OccurredOn = occurredOn;\n this.Type = type;\n this.Data = data;\n }\n\n private InboxMessage()\n {\n }\n }\n}"
},
{
"path": "src/BuildingBlocks/Infrastructure/InternalCommands/IInternalCommandsMapper.cs",
"content": "namespace CompanyName.MyMeetings.BuildingBlocks.Infrastructure.InternalCommands\n{\n public interface IInternalCommandsMapper\n {\n string GetName(Type type);\n\n Type GetType(string name);\n }\n}"
},
{
"path": "src/BuildingBlocks/Infrastructure/InternalCommands/InternalCommand.cs",
"content": "namespace CompanyName.MyMeetings.BuildingBlocks.Infrastructure.InternalCommands\n{\n public class InternalCommand\n {\n public Guid Id { get; set; }\n\n public string Type { get; set; }\n\n public string Data { get; set; }\n\n public DateTime? ProcessedDate { get; set; }\n }\n}"
},
{
"path": "src/BuildingBlocks/Infrastructure/InternalCommands/InternalCommandsMapper.cs",
"content": "namespace CompanyName.MyMeetings.BuildingBlocks.Infrastructure.InternalCommands\n{\n public class InternalCommandsMapper : IInternalCommandsMapper\n {\n private readonly BiDictionary _internalCommandsMap;\n\n public InternalCommandsMapper(BiDictionary internalCommandsMap)\n {\n _internalCommandsMap = internalCommandsMap;\n }\n\n public string GetName(Type type)\n {\n return _internalCommandsMap.TryGetBySecond(type, out var name) ? name : null;\n }\n\n public Type GetType(string name)\n {\n return _internalCommandsMap.TryGetByFirst(name, out var type) ? type : null;\n }\n }\n}"
},
{
"path": "src/BuildingBlocks/Infrastructure/Serialization/AllPropertiesContractResolver.cs",
"content": "using System.Reflection;\nusing Newtonsoft.Json;\nusing Newtonsoft.Json.Serialization;\n\nnamespace CompanyName.MyMeetings.BuildingBlocks.Infrastructure.Serialization\n{\n public class AllPropertiesContractResolver : DefaultContractResolver\n {\n protected override IList CreateProperties(Type type, MemberSerialization memberSerialization)\n {\n var properties = type.GetProperties(\n BindingFlags.Public |\n BindingFlags.NonPublic |\n BindingFlags.Instance)\n .Select(p => this.CreateProperty(p, memberSerialization))\n .ToList();\n\n properties.ForEach(p =>\n {\n p.Writable = true;\n p.Readable = true;\n });\n\n return properties;\n }\n }\n}"
},
{
"path": "src/BuildingBlocks/Infrastructure/ServiceProviderWrapper.cs",
"content": "using Autofac;\n\nnamespace CompanyName.MyMeetings.BuildingBlocks.Infrastructure\n{\n public class ServiceProviderWrapper : IServiceProvider\n {\n private readonly ILifetimeScope lifeTimeScope;\n\n public ServiceProviderWrapper(ILifetimeScope lifeTimeScope)\n {\n this.lifeTimeScope = lifeTimeScope;\n }\n\n #nullable enable\n public object? GetService(Type serviceType) => this.lifeTimeScope.ResolveOptional(serviceType);\n }\n}\n"
},
{
"path": "src/BuildingBlocks/Infrastructure/SqlConnectionFactory.cs",
"content": "using System.Data;\nusing System.Data.SqlClient;\nusing CompanyName.MyMeetings.BuildingBlocks.Application.Data;\n\nnamespace CompanyName.MyMeetings.BuildingBlocks.Infrastructure\n{\n public class SqlConnectionFactory : ISqlConnectionFactory, IDisposable\n {\n private readonly string _connectionString;\n private IDbConnection _connection;\n\n public SqlConnectionFactory(string connectionString)\n {\n this._connectionString = connectionString;\n }\n\n public IDbConnection GetOpenConnection()\n {\n if (this._connection == null || this._connection.State != ConnectionState.Open)\n {\n this._connection = new SqlConnection(_connectionString);\n this._connection.Open();\n }\n\n return this._connection;\n }\n\n public IDbConnection CreateNewConnection()\n {\n var connection = new SqlConnection(_connectionString);\n connection.Open();\n\n return connection;\n }\n\n public string GetConnectionString()\n {\n return _connectionString;\n }\n\n public void Dispose()\n {\n if (this._connection != null && this._connection.State == ConnectionState.Open)\n {\n this._connection.Dispose();\n }\n }\n }\n}"
},
{
"path": "src/BuildingBlocks/Infrastructure/StronglyTypedIdValueConverterSelector.cs",
"content": "using System.Collections.Concurrent;\nusing CompanyName.MyMeetings.BuildingBlocks.Domain;\nusing Microsoft.EntityFrameworkCore.Storage.ValueConversion;\n\nnamespace CompanyName.MyMeetings.BuildingBlocks.Infrastructure\n{\n /// \n /// Based on https://andrewlock.net/strongly-typed-ids-in-ef-core-using-strongly-typed-entity-ids-to-avoid-primitive-obsession-part-4/.\n /// \n public class StronglyTypedIdValueConverterSelector : ValueConverterSelector\n {\n private readonly ConcurrentDictionary<(Type ModelClrType, Type ProviderClrType), ValueConverterInfo> _converters\n = new ConcurrentDictionary<(Type ModelClrType, Type ProviderClrType), ValueConverterInfo>();\n\n public StronglyTypedIdValueConverterSelector(ValueConverterSelectorDependencies dependencies)\n : base(dependencies)\n {\n }\n\n public override IEnumerable Select(Type modelClrType, Type providerClrType = null)\n {\n var baseConverters = base.Select(modelClrType, providerClrType);\n foreach (var converter in baseConverters)\n {\n yield return converter;\n }\n\n var underlyingModelType = UnwrapNullableType(modelClrType);\n var underlyingProviderType = UnwrapNullableType(providerClrType);\n\n if (underlyingProviderType is null || underlyingProviderType == typeof(Guid))\n {\n var isTypedIdValue = typeof(TypedIdValueBase).IsAssignableFrom(underlyingModelType);\n if (isTypedIdValue)\n {\n var converterType = typeof(TypedIdValueConverter<>).MakeGenericType(underlyingModelType);\n\n yield return _converters.GetOrAdd((underlyingModelType, typeof(Guid)), _ =>\n {\n return new ValueConverterInfo(\n modelClrType: modelClrType,\n providerClrType: typeof(Guid),\n factory: valueConverterInfo => (ValueConverter)Activator.CreateInstance(converterType, valueConverterInfo.MappingHints));\n });\n }\n }\n }\n\n private static Type UnwrapNullableType(Type type)\n {\n if (type is null)\n {\n return null;\n }\n\n return Nullable.GetUnderlyingType(type) ?? type;\n }\n }\n}"
},
{
"path": "src/BuildingBlocks/Infrastructure/TypedIdValueConverter.cs",
"content": "using CompanyName.MyMeetings.BuildingBlocks.Domain;\nusing Microsoft.EntityFrameworkCore.Storage.ValueConversion;\n\nnamespace CompanyName.MyMeetings.BuildingBlocks.Infrastructure\n{\n public class TypedIdValueConverter : ValueConverter\n where TTypedIdValue : TypedIdValueBase\n {\n public TypedIdValueConverter(ConverterMappingHints mappingHints = null)\n : base(id => id.Value, value => Create(value), mappingHints)\n {\n }\n\n private static TTypedIdValue Create(Guid id) => Activator.CreateInstance(typeof(TTypedIdValue), id) as TTypedIdValue;\n }\n}"
},
{
"path": "src/BuildingBlocks/Infrastructure/UnitOfWork.cs",
"content": "using CompanyName.MyMeetings.BuildingBlocks.Infrastructure.DomainEventsDispatching;\nusing Microsoft.EntityFrameworkCore;\n\nnamespace CompanyName.MyMeetings.BuildingBlocks.Infrastructure\n{\n public class UnitOfWork : IUnitOfWork\n {\n private readonly DbContext _context;\n private readonly IDomainEventsDispatcher _domainEventsDispatcher;\n\n public UnitOfWork(\n DbContext context,\n IDomainEventsDispatcher domainEventsDispatcher)\n {\n this._context = context;\n this._domainEventsDispatcher = domainEventsDispatcher;\n }\n\n public async Task CommitAsync(\n CancellationToken cancellationToken = default,\n Guid? internalCommandId = null)\n {\n await this._domainEventsDispatcher.DispatchEventsAsync();\n\n return await _context.SaveChangesAsync(cancellationToken);\n }\n }\n}"
},
{
"path": "src/BuildingBlocks/Tests/Application.UnitTests/CompanyName.MyMeetings.BuildingBlocks.Application.UnitTests.csproj",
"content": "\n"
},
{
"path": "src/BuildingBlocks/Tests/Application.UnitTests/Queries/PagedQueryHelperTests.cs",
"content": "using CompanyName.MyMeetings.BuildingBlocks.Application.Queries;\nusing NUnit.Framework;\n\nnamespace CompanyName.MyMeetings.BuildingBlocks.Application.UnitTests.Queries\n{\n [TestFixture]\n public class PagedQueryHelperTests\n {\n [TestCase(1, 5, 0, 5)]\n [TestCase(3, 10, 20, 10)]\n [TestCase(null, 20, 0, 20)]\n [TestCase(5, null, 0, int.MaxValue)]\n [TestCase(null, null, 0, int.MaxValue)]\n public void PagedQueryHelper_GetPageData_Test(int? page, int? perPage, int offset, int next)\n {\n IPagedQuery query = new TestQuery(page, perPage);\n var pageData = PagedQueryHelper.GetPageData(query);\n\n Assert.That(pageData, Is.EqualTo(new PageData(offset, next)));\n }\n\n private class TestQuery : IPagedQuery\n {\n public TestQuery(int? page, int? perPage)\n {\n Page = page;\n PerPage = perPage;\n }\n\n public int? Page { get; }\n\n public int? PerPage { get; }\n }\n }\n}"
},
{
"path": "src/BuildingBlocks/Tests/IntegrationTests/CompanyName.MyMeetings.BuildingBlocks.IntegrationTests.csproj",
"content": ""
},
{
"path": "src/BuildingBlocks/Tests/IntegrationTests/EnvironmentVariablesProvider.cs",
"content": "namespace CompanyName.MyMeetings.BuildingBlocks.IntegrationTests\n{\n public static class EnvironmentVariablesProvider\n {\n public static string GetVariable(string variableName)\n {\n var environmentVariable = Environment.GetEnvironmentVariable(variableName);\n\n if (!string.IsNullOrEmpty(environmentVariable))\n {\n return environmentVariable;\n }\n\n environmentVariable = Environment.GetEnvironmentVariable(variableName, EnvironmentVariableTarget.User);\n\n if (!string.IsNullOrEmpty(environmentVariable))\n {\n return environmentVariable;\n }\n\n return Environment.GetEnvironmentVariable(variableName, EnvironmentVariableTarget.Machine);\n }\n }\n}"
},
{
"path": "src/BuildingBlocks/Tests/IntegrationTests/Probing/AssertErrorException.cs",
"content": "namespace CompanyName.MyMeetings.BuildingBlocks.IntegrationTests.Probing\n{\n public class AssertErrorException : Exception\n {\n public AssertErrorException(string message)\n : base(message)\n {\n }\n }\n}"
},
{
"path": "src/BuildingBlocks/Tests/IntegrationTests/Probing/IProbe.cs",
"content": "namespace CompanyName.MyMeetings.BuildingBlocks.IntegrationTests.Probing\n{\n public interface IProbe\n {\n bool IsSatisfied();\n\n Task SampleAsync();\n\n string DescribeFailureTo();\n }\n\n public interface IProbe\n {\n bool IsSatisfied(T sample);\n\n Task GetSampleAsync();\n\n string DescribeFailureTo();\n }\n}"
},
{
"path": "src/BuildingBlocks/Tests/IntegrationTests/Probing/Poller.cs",
"content": "namespace CompanyName.MyMeetings.BuildingBlocks.IntegrationTests.Probing\n{\n public class Poller\n {\n private readonly int _timeoutMillis;\n\n private readonly int _pollDelayMillis;\n\n public Poller(int timeoutMillis)\n {\n _timeoutMillis = timeoutMillis;\n _pollDelayMillis = 1000;\n }\n\n public async Task CheckAsync(IProbe probe)\n {\n var timeout = new Timeout(_timeoutMillis);\n while (!probe.IsSatisfied())\n {\n if (timeout.HasTimedOut())\n {\n throw new AssertErrorException(DescribeFailureOf(probe));\n }\n\n await Task.Delay(_pollDelayMillis);\n await probe.SampleAsync();\n }\n }\n\n public async Task GetAsync