__ __ ____ __ __ _ _ ___
| \/ | _ \ | \/ | | | |_ _|
| |\/| | | | || |\/| | | | || |
| | | | |_| || | | | |_| || |
|_| |_|____/ |_| |_|\___/|___|
WinForms · .NET Framework 4.8 · SQL Server LocalDB
MDMUI 是一个可直接运行的 WinForms 管理端示例项目，强调：
- 清晰分层（UI / BLL / DAL）
- 可配置策略（安全、备份、主题等）
- 可观测性与可诊断性（日志、崩溃报告、性能埋点）
- 增量式 UI 设计系统（Atomic Design：Atoms / Molecules）
说明：本项目为 WinForms 桌面应用，Web 领域的 Lighthouse 评分不适用；性能与体验目标通过启动/关键路径埋点、控件双缓冲与交互优化来衡量与迭代。
- 登录安全：失败计数、锁定策略、密码策略、权限校验
- 系统参数中心：集中管理安全/备份/主题策略
- 数据备份中心：一键备份、保留策略自动清理旧文件
- 命令面板（Command Palette）：最近/常用优先，支持固定常用功能
- 统一主题系统：颜色、字体、控件风格统一应用
- 崩溃兜底：未处理异常弹出崩溃报告窗，可复制详情/打开日志目录
- 日志与埋点：
- AppLog：落盘日志（按天 + 大小轮转 + 保留策略）
- AppTelemetry：轻量性能埋点（关键路径耗时记录）
- AuditTrail：关键操作审计（SystemLog）
- 单元测试：MSTest + GitHub Actions 中执行
dotnet test
flowchart LR
UI[WinForms UI] -->|交互| BLL[Business Logic Layer]
BLL -->|SQL| DAL[Data Access Layer]
DAL --> DB[(SQL Server LocalDB)]
UI --> Theme[ThemeManager / ModernTheme / Controls]
UI --> Obs[AppLog / CrashReporter / AppTelemetry]
设计原则：
- 业务逻辑尽量收敛在 BLL / DAL，UI 负责交互与状态呈现。
- 增量升级遵循开闭原则（Open/Closed Principle）：尽量以新增模块/控件扩展能力，仅在必要接入点做小改动。
- Windows 10/11
- .NET Framework 4.8（运行时）
- Visual Studio 2022（.NET 桌面开发工作负载）
- SQL Server LocalDB（默认实例
MSSQLLocalDB）
dotnet build .\MDMUI\MDMUI.sln -c Release或使用脚本：
pwsh -File .\scripts\build.ps1 -Configuration Releasepwsh -File .\scripts\test.ps1 -Configuration Release- 默认连接字符串：
MDMUI/App.config->DefaultConnection - 可通过环境变量覆盖：
$env:MDMUI_CONNECTIONSTRING = "Data Source=(LocalDB)\\MSSQLLocalDB;Initial Catalog=UserDB;Integrated Security=True"应用启动会进行最小可运行初始化（不会覆盖已有数据）。如需完整演示数据，可执行：
MDMUI/dbo.sql
- 用户名：
admin - 密码：
1
系统参数页面支持统一管理策略，例如：
Security.MaxFailedLoginSecurity.LockoutMinutesSecurity.DefaultResetPassword（可选：用户管理“重置密码”的默认值；不满足策略时会自动生成强密码兜底）Backup.RetentionDaysBackup.DirectoryUI.AccentColor
- 默认日志目录：
%LOCALAPPDATA%\MDMUI\logs - 默认日志文件：
mdmui-YYYYMMDD.log（按天） - 大文件轮转：单文件超过阈值会自动轮转到
mdmui-YYYYMMDD-HHmmss-PID.log
支持覆盖（环境变量优先于 App.config）：
MDMUI_LOG_DIR/MDMUI.LogDirectoryMDMUI_LOG_MAX_MB/MDMUI.LogMaxMBMDMUI_LOG_RETENTION_DAYS/MDMUI.LogRetentionDaysMDMUI_LOG_DISABLED/MDMUI.LogDisabled
在 系统设置 中提供：
打开日志目录：直接打开日志文件夹日志查看器：在应用内查看日志文件、过滤关键字、复制内容、外部打开文件
未处理异常会弹出崩溃报告窗，支持：
- 复制异常详情
- 打开日志目录（便于定位问题）
关键路径采用 using (AppTelemetry.Measure("...")) 记录耗时，并写入日志（前缀 [perf]）。
项目以增量方式引入 Atomic Design：
- Atoms（原子）
MDMUI.Controls.Atoms.AppButton：语义化按钮（Primary / Secondary / Danger）MDMUI.Controls.Atoms.CardPanel：卡片容器（圆角、边框、抗锯齿）
- Molecules（分子）
MDMUI.Controls.Molecules.ActionToolbar：左侧输入区 + 右侧操作区的通用工具栏布局
主题与交互：
ThemeManager.ApplyTo(control)：统一应用颜色/字体/控件风格ModernTheme.EnableMicroInteractions(control)：按钮 hover/press 的轻量动效IThemeSelfStyled：自定义控件可实现该接口以避免被 ThemeManager 覆盖关键样式（遵循开闭原则）
GitHub Actions 工作流：.github/workflows/build.yml
msbuild /restore构建MDMUI.slndotnet test运行MDMUI.Tests
MDMUI is a runnable WinForms management demo focusing on:
- Clean layering (UI / BLL / DAL)
- Configurable policies (security, backup, theme)
- Observability (file logging, crash reporting, lightweight performance telemetry)
- Incremental UI design system (Atomic Design: Atoms / Molecules)
Note: This is a WinForms desktop app; Lighthouse (web) scores do not apply. Performance targets are tracked via internal telemetry logs and UI responsiveness improvements.
dotnet build .\MDMUI\MDMUI.sln -c Releasepwsh -File .\scripts\test.ps1 -Configuration Release- Default log dir:
%LOCALAPPDATA%\MDMUI\logs - Daily log file:
mdmui-YYYYMMDD.log(with size-based rotation) - Overrides: environment variables >
App.config(MDMUI_LOG_DIR,MDMUI_LOG_MAX_MB,MDMUI_LOG_RETENTION_DAYS,MDMUI_LOG_DISABLED)
Under System Settings:
Open Log Folderto open the directoryLog Viewerto view, filter, copy, and open log files inside the app