整理 2019–2026 年间七家公司在代码边界、服务边界、部署拓扑、API 聚合和数据契约上的真实演进，讨论微服务规模化之后边界治理如何迁移。

以问答方式整理我在微服务规模增大后开始补上的两类结构化文档：ADR 记录"为什么这样"，catalog-info.yaml 记录"是什么、归谁、依赖什么"。

BFF 与微服务之间到底该共享到哪一步？本文从 Shop Platform 的 monorepo 实践出发，拆解共享 contracts、共享 client、契约测试三种思路在 polyrepo 下的 tradeoff，并记录我目前更倾向的落地方式。

在 code agent 普及的背景下，我在 Shop Platform 用 ArchUnit 作为可执行的 harness。本文结合实际实践，说明它在微服务、monorepo 与普通 repo 中的落地方式。

记录我在多仓库微服务项目里整理文档体系时采用的一种思路：中央架构 Repo + 各服务 Repo 内 /docs/ 目录 + Docusaurus 统一入口，尽量让文档贴近代码，同时保留统一检索入口。

注册门槛往往会抬高结账流失。本文结合 Shop Platform 当前实现，拆解 guest JWT、Redis 游客购物车（TTL 48 小时）、游客订单的 order_token 追踪，以及登录后购物车合并；并额外说明 buyer-portal 与 buyer-app 在 guest checkout 体验上的差异。

架构约束很难只靠 Code Review 口头约定。本文结合 Shop Platform 当前实现，整理 19 条 ArchUnit 规则、6 个 Maven Archetype、WireMock contract testing 和 API 路径版本化校验这几层工程护栏。

从递归解析器、权威 DNS、CDN 导流到边缘 PoP 的完整链路出发，解释 CDN 与 DNS 如何协作，以及网站如何在 DNS 宕机、控制面异常和缓存收敛延迟中争取更好的可用性。

基于当前业务规模假设，记录一次 Confluent Kafka topic 分区数量评估，最后先按 12 个分区做起步配置。

一个以 Java 25 + Spring Boot 3.5 + Spring Cloud 2025 为技术基线的电商平台 POC，涵盖 API 网关、BFF、领域服务、活动引擎与全链路可观测，可作为技术选型讨论的一个可运行参考。