README

Symfony Bundle para formularios dinámicos configurables desde base de datos.

Modela formularios en una jerarquía Form → Section → Group → Field, con i18n dinámico, 22 tipos de campo predefinidos y extensibles, opciones desde catálogo interno o repositorios del proyecto, renders estructurales en 3 niveles y caché PSR-6 opt-in.

Requiere PHP 8.4 · Symfony 7.x · Doctrine ORM ^3.4

Documentación

Inicio rápido

composer require letkode/form-schema-bundle

Mapea las entidades en tu Entity Manager (ver Instalación):

# config/packages/doctrine.yaml
doctrine:
    orm:
        entity_managers:
            default:
                mappings:
                    LetkodeFormSchemaBundle:
                        type: attribute
                        is_bundle: false
                        dir: '%kernel.project_dir%/vendor/letkode/form-schema-bundle/src/Domain/Entity'
                        prefix: 'Letkode\FormSchemaBundle\Domain\Entity'

php bin/console doctrine:migrations:diff
php bin/console doctrine:migrations:migrate

Resuelve el schema de un formulario:

$form = $resolver
    ->schema('user_onboarding')
    ->withLocale('es')
    ->withContext('create')   // filtra y sobreescribe atributos según actions[create]
    ->resolve();

Estructura del paquete

Jerarquía de entidades

Form
└── FormSection[]
    └── FormGroup[]
        └── FormField[]

Cada nivel puede tener parameters (JSON libre), traducciones y un type_render que controla su render estructural.

Renders en 3 niveles

Contexto de acción (actions)

Los campos pueden configurar su visibilidad y atributos por contexto:

{
  "attributes": {
    "required": false,
    "actions": {
      "create": { "enabled": true, "required": true },
      "edit":   { "enabled": true, "required": false },
      "show":   { "enabled": true, "readonly": true }
    }
  }
}

El resolver aplica withContext('create') para filtrar campos deshabilitados y sobrescribir required, readonly y otros atributos dinámicos.

Tipos de campo built-in