thiennn / crm

A lightweight CRM application builds with microservices architecture

A lightweight Contact management

Communication API	Contact API	GraphQL gateway	Identity API	CRM SPA

This is a simplified contact management system made in a microservice architecture, using:

• .Net Core 3.0
• GraphQL implement with Hot Chocolate using like a gateway
• Internal communication using Grpc
• Using RabbitMQ as a message broker based on Masstransit
• SQL database with Postgresql
• Storing secrets with Vault
• Data migration with Dbup
• Accessing database with Dapper
• In-process messaging with MediatR
• Polly
• A modern web application with React
• Logging with Serilog, Seq
• Monitoring with Jaeger, Octant, Grafana
• Identity and access management with Identity server 4
• Building Docker images, managing containers and registry
• Docker compose
• CI & CD with Azure pipeline
• Orchestrating services using Azure Kubernetes Service
• Deploy services to AKS by helm 3

Demo

• Contact management
  • User name: [e-mail]
  • Password: P@ssw0rd
• GraphQL gateway

Architecture overview

Getting Started

Prerequisites

• Install Docker
• Install Docker compose
• Using BloomRPC to access gRPC services

Up and running

 docker-compose -f docker-compose.yml -f docker-compose.override.yml build

 docker-compose -f docker-compose.yml -f docker-compose.override.yml up

Once the containers are deployed, you can access any of the services in the following Urls or connection string:

• Web SPA: TBD
• Gateway http://localhost:5100
• Microservices
  • Contact service: localhost:5001 via gRPC
  • Communication service: localhost:5002 via gRPC
• Infrastructure
  • Postgresql, connect to localhost:5432 with user User Id=lab;Password=P@ssw0rd;
    • Contact: crm-contact
  • Jaeger: http://localhost:16686
  • Keycloak: http://localhost:8080; login with user lab, password P@ssw0rd
  • Seq: http://localhost:5340
  • Vault: http://localhost:8200

Explorer the application

GraphQL gateway

Open a browser and type http://localhost:5100. You should see the UI like in the following screenshot: With this playgroud, you can do query or mutation commands to services behind.

Contact service with BloomRPC

Distributed tracing

Monitoring

Logging with Seq

Testing

TBD

CI & CD

TBD

Deploy to AKS

TBD

Contributing

1. Fork it
2. Create your feature branch
3. Making changes and submit the pull request.

License

Code is available under the MIT license