{
  "phase_id": "phase-02",
  "category_id": "architecture_engineering_core",
  "doc_id": "panel_ui_blueprint",
  "source_path": "/home/yeff/public_html/devon/panel/data/panel_ui_blueprint.json",
  "documentation_branch_status": "CUSTOM_BRANCH",
  "bucket_statuses_from_docs_index": {
    "Prerequisites": "ACTIVE",
    "Installation": "ACTIVE",
    "Configuration": "ACTIVE",
    "Validation": "ACTIVE",
    "Observable Evidence": "ACTIVE",
    "Failure Modes & Recovery": "ACTIVE",
    "Completion & Promotion": "ACTIVE"
  },
  "exported_at": "2026-04-28T05:56:48.644291+00:00",
  "export_rule": "docs/json export generated from real panel/data source plus docs/index.php branch evidence; no authored content invented by export patch",
  "source_payload": {
    "canon_meta": {
      "canon_id": "devon-panel-ui-blueprint",
      "version": "1.0.0",
      "status": "ACTIVE",
      "ui_reference": "claude_like_workspace_plus_devon_governance",
      "ui_mode": "deployment_order_first"
    },
    "ui_blueprint": {
      "design_goals": [
        "maximize_operational_clarity",
        "zero_fake_status",
        "canon_first_navigation",
        "preview_first_workspace",
        "fast_access_to_evidence",
        "fast_access_to_contracts",
        "project_and_server_scope_visibility",
        "strong_visual_hierarchy",
        "sandbox_first_operability"
      ],
      "global_layout": {
        "shell_mode": "three_column_workspace",
        "columns": {
          "left": {
            "width_mode": "fixed_expandable",
            "purpose": "navigation_and_operator_flow"
          },
          "center": {
            "width_mode": "fluid_primary",
            "purpose": "workspace_preview_artifact_diff_logs"
          },
          "right": {
            "width_mode": "fixed_expandable",
            "purpose": "evidence_contracts_timeline_dependencies"
          }
        }
      },
      "topbar": {
        "visible": true,
        "height_mode": "compact",
        "sections": {
          "left_cluster": [
            "devon_brand",
            "current_project_selector",
            "current_server_selector"
          ],
          "center_cluster": [
            "global_search",
            "deployment_stage_selector"
          ],
          "right_cluster": [
            "global_status_counters",
            "quick_actions",
            "user_menu"
          ]
        },
        "quick_actions": [
          "open_contract",
          "open_evidence",
          "open_pipeline",
          "open_dependencies",
          "open_timeline"
        ]
      },
      "left_sidebar": {
        "visible": true,
        "mode": "deployment_navigation",
        "behavior": {
          "collapsible": true,
          "remembers_last_state": true,
          "sticky": true
        },
        "zones": [
          {
            "zone_id": "sidebar_header",
            "widgets": [
              "project_scope_badge",
              "server_scope_badge",
              "memory_scope_badge"
            ]
          },
          {
            "zone_id": "sidebar_navigation",
            "widgets": [
              "deployment_stage_tree",
              "content_index_links"
            ]
          },
          {
            "zone_id": "sidebar_footer",
            "widgets": [
              "pass_fail_missing_summary",
              "last_validation_summary"
            ]
          }
        ]
      },
      "center_workspace": {
        "visible": true,
        "default_tab": "preview",
        "tabs": [
          {
            "tab_id": "preview",
            "label": "Preview",
            "purpose": "primary_visual_preview_of_panel_content_or_artifact"
          },
          {
            "tab_id": "artifact",
            "label": "Artifact",
            "purpose": "show_selected_artifact_or_generated_output"
          },
          {
            "tab_id": "contract",
            "label": "Contract",
            "purpose": "show_selected_card_contract"
          },
          {
            "tab_id": "diff",
            "label": "Diff",
            "purpose": "show_changes_and_canonical_diffs"
          },
          {
            "tab_id": "logs",
            "label": "Logs",
            "purpose": "show_runtime_and_validation_logs"
          },
          {
            "tab_id": "metrics",
            "label": "Metrics",
            "purpose": "show_runtime_metrics_and_counters"
          },
          {
            "tab_id": "timeline",
            "label": "Timeline",
            "purpose": "show_validation_and_promotion_sequence"
          }
        ],
        "workspace_header": {
          "required": [
            "current_section_title",
            "current_card_title",
            "current_subcategory_title",
            "current_status_badge",
            "breadcrumb"
          ]
        },
        "workspace_footer": {
          "required": [
            "last_validation_pointer",
            "evidence_count",
            "dependency_count",
            "pipeline_ref"
          ]
        }
      },
      "right_stack": {
        "visible": true,
        "mode": "stacked_drawers",
        "drawers": [
          {
            "drawer_id": "evidence_drawer",
            "label": "Evidence",
            "default_open": true,
            "required_blocks": [
              "evidence_expected",
              "evidence_found",
              "checks",
              "current_status",
              "last_validation"
            ]
          },
          {
            "drawer_id": "contract_drawer",
            "label": "Contract",
            "default_open": false,
            "required_blocks": [
              "contract_ref",
              "required_blocks",
              "configuration_contract",
              "operational_contract"
            ]
          },
          {
            "drawer_id": "dependency_drawer",
            "label": "Dependencies",
            "default_open": false,
            "required_blocks": [
              "hard_dependencies",
              "blockers",
              "upstream",
              "downstream"
            ]
          },
          {
            "drawer_id": "timeline_drawer",
            "label": "Timeline",
            "default_open": false,
            "required_blocks": [
              "stage_events",
              "validation_events",
              "promotion_events"
            ]
          },
          {
            "drawer_id": "memory_scope_drawer",
            "label": "Memory Scope",
            "default_open": false,
            "required_blocks": [
              "memory_partition_class",
              "routing_keys",
              "read_policy",
              "write_policy"
            ]
          },
          {
            "drawer_id": "server_scope_drawer",
            "label": "Server Scope",
            "default_open": false,
            "required_blocks": [
              "server_id",
              "role",
              "allowed_projects",
              "sandbox_capable",
              "promotion_capable"
            ]
          }
        ]
      },
      "deployment_navigation_model": {
        "source": "/opt/devon/canon/11_panel_content_index.yaml",
        "ordering": "deployment_order_only",
        "group_render_mode": "vertical_stage_groups",
        "group_card_style": "expandable",
        "required_indicators": [
          "stage_status_summary",
          "stage_missing_count",
          "stage_fail_count",
          "stage_pass_count"
        ]
      },
      "card_render_model": {
        "source": "/opt/devon/canon/08_canonical_matrix_v1.yaml",
        "card_style": "compact_operational_card",
        "required_elements": [
          "card_title",
          "subcategory_name",
          "objective",
          "status_badge",
          "dependency_count",
          "evidence_count",
          "primary_actions"
        ],
        "primary_actions": [
          "Open Contract",
          "Open Evidence",
          "View Pipeline",
          "View Dependencies",
          "View Timeline"
        ]
      },
      "status_visual_contract": {
        "allowed_statuses": [
          "PASS",
          "FAIL",
          "MISSING"
        ],
        "source_rule": "evidence_only",
        "visual_rules": {
          "PASS": {
            "semantic_color": "green",
            "emphasis": "stable"
          },
          "FAIL": {
            "semantic_color": "red",
            "emphasis": "critical"
          },
          "MISSING": {
            "semantic_color": "amber",
            "emphasis": "pending"
          }
        }
      },
      "counter_contract": {
        "required_global_counters": [
          "total_items",
          "pass_count",
          "fail_count",
          "missing_count"
        ],
        "required_stage_counters": [
          "pass_by_stage",
          "fail_by_stage",
          "missing_by_stage"
        ]
      },
      "interaction_contract": {
        "click_stage": {
          "actions": [
            "focus_stage_group",
            "refresh_center_workspace",
            "update_right_drawers"
          ]
        },
        "click_card": {
          "actions": [
            "open_card_summary",
            "focus_first_subcategory",
            "load_contract_drawer",
            "load_evidence_drawer"
          ]
        },
        "click_subcategory": {
          "actions": [
            "focus_matrix_row",
            "load_pipeline",
            "load_dependencies",
            "load_status_rule"
          ]
        },
        "click_status_badge": {
          "actions": [
            "open_evidence_drawer",
            "filter_by_same_status"
          ]
        },
        "click_memory_scope": {
          "actions": [
            "open_memory_scope_drawer"
          ]
        },
        "click_server_scope": {
          "actions": [
            "open_server_scope_drawer"
          ]
        }
      },
      "responsive_rules": {
        "desktop": {
          "left_sidebar": "visible",
          "right_stack": "visible",
          "center_workspace": "full"
        },
        "tablet": {
          "left_sidebar": "collapsible_overlay",
          "right_stack": "collapsible_overlay",
          "center_workspace": "primary"
        },
        "mobile": {
          "left_sidebar": "offcanvas",
          "right_stack": "offcanvas",
          "center_workspace": "stacked_tabs"
        }
      },
      "no_go_rules": [
        "no_fake_progress",
        "no_status_inference_without_evidence",
        "no_technology_first_navigation",
        "no_production_first_visual_bias",
        "no_hidden_dependency_state"
      ],
      "implementation_readiness": {
        "frontend_can_start_after": [
          "panel_data_contract_frozen",
          "content_index_frozen",
          "ui_blueprint_frozen"
        ]
      }
    }
  }
}