How adobe-rnd/aem-boilerplate-forms works
Main System Components
a) Client-Side Layer:
• Forms Runtime Engine (blocks/form/*)
• UI Components (blocks/* - cards, columns, footer, header, hero)
• Form Components (models/form-components/*)
• Client-side Scripts (scripts/*)
b) Rules Engine Layer:
• Rule Compiler (blocks/form/rules-doc/RuleCompiler.js)
• Rule Engine (blocks/form/rules-doc/RuleEngine.js)
• Formula Parser (blocks/form/rules-doc/parser/*)
c) Integration Layer:
• ReCAPTCHA Integration (blocks/form/integrations/recaptcha.js)
• AEM Backend Integration (scripts/aem.js)
Component Relationships
[Client Browser] → [Forms Runtime Engine]
• ↓
[UI Components] ← [Rules Engine] → [Formula Parser]
• ↓
[Form Components] → [Integration Layer] → [External Services]
Specific Implementation Details
Architectural patterns:
• Component-based architecture (shown by blocks/ structure)
• Event-driven form processing (blocks/form/rules/model/afb-events.js)
• Worker-based rule processing (blocks/form/rules/RuleEngineWorker.js)
Key Architectural Elements
Highlight:
• Form Component Registry (component-definition.json)
• Model Definitions (models/*)
• Integration Points (blocks/form/integrations/*)
• Test Infrastructure (test/*)
Development Infrastructure
Include:
• CI/CD Pipeline (.circleci/*)
• Testing Framework (test/*)
• Build System (rollup/*)
• The modular nature of the form components
• The separation between the rules engine and UI components
• The integration points with AEM and external services
• The build and deployment pipeline
Keep the abstraction level focused on the architectural components while showing the relationships between the form runtime, rules engine, and integration layers. This will help developers understand both the high-level structure and the detailed interactions between components.
This architecture represents a modern, component-based forms solution with a strong emphasis on client-side processing and rule evaluation, integrated with AEM's edge delivery services.