173 lines
8.1 KiB
Markdown
173 lines
8.1 KiB
Markdown
|
# Enterprise Admin Studio - 아키텍처 설계 문서 (ARCHITECTURE.md)
|
||
|
|
|
||
|
|
## 1. 개요 (Overview)
|
||
|
|
|
||
|
|
**Enterprise Admin Studio**는 Windows 및 기업 인프라의 3대 핵심 컴포넌트인 **Active Directory (AD DS)**, **NetApp ONTAP 스토리지 (Qtree, Quota, Share)**, **Microsoft SQL Server**를 단일 화면에서 통합 모니터링 및 제어할 수 있는 모던 UI 기반의 관리 콘솔입니다.
|
||
|
|
|
||
|
|
본 프로젝트는 **PowerShell 7 / Windows PowerShell 5.1**과 **.NET WPF (XAML)** 기술을 기반으로 구축되었으며, 차후 엔터프라이즈 환경에서 필요 시 **C# (.NET 8+ / WPF / WinUI 3)** 환경으로의 100% 무손실 전환이 가능하도록 철저한 계층 분리(Separation of Concerns) 아키텍처를 채택했습니다.
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 2. 전체 시스템 구조도 (System Architecture)
|
||
|
|
|
||
|
|
```mermaid
|
||
|
|
flowchart TD
|
||
|
|
subgraph Presentation_Layer ["Presentation Layer (UI/XAML)"]
|
||
|
|
MW["MainWindow.xaml\n(Fluent Dark Frame, Sidebar Navigation, Mode Badge)"]
|
||
|
|
Styles["Styles/Theme.xaml\n(Color Palette, Modern Controls, Icons)"]
|
||
|
|
|
||
|
|
subgraph Views ["Views (Dynamic UserControls)"]
|
||
|
|
V1["DashboardView.xaml\n(KPI Cards, Audit Grid)"]
|
||
|
|
V2["ActiveDirectoryView.xaml\n(User Grid, Detail Inspector)"]
|
||
|
|
V3["NetAppView.xaml\n(Qtree, Quota, CIFS/NFS Tabs)"]
|
||
|
|
V4["SqlDatabaseView.xaml\n(DB Grid, T-SQL Console)"]
|
||
|
|
V5["SettingsView.xaml\n(Endpoint Config, Diagnostic)"]
|
||
|
|
end
|
||
|
|
end
|
||
|
|
|
||
|
|
subgraph Application_Core ["Application Core (PowerShell Routing & Cache)"]
|
||
|
|
Entry["Start-App.ps1\n(Application Entrypoint & Event Dispatcher)"]
|
||
|
|
Router["Page Navigator & ViewCache\n(Fast Instant Page Switching)"]
|
||
|
|
Config["config.json & ConfigService.ps1\n(Persistent Configuration Engine)"]
|
||
|
|
end
|
||
|
|
|
||
|
|
subgraph Service_Layer ["Service / Business Logic Layer (Modules)"]
|
||
|
|
AD_SVC["ADService.ps1\n[IActiveDirectoryService]"]
|
||
|
|
NETAPP_SVC["NetAppService.ps1\n[INetAppStorageService]"]
|
||
|
|
SQL_SVC["SqlService.ps1\n[ISqlServerService]"]
|
||
|
|
end
|
||
|
|
|
||
|
|
subgraph Infrastructure_Targets ["Target Enterprise Infrastructure"]
|
||
|
|
DC["Active Directory Domain Controller\n(LDAP / LDAPS Port 389/636)"]
|
||
|
|
ONTAP["NetApp ONTAP Cluster\n(REST API v2 / HTTPS 443)"]
|
||
|
|
MSSQL["MS SQL Server Instance\n(TDS Protocol / TCP 1433)"]
|
||
|
|
end
|
||
|
|
|
||
|
|
MW --> Router
|
||
|
|
Router --> Views
|
||
|
|
Styles -.-> MW
|
||
|
|
Styles -.-> Views
|
||
|
|
|
||
|
|
Entry --> Router
|
||
|
|
Entry --> Config
|
||
|
|
|
||
|
|
Views --> AD_SVC
|
||
|
|
Views --> NETAPP_SVC
|
||
|
|
Views --> SQL_SVC
|
||
|
|
|
||
|
|
AD_SVC --> DC
|
||
|
|
NETAPP_SVC --> ONTAP
|
||
|
|
SQL_SVC --> MSSQL
|
||
|
|
```
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 3. 계층별 상세 설계 (Layer Details)
|
||
|
|
|
||
|
|
### 3.1 Presentation Layer (XAML UI)
|
||
|
|
- **Fluent Modern Dark 테마**:
|
||
|
|
- 배경: `#0F172A` (Slate Dark), 카드/사이드바: `#1E293B`, 액센트: `#3B82F6` / `#6366F1`
|
||
|
|
- 표준 WPF 컨트롤 템플릿(`Button`, `TextBox`, `RadioButton`, `DataGrid`, `TabControl`, `Border`)을 모던 라운딩 처리
|
||
|
|
- **네이티브 아이콘 시스템**:
|
||
|
|
- 외부 폰트 설치나 대용량 SVG 의존성 없이 Windows 10/11 기본 탑재 글꼴인 `Segoe MDL2 Assets`의 유니코드 글리프(예: ``, ``, ``) 사용
|
||
|
|
- **Dynamic View Hosting**:
|
||
|
|
- `MainWindow.xaml` 내 `ContentControl x:Name="MainContentHost"`에 각 View를 동적 인스턴스화
|
||
|
|
- `ViewCache` 해시테이블을 두어 최초 로드 후 페이지 전환 시 재파싱 비용을 제거하여 네이티브 수준의 부드러운 전환 구현
|
||
|
|
|
||
|
|
### 3.2 Service & Integration Layer (비즈니스 로직)
|
||
|
|
|
||
|
|
#### A. Active Directory 연동 (`ADService.ps1`)
|
||
|
|
- **기술 스택**: Windows 기본 내장 `.NET System.DirectoryServices`
|
||
|
|
- **프로토콜**: LDAP (Port 389) 또는 LDAPS (Port 636)
|
||
|
|
- **동작 원리**:
|
||
|
|
1. `DirectoryEntry`를 통해 지정된 도메인 컨트롤러 또는 기본 도메인에 바인딩 (자격증명 지원)
|
||
|
|
2. `DirectorySearcher`를 이용해 `(&(objectCategory=person)(objectClass=user))` 필터링 및 페이징(PageSize = 1000) 처리
|
||
|
|
3. 속성 매핑:
|
||
|
|
- `userAccountControl`: `0x0002` 비트 연산을 통한 활성/비활성 판정 및 변경
|
||
|
|
- `lockoutTime`: 정수값을 통한 잠금 여부 확인 및 `lockoutTime = 0` 커밋을 통한 계정 잠금 해제
|
||
|
|
- `Invoke("SetPassword", ...)`: 안전한 비밀번호 초기화 및 `pwdLastSet = 0` 강제 변경 플래그
|
||
|
|
4. **Fallback 메커니즘**: AD 환경이 아닌 로컬 PC나 개발 환경에서는 자동으로 Mock 데이터 및 데모 시뮬레이션으로 안전하게 동작
|
||
|
|
|
||
|
|
#### B. NetApp ONTAP 스토리지 연동 (`NetAppService.ps1`)
|
||
|
|
- **기술 스택**: NetApp ONTAP 9.6+ 표준 REST API (HTTPS RESTful)
|
||
|
|
- **엔드포인트 매핑**:
|
||
|
|
- Qtree 관리: `GET /api/storage/qtrees`, `POST /api/storage/qtrees`
|
||
|
|
- Quota 한도/모니터링: `GET /api/storage/quota/rules`, `GET /api/storage/quota/reports`
|
||
|
|
- CIFS 파일 공유: `GET /api/protocols/cifs/shares`, `POST /api/protocols/cifs/shares`
|
||
|
|
- NFS 내보내기 정책: `GET /api/protocols/nfs/export-policies`
|
||
|
|
- 클러스터 상태 진단: `GET /api/cluster`
|
||
|
|
- **보안 및 인증**: HTTP Basic Authentication 및 자체 서명 SSL 인증서 무시 처리(`IgnoreSslErrors`) 옵션 내장
|
||
|
|
|
||
|
|
#### C. MS SQL Server 연동 (`SqlService.ps1`)
|
||
|
|
- **기술 스택**: .NET 기본 제공 `System.Data.SqlClient`
|
||
|
|
- **프로토콜**: Tabular Data Stream (TDS, Port 1433)
|
||
|
|
- **동작 원리**:
|
||
|
|
1. Windows 통합 인증(Integrated Security) 및 SQL Server 계정(User ID / Password) 인증 동시 지원
|
||
|
|
2. `sys.databases`, `sys.master_files`, `msdb.dbo.backupset` 카탈로그 뷰를 조인하여 실제 데이터베이스 상태, 용량, 복구 모델, 최종 Full 백업 일시 동적 집계
|
||
|
|
3. `BACKUP DATABASE [{0}] TO DISK = '{1}' WITH INIT, STATS = 10` 실제 데이터베이스 백업 수행
|
||
|
|
4. T-SQL 간이 쿼리 실행기: 사용자 입력을 파싱하여 `SqlDataAdapter`로 DataTable에 적재 후 결과 포맷팅
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 4. C# (.NET 8 / WPF / WinUI 3) 마이그레이션 로드맵
|
||
|
|
|
||
|
|
향후 C# 솔루션으로 승격(Promote) 시 100% 매핑되도록 설계되었습니다.
|
||
|
|
|
||
|
|
### 4.1 XAML 파일의 무수정 재사용
|
||
|
|
`Views/*.xaml` 및 `Styles/Theme.xaml`은 표준 WPF 문법을 준수합니다. C# 프로젝트에 그대로 포함하고 아래와 같이 코드 비하인드만 연결하면 됩니다:
|
||
|
|
```csharp
|
||
|
|
namespace ModernAdminStudio.Views;
|
||
|
|
|
||
|
|
public partial class ActiveDirectoryView : UserControl
|
||
|
|
{
|
||
|
|
public ActiveDirectoryView()
|
||
|
|
{
|
||
|
|
InitializeComponent();
|
||
|
|
}
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
### 4.2 MVVM 및 DI (의존성 주입) 패턴 매핑
|
||
|
|
```csharp
|
||
|
|
// Program.cs 또는 App.xaml.cs
|
||
|
|
services.AddSingleton<IActiveDirectoryService, ActiveDirectoryService>();
|
||
|
|
services.AddSingleton<INetAppStorageService, NetAppStorageService>();
|
||
|
|
services.AddSingleton<ISqlServerService, SqlServerService>();
|
||
|
|
|
||
|
|
services.AddTransient<DashboardViewModel>();
|
||
|
|
services.AddTransient<ActiveDirectoryViewModel>();
|
||
|
|
services.AddTransient<NetAppViewModel>();
|
||
|
|
services.AddTransient<SqlDatabaseViewModel>();
|
||
|
|
services.AddTransient<SettingsViewModel>();
|
||
|
|
```
|
||
|
|
|
||
|
|
### 4.3 서비스 인터페이스 정의서 (C# Blueprint)
|
||
|
|
```csharp
|
||
|
|
public interface IActiveDirectoryService
|
||
|
|
{
|
||
|
|
Task<IEnumerable<AdUserDto>> GetUsersAsync(string filter);
|
||
|
|
Task<OperationResult> UnlockAccountAsync(string samAccountName);
|
||
|
|
Task<OperationResult> ResetPasswordAsync(string samAccountName, string newPassword);
|
||
|
|
Task<OperationResult> SetAccountStateAsync(string samAccountName, bool enable);
|
||
|
|
Task<ConnectionResult> TestConnectionAsync();
|
||
|
|
}
|
||
|
|
|
||
|
|
public interface INetAppStorageService
|
||
|
|
{
|
||
|
|
Task<IEnumerable<QtreeDto>> GetQtreesAsync(string svm);
|
||
|
|
Task<IEnumerable<QuotaDto>> GetQuotasAsync(string svm);
|
||
|
|
Task<IEnumerable<ShareDto>> GetSharesAsync(string svm);
|
||
|
|
Task<OperationResult> CreateQtreeAsync(CreateQtreeRequest request);
|
||
|
|
Task<OperationResult> CreateShareAsync(CreateShareRequest request);
|
||
|
|
Task<ConnectionResult> TestConnectionAsync();
|
||
|
|
}
|
||
|
|
|
||
|
|
public interface ISqlServerService
|
||
|
|
{
|
||
|
|
Task<IEnumerable<DatabaseInfoDto>> GetDatabasesAsync();
|
||
|
|
Task<OperationResult> BackupDatabaseAsync(string databaseName, string targetPath);
|
||
|
|
Task<QueryResultDto> ExecuteQuerySnippetAsync(string query);
|
||
|
|
Task<ConnectionResult> TestConnectionAsync();
|
||
|
|
}
|
||
|
|
```
|