From 263ab8a9d992383a62bb13187f41590e18d3940f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christopher=20M=C3=BChl?= <toki@toph.so>
Date: Wed, 8 Apr 2026 12:51:22 +0200
Subject: [PATCH] feat: add dashboard widget with placeholder template

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 EventSubscriber/DashboardSubscriber.php  | 29 ++++++++++++++++
 Resources/views/widget/heatmap.html.twig | 10 ++++++
 Widget/HeatmapWidget.php                 | 44 ++++++++++++++++++++++++
 3 files changed, 83 insertions(+)
 create mode 100644 EventSubscriber/DashboardSubscriber.php
 create mode 100644 Resources/views/widget/heatmap.html.twig
 create mode 100644 Widget/HeatmapWidget.php

diff --git a/EventSubscriber/DashboardSubscriber.php b/EventSubscriber/DashboardSubscriber.php
new file mode 100644
index 0000000..b3bfde6
--- /dev/null
+++ b/EventSubscriber/DashboardSubscriber.php
@@ -0,0 +1,29 @@
+<?php
+
+namespace KimaiPlugin\KimaiHeatmapBundle\EventSubscriber;
+
+use App\Event\DashboardEvent;
+use App\Widget\WidgetService;
+use Symfony\Component\EventDispatcher\EventSubscriberInterface;
+
+final class DashboardSubscriber implements EventSubscriberInterface
+{
+    public function __construct(private readonly WidgetService $widgetService)
+    {
+    }
+
+    public static function getSubscribedEvents(): array
+    {
+        return [
+            DashboardEvent::class => ['onDashboard', 100],
+        ];
+    }
+
+    public function onDashboard(DashboardEvent $event): void
+    {
+        $widget = $this->widgetService->getWidget('HeatmapWidget');
+        if ($widget !== null) {
+            $event->addWidget($widget);
+        }
+    }
+}
diff --git a/Resources/views/widget/heatmap.html.twig b/Resources/views/widget/heatmap.html.twig
new file mode 100644
index 0000000..af546a5
--- /dev/null
+++ b/Resources/views/widget/heatmap.html.twig
@@ -0,0 +1,10 @@
+{% embed '@theme/embeds/card.html.twig' with {'margin_bottom': 0} %}
+    {% block box_title %}
+        {{ title }}
+    {% endblock %}
+    {% block box_body %}
+        <div id="heatmap-container" data-url="{{ path('heatmap_data') }}" style="min-height: 150px; padding: 1rem;">
+            <p style="color: var(--bs-secondary);">Heatmap visualization coming in Phase 3</p>
+        </div>
+    {% endblock %}
+{% endembed %}
diff --git a/Widget/HeatmapWidget.php b/Widget/HeatmapWidget.php
new file mode 100644
index 0000000..a38e7f1
--- /dev/null
+++ b/Widget/HeatmapWidget.php
@@ -0,0 +1,44 @@
+<?php
+
+namespace KimaiPlugin\KimaiHeatmapBundle\Widget;
+
+use App\Widget\Type\AbstractWidget;
+use App\Widget\WidgetInterface;
+
+final class HeatmapWidget extends AbstractWidget
+{
+    public function getId(): string
+    {
+        return 'HeatmapWidget';
+    }
+
+    public function getTitle(): string
+    {
+        return 'Activity Heatmap';
+    }
+
+    public function getWidth(): int
+    {
+        return WidgetInterface::WIDTH_FULL;
+    }
+
+    public function getHeight(): int
+    {
+        return WidgetInterface::HEIGHT_LARGE;
+    }
+
+    public function getPermissions(): array
+    {
+        return ['view_own_timesheet'];
+    }
+
+    public function getData(array $options = []): mixed
+    {
+        return null;
+    }
+
+    public function getTemplateName(): string
+    {
+        return '@KimaiHeatmapBundle/widget/heatmap.html.twig';
+    }
+}