# DotNetMDMUI

**Repository Path**: smallcore/dot-net-mdmui

## Basic Information

- **Project Name**: DotNetMDMUI
- **Description**: .NET 桌面还能这么玩？WinForms 实现玻璃拟态的智能制造系统（可直接跑起来）
- **Primary Language**: C#
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: https://mp.weixin.qq.com/s/Mzjn5WqxRdiUB7klIS9pjw
- **GVP Project**: No

## Statistics

- **Stars**: 8
- **Forks**: 4
- **Created**: 2026-01-07
- **Last Updated**: 2026-01-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 工厂管理系统, MES, 工业自动化

## README


[《.NET 桌面还能这么玩？WinForms 实现玻璃拟态的智能制造系统（可直接跑起来）》](https://mp.weixin.qq.com/s/Mzjn5WqxRdiUB7klIS9pjw)

>声明：网络内容，仅供学习，尊重版权，侵权速删，歉意致谢！

MDMUI 是一个基于 **.NET Framework 4.8 / WinForms** 的桌面管理端示例项目，配套使用 **SQL Server LocalDB** 作为本地数据库。  
它强调“可直接跑起来”的工程体验，并在 UI 层加入了更现代的视觉语言：**Glassmorphism（玻璃拟态）** + **微交互动画**。

## ✨ 特性一览

- 🧊 Glassmorphism 登录卡片（圆角 + 半透明 + 细边框，支持子控件布局）
- 🧈 Mica / Blur 窗口背景（Windows 11 优先，Windows 10 尽力降级；失败不影响主流程）
- 🧠 hover / click 的平滑过渡动画（微交互更“丝滑”）
- ⌨️ Command Palette（`Ctrl + K`）快速检索功能页（不改交互习惯，但更高效）
- ⚡ 权限预加载缓存：菜单渲染/权限判断不再“每次检查都开连接”，显著降低启动与点击延迟
- 🔐 “记住密码”落地：使用 Windows DPAPI（CurrentUser）保护，仅当前系统用户可解密
- 🧰 内置构建脚本 + GitHub Actions（`windows-latest`）
- 🗃️ 启动时进行“非破坏性”数据库引导（缺库/缺表创建最小可运行结构，不覆盖已有数据）

## 🧭 架构（Mermaid）

```mermaid
flowchart LR
  UI[WinForms UI] -->|事件/交互| BLL[Business Logic Layer]
  BLL -->|SQL Query| DAL[Data Access Layer]
  DAL --> DB[(SQL Server LocalDB)]

  UI --> UX[Modern UI Layer]
  UX -->|GlassPanel| Controls[MDMUI.Controls]
  UX -->|Micro-interactions| Theme[MDMUI.Utility.ModernTheme]
  UX -->|Mica/Blur| Backdrop[MDMUI.Utility.WindowBackdrop]
```

## 🚀 快速开始

### 1) 环境要求

- Windows 10/11
- .NET Framework 4.8（运行时）
- 构建工具（二选一）：
  - Visual Studio 2022（包含 .NET 桌面开发），或
  - .NET SDK（建议 8.x / 9.x 均可）
- SQL Server LocalDB：实例名默认 `MSSQLLocalDB`

### 2) 构建

仓库根目录执行：

```powershell
dotnet build .\MDMUI\MDMUI.sln -c Release
```

或使用项目内置脚本：

```powershell
pwsh -NoLogo -File .\scripts\build.ps1 -Configuration Release
```

生成产物默认在：
- `MDMUI/bin/Release/MDMUI.exe`

### 3) 数据库与初始化

默认连接字符串位于：`MDMUI/App.config` 的 `DefaultConnection`。

也支持通过环境变量覆盖（便于 CI/部署，不需要改配置文件）：

```powershell
$env:MDMUI_CONNECTIONSTRING = "Data Source=(LocalDB)\\MSSQLLocalDB;Initial Catalog=UserDB;Integrated Security=True"
```

应用启动时会自动：
- 如果 `UserDB` 不存在：尝试创建数据库
- 如果核心表不存在：创建最小可运行表结构（如 `Users/Roles/Factory/UserFactory/Permissions/UserPermissions`）
- 写入必要的基础数据（幂等、不会覆盖已有数据）

如果你需要完整演示数据与更多表结构，可在数据库中执行：
- `MDMUI/dbo.sql`

### 4) 默认账号（首次初始化时）

- 用户名：`admin`
- 密码：`1`

建议首次登录后立即修改默认密码。

## 📂 目录速览

- `MDMUI/Forms/`：WinForms 界面
- `MDMUI/Controls/`：自定义控件（包含 GlassPanel）
- `MDMUI/BLL/`：业务逻辑层
- `MDMUI/DAL/`：数据访问层
- `MDMUI/Model/`：模型
- `MDMUI/Utility/`：通用工具（包含 WindowBackdrop / ModernTheme）
- `scripts/`：构建与清理脚本

## ⌨️ 快捷键（效率入口）

- `Ctrl + K`：打开 Command Palette（命令面板），输入关键字快速定位并打开功能页
  - 支持空格分词：例如输入 `系统 参数` 可更快命中目标
  - `Enter` 打开，`Esc` 关闭

## 🔐 本地偏好设置（登录体验）

为了让登录页的“记住密码/上次选择”真正可用，新增了轻量本地偏好存储：

- 存储位置：`%LOCALAPPDATA%\\MDMUI\\preferences.xml`
- 记录内容：上次用户名 / 语言 / 工厂、是否记住密码
- 密码保护：使用 DPAPI（`DataProtectionScope.CurrentUser`）加密保存，仅当前 Windows 用户可解密

## ⚡ 性能优化（关键路径）

针对 WinForms 管理端最常见的“慢点”做了非破坏性优化：

- **权限检查缓存**：MainForm 启动时一次性加载用户权限集合，之后的菜单生成与功能访问判断在内存中完成
- **保持安全默认**：预加载失败时自动降级为按次查询（不影响主流程）

![输入图片说明](dotnet.jpg)