---

Branch	Build status
master
develop

Let's go for the better, Collectively​​.

Collectively is an open platform to enhance communication between counties and its residents​. It's made as a fully open source & cross-platform solution by Noordwind.

Find out more at becollective.ly

Collectively.Services.Users

The Collectively.Services.Users is a service responsible for handling the user authentication & authorization, editing the account, changing and resetting password and other types of operations that are related to the user account.

Quick start

Docker way

Collectively is built as a set of microservices, therefore the easiest way is to run the whole system using the docker-compose.

Clone the Collectively.Docker repository and run the start.sh script:

git clone https://github.com/noordwind/Collectively.Docker
./start.sh

For the list of available services and their endpoints click here.

Classic way

In order to run the Collectively.Services.Users you need to have installed:

• .NET Core
• MongoDB
• RabbitMQ

Clone the repository and start the application via dotnet run --no-restore command:

git clone https://github.com/noordwind/Collectively.Services.Users
cd Collectively.Services.Users/Collectively.Services.Users
dotnet restore --source https://api.nuget.org/v3/index.json --source https://www.myget.org/F/collectively/api/v3/index.json --no-cache
dotnet run --no-restore --urls "http://*:10002"

Once executed, you shall be able to access the service at http://localhost:10002

Please note that the following solution will only run the Users Service which is merely one of the many parts required to run properly the whole Collectively system.

Configuration

Please edit the appsettings.json file in order to use the custom application settings. To configure the docker environment update the dockerfile - if you would like to change the exposed port, you need to also update it's value that can be found within Program.cs. For the local testing purposes the .local or .docker configuration files are being used (for both appsettings and dockerfile), so feel free to create or edit them.

Tech stack

• .NET Core - an open source & cross-platform framework for building applications using C# language.
• Nancy - an open source framework for building HTTP API.
• MongoDB - an open source library for integration with MongoDB database.
• RawRabbit - an open source library for integration with RabbitMQ service bus.

Solution structure

• Collectively.Services.Users - core and executable project via dotnet run --no-restore command.
• Collectively.Services.Users.Tests - unit & integration tests executable via dotnet test --no-restore command.
• Collectively.Services.Users.Tests.EndToEnd - End-to-End tests executable via dotnet test --no-restore command.