docs: add lint guardrails to harness

2026-07-04 21:34:31 +09:00
parent 1330ef7c1d
commit 2871df54c4
1 changed files with 5 additions and 0 deletions
@@ -73,6 +73,8 @@
 - 로그인 화면 실증 기준은 최소 1회 실제 브라우저 응답, 로그인 폼 렌더, 입력 포커스 가능 여부 확인이다.
 - 공개 루트와 관리자 루트는 반드시 분리 검증한다. `https://www.taxbaik.com/` 은 공용 홈페이지 제목을 가져야 하고, `https://www.taxbaik.com/taxbaik/admin/login` 은 관리자 제목을 가져야 한다.
 - 배포 후 smoke 기준은 `scripts/taxbaik-smoke.sh`를 1차 기준으로 사용한다. CI와 브라우저 E2E는 이 스크립트를 재사용해야 한다.
+- `UsePathBase("/taxbaik")`가 있는 Web 앱에서 `MapGet("/")` 같은 루트 리다이렉트를 추가할 때는, 반드시 루프 여부를 `curl`로 먼저 확인하고 나서만 반영한다. `/`와 `/taxbaik/`가 서로를 다시 가리키면 안 된다.
+- nginx의 `location /`와 `location /taxbaik`를 건드린 뒤에는, 변경 직후 `curl -I https://www.taxbaik.com/`, `curl -I https://www.taxbaik.com/taxbaik/`, `curl -I https://www.taxbaik.com/taxbaik/admin/login` 순서로 확인하고 결과를 기록한다.
 - 클라이언트 로그와 장애 진단 로그는 운영 데이터가 아니라 관측 데이터로 본다. 저장 실패는 사용자 흐름을 막지 않으며, 수집 실패 자체를 재시도 루프로 증폭하지 않는다.
 - 동일 오류의 텔레그램 재알림은 일정 기간 1회로 제한하고, 재전송 목적의 루프는 금지한다.
 - 데이터가 오류 재현에 필요하면 `entity`, `entityId`, `dataKey` 같은 최소 식별자만 남기고, 원문 데이터 전체를 로그에 싣지 않는다.
@@ -141,6 +143,7 @@ public class GetBlogEndpoint : Endpoint<GetBlogRequest, GetBlogResponse>
 | Build | `dotnet build src/TaxBaik.sln -c Release --no-restore` | error 0 |
 | Unit | `dotnet test src/TaxBaik.sln -c Release --no-build` | failed 0 |
 | Browser | `npx playwright test --project="Desktop Chrome"` | failed 0 |
+| Lint | 존재하는 경우 `dotnet format --verify-no-changes`, ESLint/Stylelint 등 프로젝트 기본 lint | 경고/오류 0 |
 | API Smoke | login + protected admin API curl | HTTP 2xx |
 | Deploy | `.gitea/workflows/deploy.yml` | success |
 | Post Deploy | `.gitea/workflows/browser-e2e.yml` | success |
@@ -158,4 +161,6 @@ public class GetBlogEndpoint : Endpoint<GetBlogRequest, GetBlogResponse>
 - 동일 개념이 3곳 이상 다른 이름/계약으로 구현되면 기능 추가를 중단하고 정리한다.
 - UI가 저장한다고 보이는 필드를 API/Application이 저장하지 않으면 릴리스하지 않는다.
 - 운영 배포 검증이 CI 밖에서만 가능하면 완료로 보지 않는다.
+- `UsePathBase` 아래에서 루트 기본값을 만들려면 리다이렉트보다 실제 최종 콘텐츠가 나오는지 먼저 확인한다. 루트가 `/taxbaik/`를 다시 반환하면 즉시 중단한다.
+- lint가 필요하면 build보다 먼저, 그리고 배포보다 훨씬 앞단에서 실패시키고, lint가 없는 프로젝트에 억지로 새 lint 체계를 만들지 않는다.
 - 데이터 모델을 추측해서 세무 규칙이나 더존 UX 관습을 왜곡해 구현하지 않는다.