Visual Logic Editor¶

🎯 Overview¶

The Visual Logic Editor is a comprehensive node-based programming environment that enables users to create complex data processing workflows without traditional coding. It serves as the central orchestration system for connecting data sources with creative templates.

🏗️ System Architecture¶

Based on the Creative Production documentation, the Visual Logic Editor has:

⚡ Execution Environments¶

• Frontend Execution: Real-time preview and validation during diagram design
• Backend Execution: Production execution via AWS Lambda functions for actual rendering workflows

🔧 Core Components¶

• Visual Web Editor: Browser-based interface for creating and editing node diagrams
• Interpreter: Real-time execution engine for frontend preview
• Compiler: Transforms visual diagrams into executable code
• Frontend Executor: Handles diagram execution for design-time feedback
• Server Executor: AWS Lambda-based execution for production workflows

🧩 Node Categories¶

The Visual Logic Editor includes the following node types as documented:

🧮 Mathematics Nodes¶

• AdvMathNode: Advanced mathematical calculations using MathJS with dynamic variable detection and LaTeX preview
• MathNode: Basic arithmetic operations (addition, subtraction)
• Value Mapping: Range-to-range transformations for animations (opacity, rotation, scaling)

🔄 Data Type Conversion Nodes¶

• Integer/Float Converters: Bidirectional conversion with rounding options
• Number Formatting: Decimal precision control and separator customization
• Text Converters: Numeric to text conversion with formatting options

📅 Date and Time Nodes¶

• Date Manipulator: Extraction of date components (day, week, month, year)
• DateTime Decoder: Complete date/time breakdown with multiple format outputs
• TimeZone Converter: Global timezone conversion support

📝 Text Processing Nodes¶

• Text Breaker: Intelligent text segmentation using linear partition algorithms
• Text Template: Dynamic template system with automatic variable detection
• Conditional Text Replace: Pattern-based text replacement with regex support

🎨 Color Management Nodes¶

• SetColor: Multi-space color creation (RGB, HSV, LAB) with automatic conversion
• Color Selector: Multi-color selection with index-based picking
• Optimal Color Palette: Perceptual color optimization using Delta E algorithms

🧠 Logic and Comparison Nodes¶

• CompareNode: Multi-type data comparison with type-specific operations
• IfNode: Conditional flow control with dynamic output generation

🗄️ Database Integration Nodes¶

• Table Source: Dynamic database table access with automatic output generation
• Expander Node: Nested object flattening with automatic type detection

🎬 Media Processing Nodes¶

• Media Encoder: Multi-format encoding (MP4, GIF, JPG, PNG, MOV) with quality control
• File To URL: S3 storage URL generation with clean naming and hashing
• QR Encoder: QR code generation with multiple style options

📋 Template Integration Nodes¶

• Composition Node: Complex element composition with dynamic I/O
• HTML Template: HTML generation from templates with variable substitution

🔄 Workflow Capabilities¶

As documented in the Creative Production module:

• Data Flow: Seamless data transmission between nodes with type safety
• Dynamic Node Behavior: Nodes that adapt their inputs/outputs based on configuration
• Scalable Execution: Support for complex workflows with thousands of scenarios
• Real-time Preview: Immediate feedback during diagram construction

📊 Development Status¶

According to the Creative Production documentation: - Status: ✓ Production Ready

📚 Documentation Status¶

The following sections require additional information and are marked for future completion:

🔌 API Specifications¶

Status: TODO - API endpoints and specifications not yet documented

📊 Data Models¶

Status: TODO - Detailed data models not yet defined

⚙️ Configuration¶

Status: TODO - Configuration parameters not yet specified

🧪 Testing¶

Status: TODO - Testing procedures not yet documented

📈 Monitoring¶

Status: TODO - Monitoring and observability not yet defined

⚡ Performance Optimization¶

Status: TODO - Performance tuning parameters not yet documented