Furion.Mail.Imap 5.0.0-preview.1.20240813.1

先知（v5）

一个应用程序框架，您可以将它集成到任何 .NET/C# 应用程序中。

新域名

过去 Furion 没有独立好记的域名，这一次我们出手了，以合理的交易价格购买下了 furion.net 域名。

域名寓意非常好 —— Furion 是基于 .NET 开发的基础框架，正是 furion + .net 的组合。

访问新官网（建设中）：https://furion.net

项目背景

当前的 👉 Furion v4 版本已经逐步成熟且稳定，但仍存在以下问题：

• 早期开发进展迅速，很多代码存在仓促上线的情况，缺乏充分思考和考虑
• 所有模块都包含在一个项目中，无法按需加载和安装
• 过度使用静态类和静态内存存储，不利于进行单元测试和数据隔离
• 对于 .NET Core 的掌握程度有限，导致历史代码臃肿且高度耦合
• 代码架构和设计模式缺乏统一性，可以说是一个大杂烩
• 在早期对用户需求掌握不足，导致后期不断打补丁来进行改进，稍有改动就可能引发破坏性的修改
• 模块、类型、属性、方法、属性等命名混乱，很难从字面上理解其功能含义
• 模块功能封装过度，配置参数繁杂
• 框架示例混乱，用户只能自行摸索最佳实践
• 虽有单元测试，但是非常混乱

正是因为存在以上诸多问题，为了 Furion 能够长期发展，我们团队决定进行下一版本（v5）开发。

技术选择

Furion v5 版本采用 C# 12 和 .NET 8 进行开发。

开发团队

百小僧、百签科技（广东）有限公司

设计指导

• 计划和分析: 在开始编写代码之前，仔细规划和分析整个框架的需求和功能。确定好核心功能和结构，以及可能的扩展和变化。这样可以减少后续的重构工作。
• 模块化设计: 将整个框架划分为多个独立的模块，每个模块负责一个特定的功能。这样可以降低代码间的依赖性，方便后续的修改和调整。
• 接口设计: 设计清晰的接口和抽象层，以便将来的修改不会对其他模块产生过多的影响。好的接口设计可以提高代码的可维护性和可扩展性。
• 设计模式: 使用合适的设计模式来解决常见的问题，例如单例模式、观察者模式、策略模式等。这些设计模式可以提供灵活性和可扩展性，减少需要重构的风险。
• 自动化测试: 在开发过程中编写充分的自动化测试，覆盖各个模块的功能和边界情况。这样可以及早发现问题，并减少在重构时引入新的错误。
• 审查和反馈: 定期进行代码审查，并及时处理同事和用户的反馈意见。这有助于发现问题和改进，避免重复的重构工作。
• 持续集成: 将代码集成到一个持续集成系统中，并在每次提交代码时运行自动化测试。这可以及时发现潜在的问题，避免代码质量下降。

框架目标

• 实现完全无第三方依赖（除微软官方提供外）
• 实现彻底模块化，每个模块都是独立的项目
• 每个模块的单元测试覆盖率要达到 92% 以上
• 确保每个类型、属性、字段、方法都有详细的注释
• 尽可能避免使用静态内存存储
• 所有模块都采用上下文和构建器模式进行设计
• 所有模块都采用依赖注入/控制反转的设计模式
• 所有模块都采用约定大于配置设计原则
• 尽可能为每个模块提供看板功能
• 提供所有模块最佳实践示例
• 提供所有模块详细使用文档和 API 文档

模块状态

模块名称	状态	单元测试	版本	文档
Furion.Core	✅	✅		⚠️
Furion.DependencyInjection	✅	✅		⚠️
Furion.DependencyInjection.AspNetCore	✅	✅		⚠️
Furion.DependencyInjection.Hosting	✅	✅		⚠️
Furion.DependencyInjection.Named	✅	✅		⚠️
Furion.DependencyInjection.TypeScanning	✅	✅		⚠️
Furion.Component	✅	✅		⚠️
Furion.Component.AspNetCore	✅	✅		⚠️
Furion.Component.Hosting	✅	✅		⚠️
Furion.Configuration	✅	✅		⚠️
Furion.Configuration.FileScanning	✅	✅		⚠️
Furion.Configuration.ManifestResource	✅	✅		⚠️
Furion.Configuration.Remoted	✅	✅		⚠️
Furion.Validation	✅	✅		⚠️
Furion.Validation.AspNetCore	✅	✅		⚠️
Furion.Validation.Fluent	✅	✅		⚠️
Furion.Exception	✅	✅		⚠️
Furion.Exception.AspNetCore	✅	✅		⚠️
Furion.Exception.RescuePolicy	✅	✅		⚠️
Furion.Kit	✅	✅		⚠️
Furion.OpenApi	⏳	⏳		⚠️
Furion.Logging	⏳	⏳		⚠️
Furion.Logging.AspNetCore	⏳	⏳		⚠️
Furion.Logging.Console	⏳	⏳		⚠️
Furion.Logging.File	⏳	⏳		⚠️

状态说明

图标	描述
⚠️	待定
⏳	进行中
✅	完成
💔	随时抛弃

协议

Furion 采用 MIT 开源协议。