yhzhu的随手记

A practical guide to designing API gateway routing for OAuth2 authentication flows in microservices. Learn how to handle redirects, configure Context-Path, and implement BFF patterns for seamless service decomposition without breaking client contracts.

微服务架构中 API 网关 OAuth2 认证流程路由设计的实践指南。学习如何处理重定向、配置 Context-Path，以及实现 BFF 模式，实现客户端无感知的服务拆分。

传统的大宽表用户设计难以应对多样化登录方式。了解如何通过分离 AuthIdentity 与 User 实体，构建支持邮箱、手机号、社交登录和 SSO 的灵活可扩展认证体系，无需修改表结构。

Traditional 'wide table' user designs struggle with diverse login methods. Learn how separating AuthIdentity from User entities enables flexible, scalable authentication supporting email, mobile, social logins, and SSO without schema migrations.

Recurring meetings break standard delta sync logic. Learn how to synchronize Outlook recurring events with EspoCRM using windowed expansion and series rebuild strategies—a production-grade solution for Microsoft Graph API integration.

Outlook 与 Gmail/Google Calendar 的循环会议是集成中的“深水区”。本文介绍 EspoCRM 如何通过“窗口化展开”和“系列重建”策略，解决 Microsoft Graph API 增量同步失效、iCalUId 重复等核心难题，提供生产级工程实践方案。

很多 CRM 需求需要“定时触发”：到期提醒、日报生成、数据同步、数据质量巡检。自定义 Job 是正确姿势。本文以通用“到期提醒”为例实现 JobDataLess 定时任务：依赖注入、批量查询、去重日志、邮件发送。给出调度配置、监控排障与发信要点，适用于同步/巡检/通知类任务。

只做前端 required 的团队，迟早会被“脏数据”反噬。本文给出前后端双保险方案：Dynamic Logic 负责交互体验（实时提示），BeforeSave Hook 守住所有入口底线（API/导入/脚本无法绕过）。覆盖错误消息策略、测试矩阵与“坏人假设”，避免脏数据进入系统。

你以为多对多必须建中间表？在 EspoCRM 里，手写 SQL 往往是你自己给自己埋雷。本文演示用纯元数据定义多对多关系：entityDefs 的 links + relationName 驱动 rebuild 自动建表。同时补齐 scopes/clientDefs/layouts，让关系在 UI 可见可配可用

外部集成的难点不是“调通 API”，而是“长期稳定运行”。本文以 Outlook/Graph 为例，讲清 OAuth 授权流程、ExternalAccount 存储、增量同步（deltaLink/skipToken）与失败恢复策略。覆盖 token 轮换、错误分类重试、幂等设计与英文日志，让集成长期稳定运行。