KArtSell.Aegis/docs/Design/kbx-foundation-v36/docs/validation-report-v33.md

KBX Foundation v33 Validation Report

1. 실행 명령

node scripts/validate-kbx.mjs

2. 최종 결과

PASS

주요 결과:

• TypeScript/Vue syntax transpile: 293 units PASS
• Screen Governance: 20 screens PASS
• Component Manifest: 84 components PASS
• Component Catalog: 56 entries / 34 core APIs PASS
• Navigation Manifest: 16 entries PASS
• Design Tokens: 143 PASS
• Field Governance: 51 canonical fields PASS
• API Governance: 66 operations / 7 problem types PASS
• Authorization: 54 permissions / 51 used / 5 sensitive PASS
• Integration Governance: 3 integrations / 4 scenarios PASS
• Migration Safety: 16 migrations PASS
• Test Governance: 27 scenarios / 16 fixture sets / 37 refs / golden 10/10 PASS
• Design Debt Ratchet: 268 <= 268 PASS
• Release Impact: required major / declared major PASS
• Tracked contract changes from baseline: 218

3. Template/Navigation 누적 Gate

• v29 PASS
• v30 PASS
• v31 PASS
• v32 PASS
• v33 PASS

v33 Gate 확인 항목:

1. idle state contract
2. T01~T09 stateCapabilities
3. Template idle recovery action
4. Permission Host provider/injection
5. Screen-level permission block
6. Command/Workflow/Bulk permission filtering
7. T09 permission boundary
8. Golden/Reference initial-state adoption
9. Home failed/urgent attention
10. Preference v3 bounded migration
11. Workspace URL length/control-character rejection
12. Component manifest/catalog version/state scenario

4. 기존 계약 회귀 확인

다음 기존 Gate도 모두 PASS했다.

• T01~T09 Template completeness
• Runtime Template Type Guard
• SearchPanel renderer de-duplication
• Grid productivity
• T04/T05 Golden behavior
• Record lifecycle
• Application shell
• Workspace multi-instance/pinning/focus
• Route capability recovery
• Recent route hardening
• Component catalog
• Design/Figma parity
• Release governance

5. 실행하지 않은 범위

이번 환경에서 다음을 실행했다고 주장하지 않는다.

• 실제 .NET 10 API host 기동
• 실제 PostgreSQL/Npgsql 연동
• Hangfire/SignalR 실서비스 연계
• Vitest 전체 runtime test suite
• Playwright browser E2E

Unit/E2E 소스는 보강했지만 최종 보증은 별도 CI/실행환경에서 수행해야 한다.

6. 잔여 기술부채

Design Debt ratchet은 268로 유지되었다. 신규 hard-coded literal 증가는 없다.

다음 우선 후보는 기존 debt가 큰 컴포넌트다.

• KbxExcelImport
• KbxExceptionDetailDrawer
• KbxLookupDialog
• KbxAiAssistant
• WMS Barcode Capture

다음 단계에서는 화면 수를 늘리기보다 이 공통 컴포넌트의 상태/토큰/테스트 품질을 먼저 줄이는 편이 효과적이다.