介绍 OpenAPI 3.1 相比 3.0 的几项核心变化：JSON Schema 2020-12 对齐、nullable 语义重构、webhooks 原生支持，以及我在项目里做升级验证时看到的收益与边界。

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

Spring Boot 3.5 结合 Spring Kafka 3.3 提供了比较完整的 Kafka 集成能力。本文结合当前仓库实现，整理消费者并发模型、生产者 acks/retries、序列化选型、offset 提交策略、死信处理和 @RetryableTopic 的实践记录。

在 Gateway + BFF + Domain Service 架构下，记录一种用 Spring Cloud Gateway MVC 和 SpringDoc 聚合 OpenAPI 文档的做法，方便前后端协作和接口自查。

记录如何通过 Tailscale 组网和 Codex CLI 自定义 Provider 配置，把本地 AI 编码助手接到远程 Homelab 上的 Ollama 服务。

基于 Kubernetes 1.35 官方文档和实操验证，梳理 VPA 的 InPlaceOrRecreate 模式、原地调容的工作链路，以及落地时最容易踩的坑。

电商平台接入真实支付系统往往要先把支付抽象和 provider 边界理顺。本文结合 Shop Platform 当前实现，拆解 wallet-service 中的 PaymentIntent 抽象、Stripe/PayPal/Klarna/Wallet 支付方式矩阵、Mock/真实网关切换，以及尚未落地的 webhook、退款幂等和 Payment Element 演进方向。

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

结合一次 Spring Boot 3.5 tracing 接入整理的实践记录：自动配置覆盖范围、自定义埋点、Kafka/Redis/DB 组件接入、采样策略、PII 处理，以及用 ArchUnit 约束常见误用。

记录我用 Spring Boot 3.4+ 内建的 ECS 结构化日志支持替代大部分手写 logback-spring.xml 配置的过程，并结合 SLF4J Fluent API 让日志在 OpenSearch 中更容易查询和聚合。