+------------------------------------------+
|         ai_sam_workflows (UI Layer)       |
|  - Views (17 XML files)                   |
|  - Controllers (5 Python files)           |
|  - JavaScript (19+ core files)            |
|  - CSS/SCSS (7 files)                     |
+------------------------------------------+
                    |
                    | uses models from
                    v
+------------------------------------------+
|      ai_sam_workflows_base (Data Layer)   |
|  - 15 workflow data models                |
|  - Security rules (ACL)                   |
|  - Business logic                         |
+------------------------------------------+

# Endpoints:
GET /canvas/api/branches/available
# Returns: List of available branch/canvas types

# Endpoints:
GET /canvas/<workflow_id>/nodes
# Serves Odoo canvas view with hierarchical manager

POST /canvas/<workflow_id>/nodes/save
# Saves canvas nodes to database

# Endpoints:
POST /canvas/workflow/analyze
# Input: workflow_json (N8N workflow structure)
# Returns: Orchestration plan with rendering instructions
#   - strategy: 'instant' | 'progressive' | 'theatrical'
#   - complexity: node_count, connection_count, metrics
#   - sequences: optimal node creation order
#   - insights: workflow analysis
#   - narration: theatrical commentary

# Static method:
NodeTypeMapper.get_node_type_id(n8n_type)
# Converts "n8n-nodes-base.httpRequest" -> database integer ID

:root {
    --n8n-node-background: #ffffff;
    --n8n-node-border: #ccc;
    --n8n-node-selected: #ff6d5a;
    --n8n-connection-color: #8b8b8b;
    --n8n-port-color: #8b8b8b;
}

+----------------+     +------------------+     +------------------+
|   User Action  | --> |  Vue Component   | --> |  Canvas Manager  |
|  (click, drag) |     |  WorkflowCanvas  |     |   (JS core)      |
+----------------+     +------------------+     +------------------+
                                                        |
                                                        v
+----------------+     +------------------+     +------------------+
|    Database    | <-- |   Controller     | <-- |  Node Manager    |
| (workflows_base)|    | transition_ctrl  |     |   (JS core)      |
+----------------+     +------------------+     +------------------+

<record id="canvas_platform_automator" model="canvas.platform">
    <field name="name">SAM Automator Platform</field>
    <field name="technical_name">automator</field>
    <field name="renderer_class">AutomatorRenderer</field>
    <field name="icon_class">fa-project-diagram</field>
    <field name="sequence">30</field>
    <field name="active">True</field>
</record>

ai_sam_workflows/security/ir.model.access.csv
# Empty file - no models to secure

# __manifest__.py assets configuration
'assets': {
    'web.assets_backend': [
        # 1. Node Type Registry (FIRST)
        'ai_sam_workflows/static/src/n8n/nodes/node_type_registry.js',

        # 2. Services (dependencies for other modules)
        'ai_sam_workflows/static/src/services/icon_service.js',

        # 3. Utilities
        'ai_sam_workflows/static/src/n8n/utils/*.js',

        # 4. Canvas System
        'ai_sam_workflows/static/src/n8n/canvas/canvas_manager.js',
        'ai_sam_workflows/static/src/n8n/nodes/*.js',
        'ai_sam_workflows/static/src/n8n/lines/*.js',

        # 5. Theater System
        'ai_sam_workflows/static/src/n8n/theater/*.js',

        # 6. Vue Components
        'ai_sam_workflows/static/src/components/*.vue',

        # 7. Styles (LAST)
        'ai_sam_workflows/static/src/css/*.css',
    ],
}