跳到主要内容
版本：0.4.x

路线图

核心原则：功能通过约定自动发现或配置激活。用户永远不需要改变 ISharkEndpoint 编码模式，不需要实现新接口，不需要在业务代码中调用框架 API。

v0.4.0 — 2026-06-28 ✅​

  • 废弃 [SharkEndpoint] / [SharkMethod] / SharkHttpMethod 及相关反射基础设施 — 迁移到 ISharkEndpoint
  • 启动配置自检 — ConfigurationValidator 在 AddShark() 时校验 JWT、多租户配置
  • 优雅关闭 — K8s 友好的 SIGTERM 处理：/healthz → 503，排空请求，然后关闭
  • 审计日志批量/异步写入 — Channel 缓冲 + 后台刷新（AsyncWrite、BatchSize、FlushInterval）
  • 幂等性分布式存储 — IIdempotencyStore 可通过 TryAddSingleton 或 IdempotencyStoreFactory 替换
  • 限流分布式存储 — IDistributedRateLimitStore + SharkRateLimiterMiddleware，默认 MemoryRateLimitStore，RateLimitStoreFactory
  • Sharkable.Cache.Redis NuGet 插件 — Redis 版 IIdempotencyStore + IDistributedRateLimitStore，AddSharkableRedis()

Phase 1 — 现有功能强化（零侵入）​

#功能价值侵入度状态
1启动配置自检减少踩坑零 — 自动运行✅ v0.4.0
2优雅关闭生产必备零 — K8s 原生✅ v0.4.0
3审计日志批量/异步性能优化零 — 仅内部机制✅ v0.4.0
4编译时路由冲突检测质量保障零 — NuGet 包自带

Phase 2 — 可观测性​

#功能价值侵入度状态
5内置分布式追踪可观测性零 — ActivitySource✅
6可扩展健康检查 — 结构化JSON /healthz，自定义检查，自动JWT检测，运行时长+版本运维仅配置✅
7轻量性能面板调试仅配置✅

Phase 3 — 分布式 / 集群支持​

#功能价值侵入度状态
8幂等性分布式存储接口集群高可用仅配置✅ v0.4.0
9多租户数据源隔离 — ITenantDataSource scoped服务，ConfigureDataSource() 按租户路由连接串SaaS仅配置✅
10限流分布式存储接口集群高可用仅配置✅ v0.4.0
11自适应限流鲁棒性仅配置

Phase 4 — 开发者体验 & 打磨​

#功能价值侵入度
12ETag / 304 条件请求缓存优化零 — 自动
13响应压缩性能仅配置
14OpenAPI 示例生成开发体验零 — 自动
15错误消息本地化国际化仅配置
16AutoCrud AOT 零 rd.xmlAOT 体验零 — Source Generator
17软删除全局过滤器数据层实体标记接口
18BackgroundService 增强后台任务零 — 自动
19ProblemDetails (RFC 7807) 兼容互操作性零 — 自动

已排除（高侵入性）​

功能原因
CQRS-lite (ICommand/IQuery)需重写每个端点类
模块化 ISharkModule需大面积重构
强类型 ID (OrderId, UserId)需改所有方法签名
智能枚举需改所有枚举定义
缓存标签失效需改写入端点
API 测试运行器需写新测试代码
轻量网关需建新项目
Source Generator SDK需新包 + 客户端代码
最后于 更新