4.0 KiB
4.0 KiB
TaxBaik Engineering Index
이 디렉터리의 문서만 현재 개발 기준의 기준점으로 사용한다. 다른 문서는 보조 자료로만 본다.
Canonical Documents
| 문서 | 용도 | 변경 조건 |
|---|---|---|
| ENGINEERING_HARNESS.md | 아키텍처, 코드 품질, 배포, 데이터 정합성 하네스 | 방향성 변경 또는 반복 위반 발견 |
| DOUZONE_UX_GUIDE.md | 더존식 어드민 UX 원칙, 템플릿, 컴포넌트, 서빙 규칙 | 화면 패턴 변경 또는 신규 템플릿 추가 |
| COMMON_CODE_POLICY.md | 공통코드, 저장값, 컬럼 길이, 하드코딩 금지 규칙 | 공통코드 또는 콤보 추가/수정 |
| COMBO_POLICY.md | 콤보/선택/검색 입력 정책과 저장값 규칙 | 상태/유형/선택 입력 정책 변경 |
| ADMIN_PATTERN_CRITIQUE_WBS.md | 어드민 Blog/문의 등록 패턴 비판, 개선 로드맵, 정량 WBS | WBS 상태 또는 성공 지표 변경 |
Route And Serving Map
| 영역 | 라우트/파일 | 기준 |
|---|---|---|
| Public Home/Blog/Contact | /taxbaik/, /taxbaik/blog, /taxbaik/contact |
서버 사이드 렌더링, SEO 우선, WASM 의존 금지 |
| Admin Blog | /taxbaik/admin/blog, /taxbaik/admin/blog/create, /taxbaik/admin/blog/{id}/edit |
클라이언트 사이드 Blazor WebAssembly, API-first 클라이언트 경유, JS 최소화 |
| Admin Inquiry | /taxbaik/admin/inquiries, /taxbaik/admin/inquiries/create, /taxbaik/admin/inquiries/{id}/edit |
클라이언트 사이드 Blazor WebAssembly, 공개 접수/관리자 등록/상태 변경 분리 |
| Public API | /taxbaik/api/* |
JWT 인증, ProblemDetails 오류, DTO 입출력 |
| CI/CD | .gitea/workflows/deploy.yml, .gitea/workflows/browser-e2e.yml |
수동 배포 금지, 배포본 E2E 통과 후 완료 |
Shared Component Map
| 컴포넌트 | 용도 | 대표 사용처 |
|---|---|---|
AdminShell |
관리자 상단바/드로워/버전/알림 공통 shell | Components/Admin/Layout/MainLayout.razor |
AdminLoginForm |
관리자 로그인 입력/제출 UI | Components/Admin/Pages/Login.razor |
AdminPageHeader |
페이지 타이틀/보조설명/주요 액션 | Blog, Inquiry, Client, FAQ 목록 |
AdminDataPanel |
목록/표면/로딩 스켈레톤 공통 래퍼 | Blog, Inquiry, CommonCode, Dashboard |
AdminEditorPanel |
편집형 스켈레톤 래퍼 | BlogEdit, InquiryEdit, ClientEdit, CompanyEdit, FAQEdit |
AdminSkeletonRows |
반복 로딩 골격 | AdminDataPanel, AdminEditorPanel, Dashboard |
AdminMetricCard |
대시보드 KPI 카드 | Components/Admin/Pages/Dashboard.razor |
AdminEmptyState |
empty/empty-filter 상태 | ClientList 등 목록 화면 |
AdminFormSection |
폼 입력 섹션 구획 | BlogForm, InquiryForm |
AdminFormActions |
제출/취소 버튼 묶음 | BlogForm, InquiryForm |
AdminDetailSection |
상세 정보 카드 | InquiryDetail |
AdminCrudPageShell |
create/edit 페이지 공통 헤더+취소+편집 래퍼 | BlogCreate/Edit, InquiryCreate/Edit |
CommonCodeGroupPanel |
공통코드 그룹 선택/추가 패널 | CommonCodes |
CommonCodeListPanel |
공통코드 목록/편집 패널 | CommonCodes |
Document Rules
- 문서는 짧게 유지한다. 새 문서를 만들기 전에 이 인덱스에 추가할 가치가 있는지 판단한다.
- 동일한 기준을 여러 문서에 중복 작성하지 않는다.
- 아키텍처/UX/콤보/공통코드 기준은
ENGINEERING_HARNESS.md,DOUZONE_UX_GUIDE.md,COMBO_POLICY.md,COMMON_CODE_POLICY.md만 본다. - WBS 완료 여부는 체크박스가 아니라 수치와 실행 로그로 판단한다.
- 코드 변경 시 관련 WBS ID를 커밋/PR 설명 또는 작업 메모에 남긴다.
- 공통코드 관련 규칙은 COMMON_CODE_POLICY.md만 1차 기준으로 사용한다.
- 공유 컴포넌트는
INDEX.md의 Shared Component Map을 먼저 확인한다.