Paired: GitHub #34 ↔ GitCode !412

背景

基于最新 develop 的 Service Framework 示例，补齐可组合 Handler、明确的 REST/SSE OpenAPI 路由以及 FastAPI 原生 OAuth2/联合认证演示。

主要变更

• 新增统一的普通/流式 Handler 对象接口和 HandlerSpec。
• 支持 app.register、register_all、include 及独立 HandlerRegistry 模块。
• 每个 Handler 生成明确的 REST 路径、请求/响应模型和 OpenAPI 描述。
• 保留最新 develop 的强类型请求、超时、中断和 RequestContext 清理语义。
• 新增异步 OAuth2 Authorization Code + PKCE 访问控制示例。
• 新增模块化联合身份 Provider、内存测试 Store 和 SQLite 示例 Store。
• 增加完整开发者 README、UT 和 ST。

边界

Enterprise Demo IdP 只用于演示浏览器和身份映射链路，不解析或验证真实 SAML XML；生产接入要求在 FederationProvider 后实现完整 SAML 校验并替换示例 OAuth2 Server/Store。

验证

• uv run pytest -q：117 passed
• uv run ruff check .：passed