2.4 KiB
2.4 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 통과 후 완료 |
Document Rules
- 문서는 짧게 유지한다. 새 문서를 만들기 전에 이 인덱스에 추가할 가치가 있는지 판단한다.
- 동일한 기준을 여러 문서에 중복 작성하지 않는다.
- WBS 완료 여부는 체크박스가 아니라 수치와 실행 로그로 판단한다.
- 코드 변경 시 관련 WBS ID를 커밋/PR 설명 또는 작업 메모에 남긴다.
- 공통코드 관련 규칙은 COMMON_CODE_POLICY.md만 1차 기준으로 사용한다.