Midnight Pearl

Chapter I · Overture

Masons Xu.

Building reliable systems — Go, distributed, cloud-native.

5 years of Go backend engineering across distributed microservice architecture, data-lake platform construction, and cloud-native developer productivity — capable of owning complex systems end-to-end, from zero to one.

0+
Microservices

DDD-layered, Wire-DI services shipped solo

0.0%
Availability

Sustained production reliability

0%
Latency Reduced

Async rewrite of the hot path

0%
Deploy Faster

Containerised delivery pipeline

II

Radius

CloudWeGo · 10+ services

A distributed data platform,
made live.

Eight Kitex RPC services behind one Hertz gateway, Thrift IDL-first contracts, compile-time Wire DI, DDD layering — and a request you can replay, span by span.

  • RPC frameworkKitex
  • HTTP frameworkHertz
  • DIGoogle Wire (compile-time)
  • ContractThrift IDL-first
  • Discoveryetcd
  • AuthzCasbin RBAC
  • TracingOpenTelemetry + Jaeger
  • Slow-call threshold> 100ms → Warn span

Kitex · Thrift

Form Engine

4-level nested component tree, 30+ component types, three-layer model

Handler → Logic → DAL → Model

req_8af2c10d

form-value write · 42ms

edgeservicestorageobservabilityAPI GatewayForm EngineWorkflow EngineCross-Form LinkageIdentity & AccessDictionary ServiceIngestion & SyncIntegration HubAudit & LoggingService RegistryRelational StoreDocument StoreCache & SessionsOpenTelemetryJaeger

Spans · 6

  • API Gateway 4
  • Identity & Access 6
  • Form Engine 14
  • Form Engine 9
  • Document Store 8
  • OpenTelemetry 6
III

Iceberg

Apache Iceberg · 5 months to prod

A data lake, computed in your browser.

Ingest — drag a source into the lake

Apache Iceberg 0/3 sources landed · Parquet · PyIceberg
  1. 01Extract
  2. 02Normalise
  3. 03BFS Join
  4. 04Write-back

Shortest JOIN path — …

click two tables

Pick any table to begin the shortest-path search.

IV

Evidence

CloudWeGo · 3 merged

Three patches,
on the public record.

  1. 27 hertz-contrib/jwt

    security · jwt · correctness

    problem Refreshing a token incorrectly reset orig_iat, which shrank the MaxRefresh validity window on each refresh until users were silently forced to re-authenticate.

    fix Preserved the original orig_iat across refresh cycles so the MaxRefresh window is measured from the first issuance, not the latest refresh.

    view ↗
  2. 67 hertz-contrib/obs-opentelemetry

    observability · opentelemetry · reliability

    problem Trace spans dropped or were attributed inconsistently under load, reducing the reliability of distributed tracing.

    fix Hardened span lifecycle and propagation so traces remain stable and accurate across the request path.

    view ↗
  3. 84 cloudwego/abcoder

    compatibility · go-1.25 · build

    problem On Go 1.25+ the pinned sonic dependency failed to compile, blocking installs in modern toolchains.

    fix Bumped the sonic dependency to a Go 1.25-compatible release, restoring clean installation and compilation.

    view ↗

And a template

CloudWeGo Microservice Template

A production-grade Go microservice template distilled from the Radius platform — covering gateway ingress, service discovery, observability, containerisation, and engineering conventions, plus a systematic AI-assisted development workflow.

  • 330+ lines

    AGENTS.md spec

  • 8 flows

    Custom skills

  • 3 workflows

    AI GitHub Actions

V

Trajectory

2021.06 — 2026.04 · Manteia Data Technology · Xiamen FTZ

Five years of accreting strata.

  1. 2021 01 / 05

    The Monolith

    Flask · MySQL · MongoDB · Redis

    Joined as a fresh graduate. A single Flask application held the entire radiotherapy workflow system — one block, every responsibility co-located.

  2. 2022 02 / 05

    Async Rewrite

    Asyncio hot-path refactor

    Rewrote the core hot-path to an async architecture. Query throughput and data-loading responsiveness climbed while latency fell.

    50% latency reduced
  3. 2023 03 / 05

    Containerised Delivery

    Shell → Docker / Podman

    Migrated the delivery pipeline from shell scripts to containers. Deployment time collapsed from hours to minutes; availability stabilised.

    87.5% deploy faster (4h → 30m)
  4. 2025 04 / 05

    Service Decomposition

    CloudWeGo · Kitex + Hertz · 9 services

    Led the platform rewrite onto CloudWeGo: 8 Kitex RPC services behind 1 Hertz gateway, Thrift IDL-first contracts, compile-time Wire DI, DDD layering.

    10+ microservices
  5. 2025+ 05 / 05

    Observable & Standardised

    OpenTelemetry · Jaeger · IDL-First

    Added a dedicated observability layer — distributed tracing, full RequestID propagation, slow-call detection — and standardised an 8-person workflow around IDL-first conventions.

    99.9% availability

Roles
2025.03 — 2026.04 — Go Backend Architect / Tech Lead
2021.06 — 2025.03 — Python Backend Engineer

Chapter VI · Coda

Obsidian

Reliability

Obsidian bears everything. It is the bedrock that holds the system up when traffic spikes and dependencies fall. Reliability is the highest compliment I accept.

Pearl

Clarity

The pearl keeps the logic transparent. Simplicity is not the absence of feature — it is the result of removing everything that does not serve the real problem.

Gold

Excellence

Gold shines on the critical path only. Craft is hidden where no one looks — in the error code, the migration, the trace span — because that is where systems actually live.

scroll to merge — the pearl

“Architecture emerges naturally while solving real problems.”

架构不是设计出来的，而是在解决真实问题的过程中自然涌现的

Masons Xu · Midnight Pearl

email ↗ github masonsxu.pages.dev