Service Discovery — Complete Guide

Introduction

Service Discovery — Complete Guide is essential for engineers pursuing Software Architect roles on the Global Enterprise Platform Program — Toolliyo's 100-article path covering architecture styles, distributed systems, data platforms, cloud-native ops, security, DDD, leadership, and case studies (Netflix, Uber, banking, healthcare ERP, SaaS CRM).

Architect interviews at product companies and SI firms expect service discovery with stakeholder communication, ADRs, trade-off analysis, and operational thinking — not buzzword stacks.

After this article you will

• Explain Service Discovery as a software architect — business context, quality attributes, and constraints
• Apply service discovery to Global Enterprise Platform (ERP domain)
• Compare anti-patterns vs governed enterprise architecture with ADRs and review gates
• Answer architect-level HLD/LLD and leadership interview questions confidently
• Connect this lesson to Article 25 and the 100-article architect roadmap

Prerequisites

• Knowledge: System Design, APIs, databases
• Previous: Article 23 — Consistency Models — Complete Guide
• Time: 24 min reading + ADR/diagram exercise

Concept deep-dive

Level 1 — Analogy

Service Discovery on Global Enterprise Platform teaches architect-level trade-offs for enterprise service discovery decisions.

Level 2 — Technical

Service Discovery engineers resilience at scale — partition tolerance, async integration, idempotent consumers, and observability across ERP services.

Level 3 — Architecture governance flow

[Business stakeholders / compliance]
       ▼
[Architecture governance — ADRs, review board]
       ▼
[ERP bounded contexts — APIs + events]
       ▼
[Platform layer — gateway, identity, observability]
       ▼
[Data + integration — owned stores, event bus]
       ▼
[Cloud-native ops — CI/CD, IaC, SRE, DR]

Quality attributes

• Scalability: Horizontal scale plan for ERP peak traffic
• Reliability: SLOs, redundancy, chaos/failover drills
• Security: Zero-trust, encryption, compliance (PCI/HIPAA where applicable)
• Maintainability: Modular boundaries, ADRs, automated contract tests

Hands-on implementation — ERP

Architect Service Discovery for Global Enterprise Platform ERP: define quality attributes, choose patterns, document ADRs, align teams, and validate with architecture review gates.

1. Capture business context and quality attributes (scale, security, compliance).
2. Evaluate architecture styles (monolith, microservices, event-driven) with ADR.
3. Define service boundaries, data ownership, and integration contracts.
4. Plan security architecture, observability, and operational model.
5. Present architecture to stakeholders and run architecture review checklist.

Anti-pattern (big ball of mud, no ADRs, shared DB, no governance)

# ❌ ANTI-PATTERN — big ball of mud enterprise
- Single repo, shared DB tables across all domains
- No ADRs, no architecture reviews, no SLOs
- "We will microservice later" without modular boundaries
- Security bolted on after PCI/HIPAA audit failure

Production-style enterprise architecture blueprint

# ✅ ENTERPRISE ARCHITECTURE — Service Discovery (ERP)
Context: ERP must scale to multi-region SaaS with compliance
Decision: Modular monolith → extract payment & notification services at proven boundaries
Quality attributes: 99.95% availability, tenant isolation, audit logging
Artifacts: C4 container diagram, ADR-012, architecture review sign-off
Ops: SLO dashboards, quarterly DR drill, FinOps cost guardrails

Complete example

# Service Discovery — Global Enterprise Platform (ERP)
# Document decision in ADR format

Enterprise examples

ERP core platform

Service Discovery guides modular boundaries, shared platform services (identity, observability), and phased microservice extraction.

Apollo Hospitals ERP pattern

Role-based clinical vs billing contexts, audit trails, HA database pairs, and offline-capable edge clinics syncing via events.

Global Enterprise Platform — ERP track · Article 24

Architecture review checklist

1. Requirements and quality attributes documented
2. Options evaluated with explicit trade-offs
3. Data ownership and integration contracts defined
4. Security, observability, and DR addressed
5. ADR published and stakeholders aligned

Common errors & fixes

• Copying Netflix/Uber stack without context — Extract patterns (event streams, sharding) — adapt to your team size, domain, and compliance needs.
• No Architecture Decision Records (ADRs) — Document context, decision, consequences — future teams need the why, not just the what.
• Shared database across bounded contexts — Each context owns its data; integrate via APIs/events with explicit contracts.
• Architecture reviews only at launch — Continuous architecture governance — review significant changes before they become legacy debt.

Best practices

• 🟢 Write ADRs for every significant structural decision
• 🟢 Align architecture with team topology (Conway's law)
• 🟡 Start simple — evolve architecture with measured triggers
• 🟡 Use C4 models for consistent communication
• 🔴 Never copy hyperscaler stacks without context analysis
• 🔴 Never skip governance on compliance-critical domains

Interview questions

Mid level

Q1: How would you introduce Service Discovery to executives and engineers?
A: Business outcome first, quality attributes, options considered, decision, risks, and metrics to validate success.

Q2: Monolith vs microservices for a 20-person team?
A: Modular monolith with clear boundaries; extract services when independent scale, team ownership, or release cadence demands it.

Q3: How do you document architecture decisions?
A: ADRs (context, decision, consequences), C4 diagrams, and architecture review minutes with action items.

Architect / leadership level

Q4: How do you enforce architecture governance without blocking teams?
A: Principles + guardrails, automated checks (lint, contract tests), review for significant changes only.

Q5: Describe a production incident you would architect against.
A: Cascading failure from shared DB — introduce bulkheads, timeouts, cache, and observability with game days.

Q6: Path from senior engineer to architect?
A: Breadth across data/integration/cloud/security, stakeholder communication, and leading design without owning all code.

Summary & next steps

• Article 24: Service Discovery — Complete Guide
• Module: Module 3: Distributed Systems · Level: INTERMEDIATE
• Domain track: ERP

Previous: Consistency Models — Complete Guide
Next: API Gateway — Complete Guide

Practice: Draft one ADR for Service Discovery on ERP — commit with feat(software-architect): article-024.

FAQ