前言基于 .NET 10 打造的跨平台文档管理系统才真正感受到了什么叫专业级的开源力量。它不仅仅是一个简单的文件存储工具更是一个集成了 CQRS 架构、实时通信、版本控制等高级特性的现代化应用示例。项目介绍一款标准的前后端分离项目后端基于全新的 .NET 10 运行时开发前端则采用了 Angular 框架。它最大的亮点在于对架构模式的深度应用——整个项目严格遵循 CQRS命令查询职责分离 MediatR中介者模式的设计思想配合异步编程模型确保了代码的高内聚、低耦合。这意味着对于需要二次开发的企业来说这套系统的代码结构清晰逻辑分层明确无论是增加新的业务模块还是修改现有的审批流程都能做到热插拔式的平滑扩展。同时它支持 MySQL 8.0 和 SQL Server 2012 作为后端数据库并提供了完善的 Docker 部署支持无论是 Windows、Linux 还是 Mac 环境都能快速落地。项目功能功能模块核心能力业务价值智能文档引擎分片上传、MD5秒传、AES加密存储、全格式预览确保大文件传输稳定底层数据绝对安全查阅便捷权限与审计细粒度角色控制、登录IP审计、强制踢人下线满足企业合规要求所有操作有迹可循杜绝越权访问共享与协作内部团队共享、带密码/有效期的外部链接、实时通知打破信息孤岛内外部文件分发既灵活又可控版本控制自动保留历史版本、一键回滚、历史版本下载为重要文档提供“后悔药”防止误删或恶意篡改管理控制台实时仪表盘、SMTP邮件配置、NLog系统日志查看IT管理员的专属阵地全方位掌控系统健康度与用户动态项目特点1、架构先行代码即文档采用 CQRS MediatR 模式将写操作Command和读操作Query彻底分离。这不仅让代码逻辑更加清晰还极大地提升了系统的可维护性。所有的方法都是异步的配合依赖注入DI让高并发场景下的性能表现非常稳健。2、全平台覆盖无缝衔接除了标准的 Web 端Angular项目还提供了基于 Avalonia 的跨平台客户端。这意味着你的团队成员可以在 Windows、Linux 或 Mac 上使用原生体验的桌面客户端甚至在移动设备上也能通过响应式布局进行操作真正实现了一处部署全端可用。3、安全为王细节拉满安全不仅仅是加密存储。系统内置了严格的文件类型过滤禁止上传 .exe、.bat 等危险文件通过防抖Debounce优化了全局搜索体验还利用 Redis或降级为内存锁实现了上传并发控制防止文件覆盖冲突。这些细节体现了开发团队深厚的技术功底。系统架构与技术栈层级核心技术组件关键说明运行时框架.NET 10 (net10.0)微软最新 LTS 版本极致性能与跨平台支持架构模式CQRS MediatR命令查询职责分离业务逻辑高度解耦易于扩展前端交互Angular Material响应式布局提供流畅的 Web 端与移动端体验桌面客户端Avalonia UI真正的跨平台原生客户端Windows/Linux/Mac数据存储EF Core 10 MySQL/SQL Server强大的 ORM 映射支持多数据库无缝切换安全认证JWT Bearer ASP.NET Identity令牌基身份验证保障接口访问的安全性实时通信SignalR实现文件夹变更推送、在线用户检测等毫秒级通知项目效果项目源码Web 层包含 API 启动入口和依赖注入配置。MediatR 层存放所有的 Command 和 Query 处理逻辑是业务的核心。Repository 层封装了 EF Core 的通用仓储模式。Domain 层定义了实体类和 DbContext。Client 层基于 Avalonia 的跨平台客户端代码是学习 .NET 桌面开发的绝佳范例。GitHubhttps://github.com/dorisoy/Dorisoy.Pan总结Dorisoy.Pan 不仅仅是一个文档管理系统它更像是一套企业级应用的开发脚手架。它展示了如何利用 .NET 10 的最新特性结合 CQRS 等先进架构开发一个高可用、易扩展的现代化应用。不管是搭建一个内部的私有云盘还是想寻找一个可二次开发的文档管理内核Dorisoy.Pan 都是一个不错的选择。