105 lines
3.7 KiB
Markdown
105 lines
3.7 KiB
Markdown
# 고객관리 어드민 Razor Pages 전환 로드맵
|
|
|
|
이 문서는 고객관리 어드민을 `ASP.NET Core 10 + Razor Pages + Dapper + PostgreSQL 18.4 + Flyway + Cookie Authentication + FluentValidation + Tabler UI + Minimal TypeScript` 기준으로 하네스하기 위한 실행 문서다.
|
|
|
|
## 목표
|
|
|
|
- 서버 렌더링 중심의 단순한 어드민 구조로 정리한다.
|
|
- 관리자 로그인은 Cookie Authentication 으로 통일한다.
|
|
- DB 변경은 Flyway migration 으로 관리한다.
|
|
- PageModel 은 흐름만 담당하고, SQL 은 Repository 또는 Query Class 로 보낸다.
|
|
- 화면은 Tabler UI 기반 공통 Partial 과 최소한의 ViewComponent 로 정리한다.
|
|
|
|
## 범위
|
|
|
|
- 포함
|
|
- 관리자 로그인
|
|
- 관리자 공통 레이아웃
|
|
- 고객 CRUD
|
|
- 관리자 유저 관리
|
|
- 대시보드
|
|
- 검증/테스트 하네스
|
|
|
|
- 제외
|
|
- SPA 라우팅
|
|
- React/Vue/Angular
|
|
- JWT 기반 브라우저 로그인
|
|
- API-first 어드민 화면
|
|
- 과도한 Clean Architecture
|
|
|
|
## 실행 원칙
|
|
|
|
- 먼저 문서와 폴더 기준을 고정한다.
|
|
- 다음으로 인증과 진입점부터 서버 렌더링으로 맞춘다.
|
|
- 이후 CRUD 화면을 페이지 단위로 옮긴다.
|
|
- 마지막에 로컬 테스트, 커밋, 푸시를 수행한다.
|
|
|
|
## 로드맵
|
|
|
|
### Phase 0. 기준 고정
|
|
|
|
- 아키텍처 원칙 문서화
|
|
- WBS 상세화
|
|
- 어드민 라우트와 공통 컴포넌트 규칙 확정
|
|
- 기존 Blazor / API / JWT 경로는 레거시로 분리
|
|
|
|
### Phase 1. 인증 전환
|
|
|
|
- `/admin/login` 을 Razor Pages form 기반으로 유지
|
|
- 로그인 성공 시 Cookie Authentication 발급
|
|
- `/admin` 하위 페이지에 인증 정책 적용
|
|
- Logout 은 쿠키 삭제 기반으로 정리
|
|
|
|
### Phase 2. 기본 CRUD 전환
|
|
|
|
- 고객 목록/상세/등록/수정/삭제 페이지 작성
|
|
- Request / Dto 분리
|
|
- FluentValidation 적용
|
|
- Dapper SQL 을 Repository 로 이동
|
|
|
|
### Phase 3. 공통 UI 정리
|
|
|
|
- `_Layout`, `_Sidebar`, `_Topbar` 정리
|
|
- `_ValidationSummary`, `_Pagination`, `_SearchBox`, `_ConfirmModal`, `_StatusBadge`, `_EmptyState` 정리
|
|
- 반복 헤더는 ViewComponent 로 정리
|
|
|
|
### Phase 4. DB 정합성
|
|
|
|
- Flyway migration 누락 점검
|
|
- 인덱스, 제약, soft delete 정책 정리
|
|
- seed data 와 운영 데이터 경계 정리
|
|
|
|
### Phase 5. 테스트 및 검증
|
|
|
|
- 로컬 빌드 통과
|
|
- 로컬 테스트 통과
|
|
- Playwright 시나리오 통과
|
|
- 변경분 커밋 및 푸시
|
|
|
|
## WBS
|
|
|
|
| ID | 작업 | 완료 기준 |
|
|
| --- | --- | --- |
|
|
| RP-01 | 어드민 아키텍처 문서화 | 본 문서와 하네스 문서가 `docs/INDEX.md`에 연결됨 |
|
|
| RP-02 | 로그인 쿠키 전환 | `/admin/login` 성공 시 Cookie Auth 가 발급되고 localStorage 토큰 저장이 제거됨 |
|
|
| RP-03 | 관리자 인증 정책 적용 | `/admin` 하위 페이지가 인증 없이 열리지 않음 |
|
|
| RP-04 | 공통 레이아웃 정리 | Tabler 기반 공통 레이아웃/partial 기준이 문서화됨 |
|
|
| RP-05 | 고객 CRUD 설계 | Request/Dto/Validator/Service/Repository 분리가 완료됨 |
|
|
| RP-06 | Flyway 보강 | 필요한 테이블/인덱스/제약이 migration 으로 관리됨 |
|
|
| RP-07 | 로컬 테스트 | `dotnet build`, 단위 테스트, Playwright 이 통과함 |
|
|
| RP-08 | 커밋/푸시 | 변경이 의도된 커밋으로 정리되고 원격에 반영됨 |
|
|
|
|
## 완료 정의
|
|
|
|
기능 하나가 완료되려면 아래가 충족되어야 한다.
|
|
|
|
- Razor Page 와 PageModel 이 존재한다.
|
|
- Request / Dto / Validator 가 분리되어 있다.
|
|
- Service 가 흐름을 담당한다.
|
|
- Repository 또는 Query Class 가 Dapper SQL 을 담당한다.
|
|
- 필요한 경우 Flyway migration 이 추가되어 있다.
|
|
- Tabler UI 기준으로 화면이 표시된다.
|
|
- 인증과 권한이 일치한다.
|
|
- 로컬 빌드와 테스트가 통과한다.
|
|
|