PowerShell 7 / Windows PowerShell 5.1과 .NET WPF(XAML)를 기반으로 구축된 모던 UI 통합 인프라 관리 도구입니다.
Active Directory, NetApp ONTAP 스토리지(Qtree/Quota/Share), MS SQL 데이터베이스를 단일 대시보드에서 제어할 수 있도록 설계되었으며, **실제 장비 연결(Live Mode)**과 **데모/시뮬레이션 모드(Mock Mode)**를 모두 지원합니다.
또한 향후 C# (.NET 8+ / WPF / WinUI 3)으로의 손쉬운 마이그레이션을 고려하여 완벽한 모듈화 및 XAML 분리 구조를 채택했습니다.

📚 상세 문서 바로가기

🏗️ 시스템 아키텍처 및 C# 전환 가이드 (ARCHITECTURE.md): 전체 시스템 다이어그램, 계층별 상세 설계, C# 인터페이스 매핑 가이드
📖 사용자 가이드 및 운영 매뉴얼 (USAGE.md): 설치 요구사항, 모드 전환 방법, 메뉴별 세부 기능 조작법, 트러블슈팅
⚡ 다중 DC(6대) 복제 지연 해결 및 비동기 가이드 (MULTI_DC_SYNC_GUIDE.md): 6대 DC 복제 지연(Replication Lag) 방지 전략, NetApp 활성 DC 감지, Task.Run 비동기 엔진 상세
📜 프로젝트 변경 이력 (CHANGELOG.md): 버전별 릴리즈 노트

🎨 주요 UI/UX 특징

Fluent / Windows 11 Modern Dark 테마:
- 부드러운 다크 색상 팔레트 (#0F172A, #1E293B, #3B82F6)
- 둥근 모서리(Border Radius), 카드(Card) 레이아웃, 모던 버튼 및 텍스트박스 스타일
- Windows 기본 내장 폰트인 Segoe MDL2 Assets 글리프 아이콘 활용 (추가 폰트 설치 불필요)
사이드바 내비게이션 & 동적 페이지 전환:
- 왼쪽 라디오 버튼 메뉴를 통해 부드러운 뷰(View) 전환 지원
- 뷰 캐싱(View Caching) 기법을 적용하여 페이지 전환 속도 최적화
실시간 동작 모드 시각화:
- 상단 헤더에 현재 모드(실제 연결 모드 (Live) vs 데모/모의 모드 (Mock))가 색상 배지로 실시간 표출

📂 프로젝트 구조

ModernAdminStudio/
│
├── Start-App.ps1             # 메인 실행 진입점 (XAML 파싱, 이벤트 라우팅, 페이지 네비게이션)
├── MainWindow.xaml           # Fluent 사이드바 및 헤더, View 호스트를 포함한 메인 윈도우
├── config.json               # 인프라 접속 엔드포인트 및 모드 설정 파일
├── Run.bat                   # 원클릭 실행 배치 파일 (PowerShell 7 우선 자동 감지)
├── README.md                 # 프로젝트 종합 안내
├── ARCHITECTURE.md           # 시스템 아키텍처 및 C# 마이그레이션 설계서
├── USAGE.md                  # 사용자 가이드 및 운영 매뉴얼
├── CHANGELOG.md              # 버전별 변경 이력
│
├── Styles/
│   └── Theme.xaml            # 글로벌 디자인 테마, 모던 컬러 브러시, 버튼/입력/그리드 스타일
│
├── Views/                    # 개별 메뉴별 독립 XAML 뷰 (UserControl 구조)
│   ├── DashboardView.xaml    # 인프라 종합 현황, KPI 카드, 최근 감사 이력, 빠른 실행
│   ├── ActiveDirectoryView.xaml # AD 사용자/그룹 목록, 계정 잠금 해제, 암호 초기화, 속성 패널
│   ├── NetAppView.xaml       # SVM 선택, Qtree 관리, Quota 한도/사용률, CIFS/NFS 공유 제어
│   ├── ShareAccessManagerView.xaml # DB 조회 기반 사용자 선택/해제 및 Share 동명 AD 그룹 동기화
│   ├── BatchWorkstationView.xaml # [신규] 다중 사용자, 처리사유, Share 및 Quota 일괄 작업 센터
│   ├── UserResolverDialog.xaml # [신규] 동명이인 판별 및 대량 사용자 검증 모달 다이얼로그
│   ├── SqlDatabaseView.xaml  # SQL 인스턴스, DB 상태, 즉시 백업 트리거, 간이 T-SQL 콘솔
│   └── SettingsView.xaml     # AD/스토리지/SQL 접속 엔드포인트 및 전체 연결 일괄 진단
│
└── Modules/                  # 백엔드 비즈니스 로직 (C# Service로 1:1 전환 가능)
    ├── ConfigService.ps1     # JSON 설정 로드/저장 관리 모듈
    ├── ADService.ps1         # Active Directory (.NET System.DirectoryServices) 모듈
    ├── NetAppService.ps1     # NetApp ONTAP REST API v2 연동 모듈
    ├── SqlService.ps1        # MS SQL Server (.NET System.Data.SqlClient) 모듈
    ├── ShareSyncService.ps1  # DB Share 조회 및 AD 동명 보안그룹 연계 모듈 (커스텀 전용 틀)
    └── UserResolverService.ps1 # [신규] 다중 텍스트 파싱 및 동명이인 자동 판별 엔진

🚀 빠른 시작 (Quick Start)

1. 원클릭 실행

Run.bat을 더블 클릭하여 실행합니다.

2. PowerShell에서 직접 실행

cd C:\dev\ws\ModernAdminStudio
pwsh -ExecutionPolicy Bypass -File .\Start-App.ps1

(Windows PowerShell 5.1에서도 동일하게 실행 가능합니다.)

⚙️ 실제 인프라 연결 설정 요약

앱 실행 후 좌측 사이드바에서 [환경설정 및 연결] 메뉴 클릭
상단의 실제 연결 모드 활성화 (Live Production Mode) 체크
각 대상 시스템 정보 입력:
- Active Directory: 도메인 컨트롤러 FQDN (예: dc01.corp.local), 기본 OU DN, 관리자 계정 정보
- NetApp ONTAP: 클러스터 HTTPS 주소 (예: https://10.200.10.50), 대상 SVM, 관리자 계정/비밀번호
- MS SQL Server: 인스턴스 주소 (예: localhost 또는 SRV\INSTANCE), 인증 방식(Windows/SQL)
각 섹션의 [연결 테스트] 또는 하단의 [전체 인프라 연결 상태 일괄 진단] 실행
**[설정 저장 및 적용]**을 클릭하여 즉시 적용