docs(architecture): add OMS·WMS·ERP commercialization WBS as Phase 12 foundation

- Complete 1,600-line WBS (spec/60_oms_wms_erp_wbs.yaml) with 12 phases
- 18-week timeline, 13-person team, $371K budget
- Strategic principles: SOLID, data consistency, parsimony, zero hallucination
- Quantified success metrics (70%+ test coverage, Lighthouse 90+, 99.9% uptime)
- Phase breakdown: Requirements → Development → Testing → Deployment → Stabilization
- Phase 0 (Week 1-2): Baseline establishment, FRD, OpenAPI spec, wireframes
- Phase 1-11: Progressive build-out of 4-layer components + 11 CRUD templates
- Gated by QuantEngine Phase 2 completion (KIS API production validation)
- 30-year senior architect perspective: architecture, PM, PL, dev, UX, QA, ops

Alignment with QuantEngine roadmap: Phase 12 (OMS·WMS·ERP) follows Phase 5 (Admin UI).

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>

CLAUDE.md

@@ -1159,3 +1159,166 @@ When modifying workflows (.gitea/workflows/*.yml):
 **Dependencies**: 
 - Release creation (prepare-release.yml) is gated by ci.yml success (workflow_run trigger)
 - Deployment (deploy-prod.yml) is manual — only after release artifact exists
+
+---
+
+## OMS·WMS·ERP Commercialization Project WBS (2026-07-26)
+
+**OFFICIAL PROJECT FOUNDATION** — 30-Year Senior Architect/PM/PL/Dev/UX/QA/User Perspective
+
+### Strategic Vision
+
+**Objective**: Enterprise-grade Order Management (OMS) + Warehouse Management (WMS) + Enterprise Resource Planning (ERP) platform commercialization with:
+- 4-layer input components (Primitive/Composite/Smart/Domain Templates)
+- 11 standard CRUD templates (fully normalized data model)
+- Vue 3 + TypeScript modern stack
+- SOLID principles, data consistency, process simplification
+- 100% test-driven, zero hallucination, full traceability
+
+**Duration**: 18 weeks (4.5 months, 12 phases)  
+**Team**: 13 FTE (PM, PL, 4 FE devs, 1 UX, 2 QA, 1 DevOps, 0.5 security, 0.5 docs)  
+**Budget**: $371K USD (infrastructure, tooling, salaries)  
+**Target Launch**: Q4 2026
+
+### Core Principles (Engineering Foundation)
+
+| Principle | Application | Success Metric |
+|-----------|-------------|-----------------|
+| **SOLID** | Single Responsibility, Open/Closed, Liskov, Interface Segregation, Dependency Inversion | TypeScript strict mode, component test coverage 70%+ |
+| **Data Consistency** | PostgreSQL SSOT, audit trails, 3NF normalization | Zero data anomalies, complete audit log |
+| **Parsimony** | No gold-plating, hypothesis-driven, necessity-based features | Feature scope fixed per phase, 0 scope creep |
+| **Normalization** | 3NF minimum, denormalization only after performance proof | Schema review, query analysis |
+| **Process Simplification** | Automate after validation, reduce cognitive load | Automated CI/CD, runbooks for ops |
+| **Patterns & Standardization** | Consistent naming, API contracts, component interfaces | Code review checklist, lint/format automation |
+| **Structuring** | Layered architecture, modularity, microfront-end expansion path reserved | 4-layer components, clear responsibilities |
+| **Vibes Coding** | Clear naming, minimal cognitive overhead, consistency | Pair programming, weekly code reviews |
+| **Hallucination Prevention** | Test-driven, contract validation, schema enforcement | All features backed by tests, no assumptions |
+| **Ground Truth & Traceability** | 100% reproducible (deterministic inputs), full history | Git commit history, audit logs, runbook documentation |
+| **Reliability** | Graceful degradation, fault isolation, auto-recovery | Blue-green deployment, automatic rollback, 99.9% uptime |
+| **Componentization** | Smart/Dumb separation, reusability | npm package @quantengine/ui, Storybook coverage |
+| **Technical Debt** | Zero new debt, reduce existing by 50% per half-year | Quarterly debt audit, refactoring sprints |
+
+### Phase Breakdown (12 Phases)
+
+| Phase | Goal | Effort | Key Deliverables | Exit Criteria |
+|-------|------|--------|------------------|---------------|
+| **0** | Requirements & Baseline | 2wks | FRD, OpenAPI spec, wireframes, risk register | Stakeholder sign-off |
+| **1** | Dev Environment & CI/CD | 2wks | Vite project, Storybook, GitHub Actions, DB migrations | All devs local setup ✓ |
+| **2** | Primitive & Composite Layers | 2wks | 30 components, Storybook docs, 70%+ test coverage | WCAG 2.1 AA audit ✓ |
+| **3** | Smart Components & State | 2wks | 12 domain components, Pinia stores, API client | Integration tests ✓ |
+| **4** | CRUD Templates & E2E | 2wks | 11 full CRUD screens, 50 E2E tests, responsive design | All screens tested ✓ |
+| **5** | Design System & npm | 1wk | npm package @quantengine/ui, Storybook deployment | npm install works ✓ |
+| **6** | Authorization & Security | 1wk | RBAC (5 roles, 50 perms), audit trails, OWASP validation | Zero critical vulns ✓ |
+| **7** | Performance Optimization | 1wk | Lighthouse 90+, bundle <500KB, P95 <250ms | Performance budgets met ✓ |
+| **8** | UAT & Load Testing | 1wk | 20 users × 2wks UAT, load test 100 concurrent users | UAT sign-off, no P1 bugs ✓ |
+| **9** | Production Deployment | 1wk | Blue-green deployment, monitoring (Sentry), health checks | 99.9% uptime, rollback <5min ✓ |
+| **10** | Stabilization & Hotfixes | 2wks | Bug triage, performance tuning, user feedback | Error rate <0.5%, NPS >70 ✓ |
+| **11** | Documentation & Handover | 1wk | Wiki, training materials, ops runbooks, knowledge transfer | All docs reviewed ✓ |
+
+### Quantified Success Metrics
+
+**Quality Indicators**:
+- ✅ Test Coverage: 70%+ (Vitest)
+- ✅ TypeScript Strict: 100% (no `any`, no implicit `unknown`)
+- ✅ Accessibility: WCAG 2.1 AA minimum
+- ✅ Bundle Size: <500KB (gzip, main chunk)
+- ✅ Lighthouse Score: 90+ (desktop & mobile)
+- ✅ Uptime: 99.9% (SLA)
+- ✅ Response Time: P95 <250ms
+- ✅ Error Rate: <0.5%
+
+**Process Indicators**:
+- ✅ Story Point Completion: 90%+ per sprint
+- ✅ Code Review Approval: 100%
+- ✅ Automated Tests: 50 E2E scenarios
+- ✅ Deployment Time: <30min (zero-downtime)
+- ✅ Documentation: 100% coverage
+
+**Business Outcomes**:
+- ✅ Developer Productivity: +30% (vs baseline)
+- ✅ Ops Cost: -40% (automation & monitoring)
+- ✅ Defects: -80% (test automation)
+- ✅ User Satisfaction (NPS): 70+
+- ✅ ROI: 1:3 payback (within 4 months)
+
+### Risk Matrix (Top 3)
+
+| Risk | Probability | Impact | Mitigation |
+|------|------------|--------|-----------|
+| Requirement Creep | HIGH (80%) | HIGH | Fix scope per phase, Phase 12+ backlog |
+| Production Outage | LOW (5%) | CRITICAL | Blue-green, auto-rollback, RTO <5min |
+| Data Loss | VERY LOW (1%) | CRITICAL | Automated backup/restore testing |
+
+### Team & Budget
+
+**Composition**:
+- PM (Product Manager): 1 FTE
+- PL (Technical Lead/Architect): 1 FTE
+- Frontend Developers: 4 FTE (1 lead + 3 junior)
+- Backend Developers: 2 FTE (.NET dedicated)
+- UX/UI Designer: 1 FTE
+- QA Engineers: 2 FTE (1 automation + 1 manual)
+- DevOps/SRE: 1 FTE
+- Security Specialist: 0.5 FTE (consultant)
+- Technical Writer: 0.5 FTE
+
+**Estimated Costs** (8 months):
+- Payroll: $360K (avg $2.7K/person/month × 13 × 8)
+- Infrastructure: $4K (AWS, PostgreSQL, CDN)
+- Tools & Licenses: $4K (Sentry, DataDog, BrowserStack, Chromatic)
+- **Total Budget**: $371K
+
+**Expected ROI**:
+- 30% productivity improvement (component reuse, automation)
+- 40% ops cost reduction (monitoring, incident auto-response)
+- 80% defect reduction (test coverage)
+- **Payback Period**: 4 months
+
+### Immediate Actions (Week 1-2, Phase 0)
+
+**Tasks**:
+1. T0.1: Stakeholder requirements (3 days) → FRD
+2. T0.2: Architecture decision (4 days) → Monolithic SPA confirmed
+3. T0.3: 4-Layer component design (5 days) → Figma library
+4. T0.4: 11 CRUD template inventory (4 days) → Template matrix
+5. T0.5: API OpenAPI 3.0 (5 days) → 30 endpoints spec
+6. T0.6: UI/UX wireframes (5 days) → High-fidelity mockups
+7. T0.7: Risk register (2 days) → 15+ risks with mitigations
+
+### Detailed WBS Document
+
+**Complete work breakdown with all tasks, effort estimates, deliverables, and acceptance criteria:**
+
+📄 **[spec/60_oms_wms_erp_wbs.yaml](spec/60_oms_wms_erp_wbs.yaml)** (1,600 lines)
+
+**Contents**:
+- 12 phases with detailed task breakdowns
+- Effort estimates (person-days per task)
+- Deliverables checklist
+- QA checkpoints and acceptance criteria
+- Risk mitigation strategies
+- Weekly retrospectives process
+- Post-project knowledge transfer plan
+
+### Phase 0 Exit Checklist (GO/NO-GO Decision)
+
+- [ ] FRD (Functional Requirements Document) signed by all stakeholders
+- [ ] OpenAPI 3.0 specification: 30 endpoints documented
+- [ ] Figma wireframes: 80%+ completion
+- [ ] 4-layer component architecture: Layer 1-4 defined
+- [ ] 11 CRUD templates: Business rules documented
+- [ ] Risk register: 15+ identified with mitigation plans
+- [ ] Architecture decision documented (ADR-001)
+- [ ] **Decision**: GO/NO-GO for Phase 1
+
+### Alignment with QuantEngine Phases
+
+This OMS·WMS·ERP WBS represents **Phase 12 of QuantEngine commercialization**:
+
+- ✅ Phase 1 (Web UI Migration): Complete ✓ 2026-07-11
+- ✅ Phase 2 (KIS Data Collection): 95% complete ✓ 2026-07-24
+- ✅ Phase 4 (CI/CD Pipeline): 80% complete ✓ 2026-07-24
+- ✅ Phase 5 (Admin UI & Deployment): Complete ✓ 2026-07-11
+- 🆕 **Phase 12 (OMS·WMS·ERP Commercialization): START 2026-08-01**
+
+**Constraint**: OMS·WMS·ERP development is **gated by QuantEngine Phase 2 completion** (KIS API integration). Phase 12 can begin only after Phase 2 validation in production.