1.7 路线图 (v5)

项目背景

目前 👉 Furion v4 已逐步成熟稳定，但在长期维护过程中，我们逐渐认识到以下问题：

• 早期快速迭代，代码仓促上线，许多设计缺乏充分思考与沉淀；
• 项目结构过于集中，所有模块堆砌于同一项目中，无法按需加载、独立安装；
• 过度依赖静态类与静态内存，导致单元测试困难、数据隔离性差；
• 早期对.NET Core 理解有限，部分历史代码臃肿、高度耦合；
• 代码架构与设计模式缺乏统一性，存在“大杂烩”现象；
• 初期对用户需求把握不足，后期频繁“打补丁”，稍动则可能引发破坏性变更；
• 模块、类型、属性、方法命名随意，难以从字面理解其功能；
• 模块封装过度，配置参数繁杂，学习成本高；
• 示例代码零散，用户难以找到最佳实践；
• 虽建有单元测试，但组织混乱，维护成本高。

正是基于上述痛点，为了 Furion 的长期健康发展，团队决定启动下一版本（v5）的开发，彻底重构与革新。

技术选择

Furion v5 将采用 C# 12+ 与 .NET 8 作为基础技术栈，充分利用最新语言特性和平台能力。

设计指导

为确保 v5 版本的高质量与可持续性，我们将遵循以下核心设计原则：

• 计划先行：动工前充分规划与剖析框架需求，明确核心功能与结构，预留扩展空间，减少后期重构。
• 模块化设计：将框架拆分为多个独立模块，各模块职责单一、边界清晰，实现按需加载与低耦合。
• 面向接口编程：设计清晰的接口与抽象层，隔离变化，降低模块间的相互影响，提升可维护性与可扩展性。
• 合理运用设计模式：如单例、观察者、策略等模式，增强代码的灵活性与可复用性，降低重构风险。
• 自动化测试贯穿始终：开发过程中同步编写单元测试与集成测试，覆盖核心功能与边界场景，及早发现问题，保障重构安全。
• 持续审查与反馈：定期进行代码审查，及时响应同事与用户的反馈，持续优化设计。
• 持续集成与质量门禁：集成 CI 系统，每次提交自动运行测试，严防质量下滑。

框架目标

v5 版本将围绕以下目标展开：

• 零第三方依赖（除微软官方库外），极致精简与可控；
• 彻底模块化：每个模块均为独立项目，可单独发布与引用；
• 单元测试覆盖率 ≥92%，确保核心逻辑可靠；
• 代码注释全覆盖：所有公开类型、属性、字段、方法均包含详尽注释；
• 尽量减少静态内存使用，拥抱依赖注入与生命周期管理；
• 所有模块采用上下文+构建器模式，提供流畅的配置体验；
• 全面基于依赖注入/控制反转设计，与.NET 原生容器深度整合；
• 贯彻约定优于配置原则，简化使用；
• 尽可能为每个模块提供可视化看板，方便运行时监控与管理；
• 提供各模块的最佳实践示例，降低上手门槛；
• 完善使用文档与 API 文档，做到开箱即用、有据可查。