SOLID in Microservices — Complete Guide

Introduction

SOLID in Microservices — Complete Guide is essential for .NET developers building ShopNest Enterprise Clean Architecture Platform — Toolliyo's 100-article SOLID Design Principles master path covering SRP, OCP, LSP, ISP, DIP, refactoring, Clean Architecture, and enterprise projects. Every article includes minimum 2 detailed enterprise real-world examples with bad code before good code (banking, e-commerce, ERP, SaaS, healthcare).

In Indian delivery projects (TCS, Infosys, Wipro), interviewers expect solid with real HDFC-style banking SRP fixes, Flipkart OCP payment strategies, TCS ERP LSP, Freshworks ISP, or Apollo hospital refactoring examples — not toy animal demos. This article delivers two mandatory enterprise examples on Reporting.

After this article you will

• Explain SOLID in plain English and in SOLID principles and maintainable OOP terms
• Implement solid in ShopNest Enterprise Clean Architecture Platform (Reporting)
• Compare the wrong approach vs the production-ready enterprise approach
• Answer fresher, mid-level, and senior SOLID principles and clean architecture interview questions confidently
• Connect this lesson to Article 8 and the 100-article SOLID Principles roadmap

Prerequisites

• Software: .NET 8 SDK, VS 2022 or VS Code, SQL Server Express / LocalDB
• Knowledge: C# basics
• Previous: Article 6 — SOLID in Clean Architecture — Complete Guide
• Time: 22 min reading + 30–45 min hands-on

Concept deep-dive

Level 1 — Analogy

SOLID on ShopNest Clean Architecture teaches maintainable enterprise design using Uncle Bob SOLID principles.

Level 2 — Technical

SOLID integrates with the LINQ query layer: write queries against IEnumerable or IQueryable, understand deferred execution, project to DTOs for ShopNest Clean Architecture reports. On ShopNest Clean Architecture this powers Reporting without coupling UI to database internals.

Level 3 — Architecture

[Browser] → [HTTPS/Kestrel] → [Middleware Pipeline]
  → [Routing] → [Controller Action] → [Service Layer]
  → [EF Core / Identity] → [Razor View Engine] → [HTML Response]

Project structure

ShopNest Clean Architecture/
├── ShopNest Clean Architecture/
├── src/
│   ├── ShopNest Clean Architecture.Api/       ← ASP.NET Core Web API
│   ├── ShopNest Clean Architecture.Core/      ← Repository interfaces
│   ├── ShopNest Clean Architecture.AdoNet/    ← SqlConnection, SPs, transactions
│   ├── ShopNest Clean Architecture.Reports/   ← Streaming readers, GL reports
│   └── ShopNest Clean Architecture.Tests/     ← Integration tests (Testcontainers SQL)
├── sql/
│   ├── migrations/
│   └── stored-procedures/
└── docker-compose.yml                 ← SQL Server 2022 + Redis

Step-by-Step Implementation — ShopNest (Reporting)

Follow the prompt template: create project → core classes → interfaces → pattern implementation → client code → run → enterprise refactor.

Step 1 — The wrong way

// ❌ BAD — god class violates SRP, tight coupling, untestable
public class OrderService {
    public void PlaceOrder(Order o) {
        Validate(o);
        _context.Orders.Add(o);
        _context.SaveChanges();
        SendEmail(o.CustomerEmail);
        GenerateInvoicePdf(o);
    }
}

Step 2 — The right way

// ✅ CORRECT — SOLID on ShopNest (Reporting) — SOLID applied
public sealed class PlaceOrderHandler(IOrderRepository repo, INotificationService notify)
    : IRequestHandler
{
    public async Task Handle(PlaceOrderCommand cmd, CancellationToken ct) {
        var order = Order.Create(cmd.CustomerId, cmd.Items);
        await repo.AddAsync(order, ct);
        await notify.OrderPlacedAsync(order, ct);
        return Result.Success(order.Id);
    }
}

Step 3 — Apply SOLID

return View(model);           // ViewResult
return RedirectToAction("Index"); // RedirectResult
return NotFound();            // NotFoundResult
return Json(data);            // JsonResult

dotnet run --project ShopNest Clean Architecture.Api
# Verify SOLID — check Swagger UI and unit test pass rate and integration tests pass

The problem before SOLID

Without SOLID, ShopNest teams hit: tight coupling, god classes, untestable controllers, merge conflicts, and fear of refactoring. Indian IT projects (TCS, Infosys, Wipro) lose sprints when legacy code has no clear boundaries.

• Tight coupling — change SMS provider, break ledger posting
• Testing difficulty — cannot mock database from controller
• Scalability — monolith teams block each other
• Bug-prone — one class, five reasons to change

Real-World Example 1 — ShopNest Payments — DIP with Repository Abstractions

MANDATORY enterprise scenario (Payment Gateway): SOLID in Microservices applied in ShopNest Clean Architecture Reporting.

Business problem

PaymentController directly new SqlPaymentRepository() — untestable, tied to SQL Server. DIP: IPaymentRepository injected; infrastructure implements ADO.NET or EF Core without changing API layer.

Before SOLID — bad design

public class PaymentController : ControllerBase {
    public IActionResult Pay(PaymentDto dto) {
        var repo = new SqlPaymentRepository(Configuration.GetConnectionString("Default"));
        repo.Save(dto);
        return Ok();
    }
}

After SOLID — production design

public class PaymentController(IPaymentRepository repo) : ControllerBase {
    [HttpPost]
    public async Task<IActionResult> Pay(PaymentDto dto, CancellationToken ct) {
        await repo.SaveAsync(dto.ToEntity(), ct);
        return Ok();
    }
}
// Program.cs: builder.Services.AddScoped<IPaymentRepository, SqlPaymentRepository>();

Outcome

xUnit tests use InMemoryPaymentRepository; swap to Azure SQL with one DI line in production.

Real-World Example 2 — Apollo Hospital — Legacy Refactoring to SOLID

MANDATORY enterprise scenario (Healthcare): SOLID in Microservices applied in ShopNest Clean Architecture Reporting.

Business problem

Monolithic PatientModule mixed UI, DB, and billing. Strangler fig + SOLID: extract IPatientRepository, IBillingService; MVC controller thin; MediatR handlers per use case.

Before SOLID — bad design

public class PatientPage {
    public void Load(int id) {
        var conn = new SqlConnection("...");
        // 200 lines SQL + HTML generation + billing calc
    }
}

After SOLID — production design

public class GetPatientQueryHandler(IPatientRepository repo, IBillingService billing)
    : IRequestHandler<GetPatientQuery, PatientDashboardVm> {
    public async Task<PatientDashboardVm> Handle(GetPatientQuery q, CancellationToken ct) {
        var patient = await repo.GetAsync(q.PatientId, ct);
        var balance = await billing.GetBalanceAsync(q.PatientId, ct);
        return PatientDashboardVm.From(patient, balance);
    }
}

Outcome

Team of 6 parallelized on Patient, Billing, Labs modules — merge conflicts dropped 70%.

SOLID in ASP.NET Core — SOLID

Register abstractions in Program.cs as Scoped. Keep controllers thin — delegate to MediatR handlers or application services. ShopNest Clean Architecture: Domain → Application → Infrastructure → Api.

builder.Services.AddScoped<IOrderService, OrderService>();
builder.Services.AddMediatR(cfg => cfg.RegisterServicesFromAssembly(typeof(PlaceOrderHandler).Assembly));

SOLID and design patterns

SRP enables focused classes; OCP pairs with Strategy and Factory; LSP guards inheritance; ISP splits fat interfaces; DIP powers DI and Repository pattern. SOLID is the foundation — patterns are the tools.

Unit testing with SOLID

var mock = new Mock<IOrderRepository>();
mock.Setup(r => r.GetAsync(1, default)).ReturnsAsync(new Order(1, 100m));
var handler = new GetOrderHandler(mock.Object);
var result = await handler.Handle(new GetOrderQuery(1), default);
Assert.Equal(100m, result.Total);

Common errors & fixes

🔴 Mistake 1: God classes with 10+ responsibilities (SRP violation)
✅ Fix: Extract focused services — one reason to change per class.

🔴 Mistake 2: Adding if/else chains for every new feature (OCP violation)
✅ Fix: Use Strategy or Factory; extend via new classes, not edits.

🔴 Mistake 3: Subclass throws NotImplementedException (LSP violation)
✅ Fix: Prefer composition and role-specific interfaces over broken inheritance.

🔴 Mistake 4: Controllers new-ing concrete repositories (DIP violation)
✅ Fix: Inject interfaces via constructor DI in ASP.NET Core.

Best practices

• 🟢 Use async/await end-to-end for database and I/O calls
• 🟢 Register DbContext as Scoped; avoid capturing it in singletons
• 🟡 Use IQueryable until the last moment; avoid multiple enumeration; project with Select before ToList
• 🟡 Prefer method syntax for complex chains; use query syntax for joins when readability wins
• 🔴 Log structured data with Serilog — include OrderId, UserId, not passwords
• 🔴 Use HTTPS, secure cookies, and authorization policies in production

Interview questions

Fresher level

Q1: What is SOLID in ASP.NET Core MVC?
A: SOLID is a core MVC capability used in ShopNest Clean Architecture for Reporting. Explain in one sentence, then describe controller/view/service placement.

Q2: How would you implement SOLID on a TCS-style delivery project?
A: Deferred execution, IQueryable pipelines, Select projection, Skip/Take pagination, and SQL logging in development.

Q3: IEnumerable vs IQueryable — when to use which?
A: IEnumerable for in-memory collections; IQueryable for EF Core database queries that translate to SQL.

Mid / senior level

Q4: Explain LINQ deferred execution and query translation briefly.
A: LINQ → Expression Tree → IQueryProvider → SQL (EF) or Iterator (in-memory) → Results.

Q5: Common production mistake with this topic?
A: Skipping validation, exposing secrets in Git, or untested edge cases (null model, unauthorized user).

Q6: .NET LINQ vs SQL — when to push logic to database?
A: Core is cross-platform, faster, cloud-ready; Framework is maintenance mode on Windows/IIS.

Coding round

Implement SOLID for ShopNest Reporting: show interface, concrete class, DI registration, and xUnit test with mock.

public class SOLIDPatternTests
{
    [Fact]
    public async Task ExecuteAsync_ReturnsSuccess()
    {
        var mock = new Mock();
        mock.Setup(s => s.ExecuteAsync(It.IsAny(), default))
            .ReturnsAsync(Result.Success("test-id"));
        var result = await mock.Object.ExecuteAsync(new Request("test-id"));
        Assert.True(result.IsSuccess);
    }
}

Summary & next steps

• Article 7: SOLID in Microservices — Complete Guide
• Module: Module 1: SOLID Foundations · Level: BEGINNER
• Applied to ShopNest Clean Architecture — Reporting

Previous: SOLID in Clean Architecture — Complete Guide
Next: SOLID and Design Patterns — Complete Guide

Practice: Add one small feature using today's pattern — commit with feat(solid): article-07.

FAQ