revert: rollback Fluent UI and Blazor homepage to last successful state (3be3794)
This commit is contained in:
@@ -12,23 +12,6 @@ Blazor (UI만, 사용자 액션 후 API 재조회) ← API (모든 로직) ← D
|
||||
Blazor 데이터 변경 자동 push/broadcast 금지
|
||||
```
|
||||
|
||||
### UI 기준 원칙 (2026-06-29 추가)
|
||||
- 기본 디자인 템플릿은 `https://v5.fluentui-blazor.net/` 기준으로 한다.
|
||||
- 신규 또는 리팩토링 UI는 Fluent UI Blazor v5 패턴을 우선 적용한다.
|
||||
- MudBlazor는 레거시 폐기 대상이다. 새 UI나 리팩토링 UI에서는 사용하지 않는다.
|
||||
- 기존 MudBlazor 잔여 코드는 Fluent v5 또는 순수 HTML/CSS로 점진 전환한다.
|
||||
- 기본 로딩 상태는 `Skeleton`이다. `MudProgressCircular` / `MudProgressLinear`는 예외적으로만 사용한다.
|
||||
- `MudDataGrid`, `MudDialog`, `MudTabs`는 폐기 대상이다. 새 작업에서는 사용하지 말고 Fluent v5 또는 순수 HTML/CSS 패턴으로 대체한다.
|
||||
- 목록, 카드, 대시보드, 상세 페이지의 초기 데이터 상태는 스켈톤으로 먼저 렌더링하고, 데이터 수신 후 실제 UI로 교체한다.
|
||||
- 로딩 중 블로킹 스피너보다 스켈톤을 우선한다.
|
||||
- 관리자와 공개 사이트는 가능한 한 같은 `design-tokens.css` / `ui-primitives.css` 기반으로 구성한다.
|
||||
- Blazor 진입점은 중복 매핑하지 말고, 동일 호스트 내에서 라우트 충돌이 없도록 단일 엔트리 기준으로 구성한다.
|
||||
- `@page` 중복이나 동일 경로의 Razor Pages + Blazor 중복 선언은 배포 전에 반드시 제거한다.
|
||||
|
||||
### 레거시 정책
|
||||
- MudBlazor, MudDataGrid, MudDialog, MudTabs는 신규 도입 금지다.
|
||||
- 남아 있는 레거시 UI는 우선순위에 따라 Fluent v5 또는 순수 HTML/CSS로 교체한다.
|
||||
|
||||
### SOLID 기반 순차 마이그레이션 전략
|
||||
|
||||
#### Phase 1-3: API Foundations ✅
|
||||
@@ -46,7 +29,6 @@ Blazor (UI만, 사용자 액션 후 API 재조회) ← API (모든 로직) ← D
|
||||
- AdminDashboardClient 구현
|
||||
- 서비스 inject → API 호출로 변경
|
||||
- 에러 처리 & 로딩 상태
|
||||
- 기본 로딩은 Skeleton 적용
|
||||
- [x] 구조: IAdminDashboardClient → HttpClient 추상화
|
||||
|
||||
**완료**: 2026-06-28 / Blazor 컴포넌트가 API 클라이언트를 통해 RESTful 엔드포인트 호출
|
||||
@@ -94,18 +76,10 @@ _refreshTokenExpirationMinutes = 10080;
|
||||
- 모든 API 엔드포인트 구현됨
|
||||
- 모든 Browser Client 구현됨
|
||||
- 16개 Blazor 페이지 API-First 마이그레이션 완료
|
||||
- 과거 기록: 관리 화면에서 그리드/모달 UX를 빠르게 안정화한 단계
|
||||
- 모달 패턴 (흰 화면 플래시 제거)
|
||||
- MudDataGrid Douzone ERP 수준 UX 적용
|
||||
- MudDialog 모달 패턴 (흰 화면 플래시 제거)
|
||||
- ConfirmDialog 삭제 확인 컴포넌트
|
||||
|
||||
### 2026-06-29 운영 기준 업데이트
|
||||
- 관리자 백오피스는 Fluent UI v5 우선 구조로 재정리한다.
|
||||
- 기본 로딩은 스피너가 아니라 Skeleton이다.
|
||||
- `design-tokens.css`와 `ui-primitives.css`는 사이트/관리자 공통의 기본 계층이다.
|
||||
- 라우팅 충돌은 가장 먼저 확인할 항목이며, 동일 경로가 두 번 등록되는 구조를 만들지 않는다.
|
||||
- 커밋은 기능/호스팅/UI/CSS처럼 주제별로 분리한다.
|
||||
- 레거시 제거 우선순위는 `MudBlazor` 계열 UI가 1순위다.
|
||||
|
||||
---
|
||||
|
||||
## 📊 **전체 프로젝트 완료 현황**
|
||||
@@ -144,7 +118,7 @@ _refreshTokenExpirationMinutes = 10080;
|
||||
**Phase 7-4: CRM & 세무관리 (신규 - 2026-06-28)** ✅
|
||||
- 5개 API Controller (TaxProfile, TaxFilingSchedule, ConsultingActivity, Contract, RevenueTracking)
|
||||
- 5개 Browser Client (API-First 패턴)
|
||||
- 5개 Blazor 페이지 (그리드 Dense, Virtualize, 모달 패턴)
|
||||
- 5개 Blazor 페이지 (MudDataGrid Dense, Virtualize, Modal Dialog)
|
||||
- Douzone ERP 수준의 그리드 UX (32px 행 높이, 데이터 밀도 최적화)
|
||||
|
||||
| 페이지 | API | Client | Blazor | 핵심 기능 |
|
||||
@@ -156,8 +130,8 @@ _refreshTokenExpirationMinutes = 10080;
|
||||
| RevenueTrackings | ✅ RevenueTrackingController | ✅ IRevenueTrackingBrowserClient | ✅ List + Modal | 청구/납부 추적, 상태 관리 |
|
||||
|
||||
**UI 특성**:
|
||||
- Dense 그리드 + Virtualize (1000+ 행 성능)
|
||||
- Create/Edit 모달 (흰 화면 플래시 방지)
|
||||
- MudDataGrid Dense (행높이 32px) + Virtualize (1000+ 행 성능)
|
||||
- MudDialog Create/Edit (흰 화면 플래시 방지)
|
||||
- ConfirmDialog Delete (사용자 확인)
|
||||
- Status Color Chips (Error/Warning/Success)
|
||||
- Client 링크 (상세 페이지 연동)
|
||||
@@ -215,8 +189,8 @@ PostgreSQL Database
|
||||
|
||||
**Blazor 페이지 & UI 고도화 (Phase 7-4)**:
|
||||
- [x] 5개 CRM/세무관리 Blazor 페이지
|
||||
- [x] Dense 그리드 + Virtualize (32px 행 높이)
|
||||
- [x] 모달 Create/Edit (흰 화면 플래시 제거)
|
||||
- [x] MudDataGrid Dense + Virtualize (32px 행 높이)
|
||||
- [x] MudDialog 모달 Create/Edit (흰 화면 플래시 제거)
|
||||
- [x] ConfirmDialog 삭제 확인
|
||||
- [x] 상태별 컬러 칩 (Status/Risk Level)
|
||||
- [x] 클라이언트 링크 (상세 페이지 연동)
|
||||
@@ -990,8 +964,6 @@ Admin 로그인 페이지만 [AllowAnonymous]:
|
||||
- 전역 상태 불필요 (세션 → DB에서 읽음)
|
||||
- 페이지 로드 시 `OnInitializedAsync`에서 데이터 가져오기
|
||||
- 업데이트는 `StateHasChanged()` 호출
|
||||
- 초기 렌더는 Skeleton 우선
|
||||
- 로딩이 필요한 목록/카드/대시보드는 `items == null` 또는 `summary == null` 패턴으로 스켈톤 렌더링
|
||||
|
||||
### 8.6 어드민 그리드 UX (Dorsum ERP 수준)
|
||||
|
||||
@@ -1011,11 +983,9 @@ Admin 로그인 페이지만 [AllowAnonymous]:
|
||||
- **페이징**: 하단 "1/10" 표시 + 이전/다음 버튼 (기본 20행/페이지)
|
||||
- **검색**: 우상단 검색 박스 (실시간 필터링, 하이라이트 처리)
|
||||
|
||||
#### UI 적용 패턴
|
||||
#### MudBlazor 적용 패턴
|
||||
```razor
|
||||
```razor
|
||||
<!-- 과거 예시: 현재는 Fluent v5 표나 HTML table로 대체 -->
|
||||
<YourGridComponent T="YourItem"
|
||||
<MudDataGrid T="YourItem"
|
||||
Dense="true"
|
||||
Hover="true"
|
||||
Striped="true"
|
||||
@@ -1041,8 +1011,7 @@ Admin 로그인 페이지만 [AllowAnonymous]:
|
||||
</CellTemplate>
|
||||
</TemplateColumn>
|
||||
</Columns>
|
||||
</YourGridComponent>
|
||||
```
|
||||
</MudDataGrid>
|
||||
```
|
||||
|
||||
#### 색상 & 상태 표시
|
||||
@@ -1157,7 +1126,7 @@ Admin 로그인 페이지만 [AllowAnonymous]:
|
||||
<!-- 로딩 상태 -->
|
||||
@if (items == null)
|
||||
{
|
||||
<Skeleton Count="6" CssClass="taxbaik-skeleton-grid" />
|
||||
<MudProgressCircular Indeterminate="true" Class="mt-4" />
|
||||
}
|
||||
<!-- 빈 상태 -->
|
||||
else if (items.Count == 0)
|
||||
@@ -1167,9 +1136,7 @@ else if (items.Count == 0)
|
||||
<!-- 데이터 그리드 -->
|
||||
else
|
||||
{
|
||||
```razor
|
||||
<!-- 과거 예시: 현재는 Fluent v5 표나 HTML table로 대체 -->
|
||||
<YourGridComponent T="YourEntity"
|
||||
<MudDataGrid T="YourEntity"
|
||||
Items="@items"
|
||||
Dense="true"
|
||||
Hover="true"
|
||||
@@ -1180,16 +1147,13 @@ else
|
||||
<Columns>
|
||||
<!-- 필수: 컬럼 정의 -->
|
||||
</Columns>
|
||||
</YourGridComponent>
|
||||
```
|
||||
</MudDataGrid>
|
||||
}
|
||||
```
|
||||
|
||||
**Step 3: 모달 다이얼로그 (Create/Edit)**
|
||||
```razor
|
||||
```razor
|
||||
<!-- 과거 예시: 현재는 Fluent v5 Dialog 또는 별도 라우트로 대체 -->
|
||||
<YourDialogComponent @bind-IsVisible="isDialogOpen">
|
||||
<MudDialog @bind-IsVisible="isDialogOpen" Options="new DialogOptions { MaxWidth = MaxWidth.Small, FullWidth = true }">
|
||||
<TitleContent>
|
||||
<MudText Typo="Typo.h6">@(isEditMode ? "항목 수정" : "새 항목 추가")</MudText>
|
||||
</TitleContent>
|
||||
@@ -1202,8 +1166,7 @@ else
|
||||
<MudButton OnClick="CloseDialog">취소</MudButton>
|
||||
<MudButton Color="Color.Primary" OnClick="SaveItem">저장</MudButton>
|
||||
</DialogActions>
|
||||
</YourDialogComponent>
|
||||
```
|
||||
</MudDialog>
|
||||
```
|
||||
|
||||
**Step 4: @code 섹션 구조**
|
||||
@@ -1325,10 +1288,10 @@ else
|
||||
- [ ] @inject로 필요한 Client 주입
|
||||
- [ ] <PageTitle> 추가
|
||||
- [ ] <section class="admin-page-hero"> (캡션, 제목, 부제, 추가 버튼)
|
||||
- [ ] 로딩 상태 기본값은 `Skeleton`
|
||||
- [ ] 로딩 상태 (MudProgressCircular)
|
||||
- [ ] 빈 상태 (MudAlert)
|
||||
- [ ] Dense 그리드 (Virtualize=true, RowsPerPage=30, admin-grid 클래스)
|
||||
- [ ] 모달 (Create/Edit)
|
||||
- [ ] MudDataGrid (Dense=true, Virtualize=true, RowsPerPage=30, admin-grid 클래스)
|
||||
- [ ] MudDialog (Create/Edit 모달)
|
||||
- [ ] ConfirmDialog (Delete 확인)
|
||||
- [ ] @code 섹션: OnInitializedAsync → LoadData() 패턴
|
||||
- [ ] 모든 에러 처리 (try-catch, Snackbar 메시지)
|
||||
@@ -1339,7 +1302,7 @@ else
|
||||
❌ **이 패턴을 따르지 않는 페이지는 실시간 코드 리뷰 대상:**
|
||||
- 페이지 헤더 (admin-page-hero) 누락
|
||||
- 인라인 스타일로 레이아웃 구성
|
||||
- 별도 라우트로 Create/Edit 처리 (흰 화면 플래시)
|
||||
- MudDialog 없이 별도 라우트로 Create/Edit 처리 (흰 화면 플래시)
|
||||
- @code 섹션 구조 다름
|
||||
- 모달에서 직접 onSubmit 대신 Snackbar 피드백 미제공
|
||||
|
||||
@@ -1760,9 +1723,7 @@ public async Task NotifyDeploymentStart()
|
||||
@* Components/Admin/Shared/DeploymentNotification.razor *@
|
||||
@if (showNotification)
|
||||
{
|
||||
```razor
|
||||
<!-- 과거 예시: 현재는 Fluent v5 Dialog 또는 HTML/CSS 패턴으로 대체 -->
|
||||
<YourDialogComponent @bind-Visible="showNotification">
|
||||
<MudDialog @bind-Visible="showNotification">
|
||||
<TitleContent>
|
||||
<MudText Typo="Typo.h6">새 버전 배포</MudText>
|
||||
</TitleContent>
|
||||
@@ -1777,8 +1738,7 @@ public async Task NotifyDeploymentStart()
|
||||
<MudButton Color="Color.Primary" OnClick="RefreshNow">지금 새로고침</MudButton>
|
||||
<MudButton Color="Color.Default" OnClick="DismissNotification">나중에</MudButton>
|
||||
</DialogActions>
|
||||
</YourDialogComponent>
|
||||
```
|
||||
</MudDialog>
|
||||
}
|
||||
|
||||
@code {
|
||||
|
||||
Reference in New Issue
Block a user