QuantEngineByItz/tools/validate_enterprise_crud_specification_v1.py

#!/usr/bin/env python
# -*- coding: utf-8 -*-
"""
tools/validate_enterprise_crud_specification_v1.py
OMS·WMS·ERP CRUD 화면 및 입력 컴포넌트 상용화 지침 명세(docs/ENTERPRISE_CRUD_DESIGN_SPECIFICATION.md)
및 입력 컴포넌트 4계층 아키텍처(primitives/fields/domain-fields/business-composites) 자동 검증 하네스 CLI v3.0.

검증 항목:
1. docs/ENTERPRISE_CRUD_DESIGN_SPECIFICATION.md 52개 세부 섹션 존재 및 파싱 검증.
2. 4계층 컴포넌트 디렉터리 존재 및 SFC(.vue) 파생 실체 검증.
3. 11대 표준 템플릿 ID (TPL-LIST-01 ~ TPL-HISTORY-01) 파싱 검증.
4. TypeScript 계약 enterpriseTemplateContracts.ts 내 13가지 FieldStatus 및 8가지 ValueSource 존재 검증.
5. AGENTS.md 운영 헌법 바인딩 검증.
6. Temp/enterprise_crud_validation_report_v1.json 및 Temp/enterprise_crud_validation_report_v1.md 발행.
"""

import sys
import os
import json
from pathlib import Path

# Windows UTF-8 강제
if sys.platform == "win32":
    sys.stdout.reconfigure(encoding="utf-8")
    sys.stderr.reconfigure(encoding="utf-8")

REPO_ROOT = Path(__file__).resolve().parent.parent
SPEC_FILE = REPO_ROOT / "docs" / "ENTERPRISE_CRUD_DESIGN_SPECIFICATION.md"
WBS_FILE = REPO_ROOT / "docs" / "ROADMAP_ENTERPRISE_TEMPLATES_WBS.md"
TYPES_FILE = REPO_ROOT / "src" / "frontend" / "src" / "types" / "enterpriseTemplateContracts.ts"
COMPONENTS_DIR = REPO_ROOT / "src" / "frontend" / "src" / "components"
AGENTS_FILE = REPO_ROOT / "AGENTS.md"
TEMP_DIR = REPO_ROOT / "Temp"

REQUIRED_TEMPLATE_IDS = [
    "TPL-LIST-01", "TPL-CREATE-01", "TPL-CREATE-02", "TPL-CREATE-03",
    "TPL-DETAIL-01", "TPL-EDIT-01", "TPL-BULK-01", "TPL-DELETE-01",
    "TPL-CANCEL-01", "TPL-APPROVAL-01", "TPL-HISTORY-01"
]

REQUIRED_LAYERS = ["primitives", "fields", "domain-fields", "business-composites"]
REQUIRED_SECTIONS_COUNT = 52

def run_harness_validation():
    results = {
        "status": "PASS",
        "spec_document": False,
        "wbs_document": False,
        "types_contract": False,
        "component_layers_verified": False,
        "agents_integration": False,
        "parsed_sections_count": 0,
        "verified_templates_count": 0,
        "missing_templates": [],
        "checks": []
    }

    print("======================================================================")
    print(" OMS·WMS·ERP Component & CRUD Specification Harness Validator v3.0")
    print("======================================================================\n")

    # 1. Spec Document Verification
    if not SPEC_FILE.exists():
        results["status"] = "FAIL"
        results["checks"].append({"rule": "SPEC_FILE_EXISTS", "passed": False, "message": f"Spec file missing: {SPEC_FILE}"})
        print(f"[FAIL] Spec file not found: {SPEC_FILE}")
    else:
        results["spec_document"] = True
        results["checks"].append({"rule": "SPEC_FILE_EXISTS", "passed": True, "message": "Spec file exists."})
        print(f"[PASS] Found specification document: {SPEC_FILE}")

        content = SPEC_FILE.read_text(encoding="utf-8")

        # Check Section Count
        section_headers = [line for line in content.splitlines() if line.startswith("## ")]
        results["parsed_sections_count"] = len(section_headers)
        if len(section_headers) >= REQUIRED_SECTIONS_COUNT:
            results["checks"].append({"rule": "ALL_52_SECTIONS_PRESENT", "passed": True, "message": f"Verified {len(section_headers)} sections."})
            print(f"[PASS] All {REQUIRED_SECTIONS_COUNT} mandatory specification sections verified ({len(section_headers)}/52).")
        else:
            results["status"] = "FAIL"
            results["checks"].append({"rule": "ALL_52_SECTIONS_PRESENT", "passed": False, "message": f"Section count mismatch: {len(section_headers)}/52"})
            print(f"[FAIL] Missing sections in specification ({len(section_headers)}/52).")

        # Check 11 Template IDs
        found_templates = [tpl for tpl in REQUIRED_TEMPLATE_IDS if tpl in content]
        results["verified_templates_count"] = len(found_templates)
        missing_tpls = [tpl for tpl in REQUIRED_TEMPLATE_IDS if tpl not in content]
        results["missing_templates"] = missing_tpls

        if len(found_templates) == len(REQUIRED_TEMPLATE_IDS):
            results["checks"].append({"rule": "ALL_11_TEMPLATES_VERIFIED", "passed": True, "message": "All 11 standard template IDs present."})
            print(f"[PASS] All 11 standard template IDs verified ({len(found_templates)}/11).")
        else:
            results["status"] = "FAIL"
            results["checks"].append({"rule": "ALL_11_TEMPLATES_VERIFIED", "passed": False, "message": f"Missing templates: {missing_tpls}"})

    # 2. Component 4-Layer Architecture Verification
    all_layers_exist = True
    for layer in REQUIRED_LAYERS:
        layer_path = COMPONENTS_DIR / layer
        if not layer_path.exists():
            all_layers_exist = False
            results["checks"].append({"rule": f"LAYER_EXISTS_{layer.upper()}", "passed": False, "message": f"Layer missing: {layer_path}"})
            print(f"[FAIL] Component layer missing: {layer_path}")
        else:
            results["checks"].append({"rule": f"LAYER_EXISTS_{layer.upper()}", "passed": True, "message": f"Layer verified: {layer}"})

    if all_layers_exist:
        results["component_layers_verified"] = True
        print("[PASS] All 4 Component Layers (primitives, fields, domain-fields, business-composites) verified.")
    else:
        results["status"] = "FAIL"

    # 3. WBS & Types Contract Check
    if WBS_FILE.exists():
        results["wbs_document"] = True
        print(f"[PASS] WBS Roadmap document verified: {WBS_FILE}")

    if TYPES_FILE.exists():
        types_code = TYPES_FILE.read_text(encoding="utf-8")
        if "FieldStatus" in types_code and "ValueSource" in types_code and "ComponentLayer" in types_code:
            results["types_contract"] = True
            results["checks"].append({"rule": "TYPES_CONTRACT_VALID", "passed": True, "message": "FieldStatus, ValueSource & ComponentLayer types verified."})
            print("[PASS] TypeScript contract file enterpriseTemplateContracts.ts verified.")
        else:
            results["status"] = "FAIL"
            results["checks"].append({"rule": "TYPES_CONTRACT_VALID", "passed": False, "message": "Missing types in enterpriseTemplateContracts.ts"})

    # 4. AGENTS.md Integration Check
    if AGENTS_FILE.exists() and "ENTERPRISE_CRUD_DESIGN_SPECIFICATION.md" in AGENTS_FILE.read_text(encoding="utf-8"):
        results["agents_integration"] = True
        results["checks"].append({"rule": "AGENTS_AUTHORITY_MAPPED", "passed": True, "message": "AGENTS.md mapped with authority."})
        print("[PASS] AGENTS.md authority mapping verified.")

    # Generate Audit Artifacts in Temp/
    TEMP_DIR.mkdir(parents=True, exist_ok=True)
    json_packet = TEMP_DIR / "enterprise_crud_validation_report_v1.json"
    md_summary = TEMP_DIR / "enterprise_crud_validation_report_v1.md"

    with open(json_packet, "w", encoding="utf-8") as jf:
        json.dump(results, jf, indent=2, ensure_ascii=False)

    md_text = f"""# Enterprise OMS/WMS/ERP Component & CRUD Specification Harness Report v3.0

* **Validation Status**: `{results['status']}`
* **Specification File**: `{SPEC_FILE}`
* **Parsed Sections Count**: `{results['parsed_sections_count']}/52`
* **Component 4-Layer Architecture**: `{results['component_layers_verified']}`
* **Verified Templates**: `{results['verified_templates_count']}/11`
* **AGENTS.md Integration**: `{results['agents_integration']}`

## Verified Checks
"""
    for chk in results["checks"]:
        symbol = "✅ PASS" if chk["passed"] else "❌ FAIL"
        md_text += f"- **[{symbol}] {chk['rule']}**: {chk['message']}\n"

    md_summary.write_text(md_text, encoding="utf-8")

    print("\n----------------------------------------------------------------------")
    print(f" Harness Execution Result: {results['status']}")
    print(f" JSON Packet Saved: {json_packet}")
    print(f" Summary MD Saved: {md_summary}")
    print("----------------------------------------------------------------------\n")

    if results["status"] != "PASS":
        sys.exit(1)

if __name__ == "__main__":
    run_harness_validation()