Enhance JSON structure in multiflexi applications: Update 'produces' field to include description and format for invoices and orders

Author: Vitexus

.github/copilot-instructions.md

@@ -45,8 +45,12 @@ When create new class or update existing class, always create or update its phpu
 
 All files in the multiflexi/*.app.json directory must conform to the schema available at: https://raw.githubusercontent.com/VitexSoftware/php-vitexsoftware-multiflexi-core/refs/heads/main/multiflexi.app.schema.json
 
+When modifying or creating multiflexi/*.app.json files, always validate them against the schema before making changes. Use tools to check JSON schema compliance.
+
 All produced reports must conform to the schema available at: https://raw.githubusercontent.com/VitexSoftware/php-vitexsoftware-multiflexi-core/refs/heads/main/multiflexi.report.schema.json
 
+When modifying JSON files or creating new multiflexi applications, always verify the JSON syntax and schema compliance as part of the development process.
+
 When writing code that interacts with the IPEX API, always refer to the official documentation at https://restapi.ipex.cz/swagger.json for guidance on endpoints, parameters, and best practices.
 
 

.github/workflows/multiflexi-validation.yml

@@ -0,0 +1,62 @@
+name: MultiFlexi JSON Validation
+
+on:
+  push:
+    paths:
+      - 'multiflexi/*.json'
+  pull_request:
+    paths:
+      - 'multiflexi/*.json'
+
+jobs:
+  validate-multiflexi-json:
+    runs-on: ubuntu-latest
+    
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+      
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: '3.x'
+        
+    - name: Install jsonschema
+      run: pip install jsonschema requests
+      
+    - name: Validate JSON syntax
+      run: |
+        for file in multiflexi/*.json; do
+          if [ -f "$file" ]; then
+            echo "Validating syntax: $file"
+            python3 -m json.tool "$file" > /dev/null
+          fi
+        done
+        
+    - name: Validate against MultiFlexi schema
+      run: |
+        python3 << 'EOF'
+        import json
+        import requests
+        import jsonschema
+        import os
+        import glob
+
+        # Download the schema
+        schema_url = "https://raw.githubusercontent.com/VitexSoftware/php-vitexsoftware-multiflexi-core/refs/heads/main/multiflexi.app.schema.json"
+        response = requests.get(schema_url)
+        schema = response.json()
+
+        # Validate all JSON files
+        for file_path in glob.glob("multiflexi/*.json"):
+            print(f"Validating schema: {file_path}")
+            with open(file_path, 'r') as f:
+                data = json.load(f)
+            
+            try:
+                jsonschema.validate(data, schema)
+                print(f"✅ {file_path} is valid")
+            except jsonschema.ValidationError as e:
+                print(f"❌ {file_path} validation failed: {e.message}")
+                exit(1)
+        EOF

multiflexi/abraflexi-ipex-postpaid-invoices.multiflexi.app.json

@@ -11,7 +11,10 @@
     "topics": ["AbraFlexi", "Ipex", "Invoice"],
     "uuid": "262dabf1-d7b1-42c8-91a1-fe991631547c",
     "produces": {
-        "invoices": "AbraFlexi invoices created from orders"
+        "invoices": {
+            "description": "AbraFlexi invoices created from orders",
+            "format": "json"
+        }
     },
     "environment": {
         "APP_DEBUG": {

multiflexi/abraflexi-ipex-postpaid-orders.multiflexi.app.json

@@ -11,7 +11,10 @@
     "topics": ["AbraFlexi", "Ipex", "Invoice"],
     "uuid": "51b247aa-fd48-44d7-8494-8c86b05e5a66",
     "produces": {
-        "orders": "AbraFlexi orders created from IPEX calls"
+        "orders": {
+            "description": "AbraFlexi orders created from IPEX calls",
+            "format": "json"
+        }
     },
     "environment": {
         "APP_DEBUG": {