CLAUDE.md@by-scenario/microservicesA

CLAUDE.md@by-scenario/microservices from overseastelegramaliterateperson865/awesome-claude-md is a CLAUDE.md file: the standing instructions Claude Code reads in that repo.

mdr add overseastelegramaliterateperson865/awesome-claude-md/by-scenario/microservices/CLAUDE.md@git:20260320.fcf2609

Pins git:20260320.fcf2609 in mdr.lock. Pin the fingerprint instead.

Audit grade

A, 14 of 14 checks passed

Kind

CLAUDE.md file

Repository

overseastelegramaliterateperson865/awesome-claude-md

Path

by-scenario/microservices/CLAUDE.md

Versions recorded

1

Latest version

git:20260320.fcf2609, committed Mar 20, 2026

Size

2,457 bytes

Repository stars

3

License

MIT

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# 微服务架构项目

## 架构概览
- 微服务架构，各服务独立部署、独立数据库
- 服务间通信：同步（REST/gRPC）+ 异步（消息队列）
- 容器化部署：Docker + Kubernetes
- 基础设施：服务注册发现、配置中心、API 网关

## 项目结构（典型 Monorepo）
```
services/           # 各微服务（user-service, order-service 等）
shared/
  proto/            # gRPC Proto 定义
  common-lib/       # 共享工具库
infra/
  docker-compose.yml / k8s/ / helm/  # 部署配置
```

## 服务间通信
- 同步调用：REST（简单场景）或 gRPC（高性能/强类型场景）
- 异步消息：RabbitMQ / Kafka，用于事件驱动和解耦
- 命名规范：事件名用过去时 `order.created`、`payment.completed`
- 调用链路中做好超时和重试配置，设置合理的 timeout 和 retry 策略
- 使用断路器（Circuit Breaker）防止级联故障

## 服务拆分原则
- 按业务域划分（DDD 限界上下文），而非技术层
- 每个服务拥有自己的数据库，禁止直接访问其他服务的数据库
- 跨服务数据一致性使用 Saga 模式或最终一致性
- 避免分布式事务（2PC），优先选择补偿机制

## Docker + Kubernetes
- 每个服务一个 Dockerfile，使用多阶段构建减小镜像
- K8s 资源：Deployment + Service + ConfigMap/Secret + Ingress
- 健康检查：配置 `livenessProbe` 和 `readinessProbe`
- 水平扩缩容：HPA 基于 CPU/内存或自定义指标

## 可观测性
- 分布式追踪：OpenTelemetry 采集，Jaeger/Zipkin 展示
- 日志：结构化 JSON 日志，包含 traceId，统一收集到 ELK/Loki
- 监控：Prometheus 采集指标 + Grafana 面板
- 每个请求必须携带和传播 traceId/spanId

## 本地开发
```bash
docker-compose up -d              # 启动基础设施（数据库、MQ、Redis）
docker-compose up user-service    # 启动单个服务
docker-compose logs -f order-service  # 查看服务日志
```

## API 网关
…

Read the whole file at its exact version.

How to install

mdr add overseastelegramaliterateperson865/awesome-claude-md/by-scenario/microservices/CLAUDE.md@sha256:1deaa5c6d1945de9

[![mdr](https://markdownregistry.com/badge/art_eyytmhwgn2cmesha.svg)](https://markdownregistry.com/a/art_eyytmhwgn2cmesha)

Versions

The registry has recorded 1 version of this file, committed on Mar 20, 2026.

Audit of the latest version

Source

API

GET https://markdownregistry.com/api/v1/artifacts/art_eyytmhwgn2cmesha
GET https://markdownregistry.com/api/v1/resolve?ref=overseastelegramaliterateperson865/awesome-claude-md/by-scenario/microservices/CLAUDE.md
GET https://markdownregistry.com/api/v1/blob/1deaa5c6d1945de99112fad121b3736424f1aab6ecbdfa8598dbc4293e566bc9

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: what a CLAUDE.md file is · keeping AGENTS.md and CLAUDE.md in sync · which agent file does what.

More from overseastelegramaliterateperson865/awesome-claude-md

Every file in overseastelegramaliterateperson865/awesome-claude-md

Browse by kind, by grade A, or by owner.