Migración completa a Clean Architecture con componentes funcionales

- Reorganización de estructura: Admin/, Public/, Shared/, Schemas/
- 12 componentes migrados: TopNotificationBar, Navbar, CtaLetsTalk, Hero,
  FeaturedImage, TableOfContents, CtaBoxSidebar, SocialShare, CtaPost,
  RelatedPost, ContactForm, Footer
- Panel de administración con tabs Bootstrap 5 funcionales
- Schemas JSON para configuración de componentes
- Renderers dinámicos con CSSGeneratorService (cero CSS hardcodeado)
- FormBuilders para UI admin con Design System consistente
- Fix: Bootstrap JS cargado en header para tabs funcionales
- Fix: buildTextInput maneja valores mixed (bool/string)
- Eliminación de estructura legacy (src/, admin/, assets/css/componente-*)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

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

shared/Infrastructure/Validators/PhaseValidatorInterface.php

@@ -0,0 +1,36 @@
+<?php
+declare(strict_types=1);
+
+namespace ROITheme\Shared\Infrastructure\Validators;
+
+/**
+ * Contrato para validadores de fases
+ *
+ * Cada fase del flujo de trabajo tiene un validador específico
+ * que verifica que la implementación cumple con los estándares
+ */
+interface PhaseValidatorInterface
+{
+    /**
+     * Valida un componente para la fase específica
+     *
+     * @param string $componentName Nombre del componente en kebab-case (ej: 'top-notification-bar')
+     * @param string $themePath Ruta absoluta al tema de WordPress
+     * @return ValidationResult Resultado de la validación con errores, warnings e info
+     */
+    public function validate(string $componentName, string $themePath): ValidationResult;
+
+    /**
+     * Retorna el número de fase que valida
+     *
+     * @return int|string 1, 2, 3, 4, 5 o 'structure'
+     */
+    public function getPhaseNumber(): int|string;
+
+    /**
+     * Retorna descripción corta de qué valida esta fase
+     *
+     * @return string Descripción breve (ej: 'Schema JSON', 'JSON→DB Sync')
+     */
+    public function getPhaseDescription(): string;
+}