🛠️ 개발

📄️온보딩

너홀로프로에 처음 합류하시는 분을 위한 30분 셋업 가이드입니다. 설치 → 로컬 실행 → 코드 탐색 → 핵심 규칙 파악까지 한 번에.

너홀로프로는 main 브랜치 = production 입니다. merge 후 수동 rollout 으로 배포합니다 — App Hosting rolloutPolicy.disabled=true 라 main push 만으로는 자동 배포되지 않으며, 배포자가 Firebase Console / CLI 로 rollout 을 트리거해야 한다 (2026-06-07 정정: 과거 "자동 배포" 표기는 실제 backend 설정과 불일치였다). 별도의 자동 태깅·GitHub Release 는 사용하지 않습니다 (2026-05-01 폐기) — 배포 단위는 main 의 commit SHA, 롤백은 App Hosting 의 SHA 단위 rollback.

📄️Stress 테스트

기존 e2e (테스트 가이드) 가 사건 1~5건 cold-start 만 검증하는 한계를 보완. 사무소가 1~5년 운영하면 누적되는 회귀 (페이지네이션·N+1·인덱스 누락·findNearest p95·격리 누설·UI race) 를 nightly 로 사전 차단.

📄️Git & PR 컨벤션

너홀로프로의 브랜치·커밋·PR 규칙. 컨벤션은 git log 가독성·squash merge 시 main 히스토리 품질을 위한 것이며, 별도의 자동 태깅·릴리스는 사용하지 않습니다 (2026-05-01 폐기).

📄️보안 체크리스트

너홀로프로는 법률 사무소 PII (주민번호·사건번호·채권자 정보) 를 다루므로 보안 실수의 블러스트가 큽니다. 본 문서는 CLAUDE.md 와 각 아키텍처 문서에 흩어진 보안 규칙을 개발자가 PR 전에 훑을 수 있는 단일 체크리스트 로 통합합니다.

📄️에뮬레이터 개발

로컬에서 production Firestore 를 건드리지 않고 안전하게 개발·검증하는 표준 흐름.

📄️멀티테넌트 격리 — collectionGroup 가드 레일

assertTenantFilter 3-layer 방어 중 Layer 1 (런타임 guardedCollectionGroup) 사용법 + 기존 호출부 인벤토리

📄️구조화 로거 — Cloud Logging

Cloud Run 자동 파싱을 활용한 JSON 구조화 로그 — logInfo·logWarn·logError 유틸

📄️demo-firm-memory walkthrough — 자기 데이터로 자기 AI 학습 검증

위상: ADR 0015 "Tenant 격리 AI 학습" 의 production 동작 검증 가이드. 합성 부트스트랩 (scripts/seed-synthetic-firm-memory.ts) 이 시드한 demo-firm-memory tenant 를 영구 dev 자산으로 운영. e2e spec (e2e/synthetic-firm-memory-production-walkthrough.spec.ts) 이 V2 RelatedMemoriesPanel + AiPrefillCard 가시성 회귀 가드.

📄️UI Editorial 심화 — 화면별 worklist (자율 sweep)

BI 개편(고요한 권위 + 딥 그린, [[projectbieditorialgreen20260530]] / PR #2461·#2462) 이후, 모든 화면을 editorial 기준으로 심화하는 자율 sweep 의 진행 추적 SSoT. 스케줄 루틴이 이 파일을 읽어 다음 pending 화면을 이어받는다.