Merge pull request #1 from LexioJ/feature/dashboard

feat: Dual Dashboard System with Portal and Agent Views

Author: LexioJ

CHANGELOG.md

@@ -7,6 +7,89 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [1.2.0] - 2025-11-01
+
+### ✨ Major New Feature: Dual Dashboard System
+
+Version 1.2.0 introduces specialized dashboard widgets that adapt to user profiles, providing both end-user ticket tracking and comprehensive agent operational dashboards.
+
+### Added
+
+#### Dual Dashboard Widgets
+- **Portal Widget ("iTop")**: Personal ticket tracking for all users
+  - Compact status overview with badge breakdown (open, escalated, pending, resolved)
+  - Recent ticket feed showing 4 most recent tickets sorted by last update
+  - Visual status indicators: State-specific SVG icons for new, escalated, deadline, and closed tickets
+  - Inline metadata: Status emoji (🆕👥⏳⚠️✅☑️❌), priority emoji (🔴🟠🟡🟢), relative timestamps
+  - Rich hover details: Comprehensive ticket information including reference, dates, sanitized description
+  - One-click access to tickets in iTop
+  - Quick actions: Refresh and create new tickets
+  - Mobile-optimized responsive design
+
+- **Agent Widget ("iTop - Agent Dashboard")**: Operational metrics for agents
+  - **My Work Section**: Count of assigned incidents and requests
+  - **Team Queue Section**: Team-wide ticket counts for incidents and requests
+  - **SLA Tracking**: Warnings (TTO/TTR approaching) and breaches (TTO/TTR exceeded)
+  - **Change Management**: Upcoming changes with time windows (emergency/normal/routine)
+  - Quick navigation links to filtered iTop views
+  - Real-time ticket counts with visual indicators (info/warning/error)
+  - Responsive 2x2 metrics grid layout
+
+#### Widget Visibility Control
+- **Profile-Based Display**: Portal users see only Portal Widget; agents see both widgets
+- **Automatic Detection**: Widget availability controlled by `is_portal_only` flag from iTop profiles
+- **Seamless User Experience**: No manual configuration required
+
+#### Dashboard Backend
+- **ItopWidget.php**: Main widget class with profile-aware widget loading
+- **ItopAgentWidget.php**: Dedicated agent dashboard widget class
+- **Dashboard API**: New endpoints for SLA tracking, change management, and team metrics
+- **Efficient Queries**: Optimized OQL queries for dashboard data with minimal API calls
+
+### Changed
+
+#### Dashboard Improvements
+- **Enhanced Ticket Display**: Improved visual hierarchy with better status differentiation
+- **Better Error Handling**: Graceful fallback when API unavailable or user not configured
+- **Performance**: Dashboard data cached separately from search results
+- **Responsive Layout**: Mobile-first design with adaptive layouts for all screen sizes
+
+#### API Enhancements
+- **New ItopAPIService Methods**:
+  - `getAgentDashboardMetrics()`: Fetch agent-specific operational data
+  - `getSLAWarnings()`: Retrieve tickets approaching SLA thresholds
+  - `getUpcomingChanges()`: Get planned changes with time windows
+  - `getTeamQueue()`: Team-wide ticket statistics
+- **Person ID Filtering**: All dashboard queries filtered by user's Person ID for data isolation
+
+### Fixed
+- **Ticket Timestamp Display**: Corrected timezone handling in dashboard relative timestamps
+- **SVG Icon Rendering**: Fixed state icon display in dashboard ticket list
+- **Dashboard Refresh**: Resolved cache invalidation issue causing stale data after updates
+- **Mobile Layout**: Fixed overflow issues on small screens in dashboard widgets
+
+### Technical Details
+
+#### New Configuration Keys
+- `dashboard_cache_ttl`: Dashboard data cache TTL (default: 120s / 2min)
+- `agent_dashboard_enabled`: Global toggle for agent dashboard (default: true)
+
+#### New Dashboard Files
+- `lib/Dashboard/ItopWidget.php`: Portal widget (enhanced)
+- `lib/Dashboard/ItopAgentWidget.php`: Agent dashboard widget (new)
+- `lib/Service/DashboardService.php`: Dashboard data aggregation service (new)
+
+#### Translation Updates
+- Added 45 new translatable strings for dashboard widgets
+- Updated en.json, de.json, de_DE.json, fr.json with dashboard translations
+
+#### Migration Notes
+- **No user action required**: Existing users see Portal Widget immediately
+- **Automatic agent detection**: Agents automatically gain access to Agent Widget
+- **Cache warmup**: First dashboard load may be slower as metrics cache populates
+
+---
+
 ## [1.1.0] - 2025-10-28
 
 ### ✨ Major New Feature: Configuration Item (CI) Browsing

README.md

@@ -2,7 +2,7 @@
 
 🎟️ **Complete iTop ITSM & CMDB Integration** - Seamlessly access tickets, incidents, and Configuration Items from your Nextcloud environment
 
-[![Version](https://img.shields.io/badge/version-1.1.0-blue)](https://github.com/lexioj/integration_itop/releases)
+[![Version](https://img.shields.io/badge/version-1.2.0-blue)](https://github.com/lexioj/integration_itop/releases)
 [![License](https://img.shields.io/badge/license-AGPL--3.0-green)](LICENSE)
 [![Nextcloud](https://img.shields.io/badge/Nextcloud-30+-blue)](https://nextcloud.com)
 
@@ -16,7 +16,7 @@ A comprehensive Nextcloud integration that brings iTop IT Service Management and
 - 🔍 **Instant Search** - Find tickets and CIs from Nextcloud's search bar
 - 🔗 **Rich Previews** - Paste iTop links anywhere for interactive previews
 - 💬 **Smart Suggestions** - Get CI/ticket recommendations while typing in Talk or Text
-- 📊 **Dashboard Widget** - See your ticket queue at a glance
+- 📊 **Dashboard Widgets** - Portal widget for personal tickets + Agent widget for operational metrics
 - 🔔 **Notifications** - Get alerted when tickets are assigned to you
 
 ### **For IT Teams**
@@ -36,6 +36,52 @@ A comprehensive Nextcloud integration that brings iTop IT Service Management and
 
 ## 🚀 Key Features
 
+### 📊 Interactive Dashboard Widgets
+
+Get comprehensive overviews of your ticket queue directly on your Nextcloud dashboard. The integration provides **two specialized widgets** that adapt to your user profile:
+
+![Dashboard Widget](docs/images/dashboard1.png)
+
+#### 🎫 Portal Widget - "iTop"
+**For All Users** - Track your personal tickets at a glance
+
+**Features:**
+- **Compact Status Overview**: See total tickets with badge breakdown (open, escalated, pending, resolved)
+- **Recent Ticket Feed**: Display 4 most recent tickets sorted by last update
+- **Visual Status Indicators**: State-specific SVG icons (new, escalated, deadline, closed) for both Incidents and UserRequests
+- **Inline Metadata**: Status emoji (🆕👥⏳⚠️✅☑️❌), priority emoji (🔴🟠🟡🟢), and relative timestamps with tooltips
+- **Rich Hover Details**: Comprehensive ticket information on hover including reference, dates, and sanitized description
+- **One-Click Access**: Click any ticket to open directly in iTop
+- **Quick Actions**: Refresh dashboard and create new tickets without leaving Nextcloud
+- **Responsive Design**: Mobile-optimized layout adapts to all screen sizes
+
+#### 👨‍💼 Agent Widget - "iTop - Agent Dashboard"
+**For Agent Users Only** - Comprehensive operational dashboard
+
+**Features:**
+- **My Work**: Count of assigned incidents and requests
+- **Team Queue**: Team-wide ticket counts (incidents and requests)
+- **SLA Tracking**:
+  - SLA Warnings (TTO/TTR approaching)
+  - SLA Breaches (TTO/TTR exceeded)
+- **Change Management**:
+  - Upcoming changes with time windows
+  - Emergency/Normal/Routine change types
+  - Current and planned change status
+- **Quick Navigation**: Click metrics to jump to filtered iTop views
+- **Real-Time Counts**: Live ticket counts with visual indicators (info, warning, error)
+- **Responsive Grid**: 2x2 metrics layout adapting to screen size
+
+**Widget Visibility:**
+- **Portal Users** (is_portal_only = true): See only Portal Widget
+- **Agent Users** (is_portal_only = false): See both Portal Widget and Agent Widget
+- Automatically controlled by iTop user profiles
+
+**Perfect for:**
+- **Portal Widget**: End users tracking their personal requests
+- **Agent Widget**: IT agents managing workload, SLA compliance, and team coordination
+- **Both**: Managers needing both personal and operational views
+
 ### 🔗 Dynamic Reference Provider
 Transform iTop links into rich, interactive previews across Nextcloud apps (Talk, Deck, Text, Collectives).
 
@@ -337,36 +383,33 @@ Adjust cache TTLs in **Admin Settings → Cache & Performance**:
 
 ---
 
-## 📋 What's New in v1.1.0
+## 📋 What's New in v1.2.0
 
-**Major New Feature: Configuration Item (CI) Browsing** 🎉
+**Major New Feature: Dual Dashboard System** 🎉
 
 ### Added
-- **CI Support in Search**: Search 11 CI classes from unified search bar
-- **CI Support in Smart Picker**: Insert CI references in Talk, Text, and comments
-- **CI Rich Previews**: Paste CI URLs for detailed hardware/software previews
-- **Profile Service**: Automatic Portal vs Power user detection with 30min caching
-- **Preview Mapper**: Dedicated service for efficient CI data transformation
-- **Cache Service**: Distributed caching layer with configurable TTLs
-- **Admin CI Configuration**: Enable/disable CI classes with 3-state control
-- **Cache Management**: Admin UI with configurable TTLs and clear cache button
-- **11 CI Icons**: Class-specific icons (PC, Phone, Tablet, Printer, Software, etc.)
-- **French Translation**: Complete fr.json with all 280 strings (formal vous-form)
-- **German Translations**: Informal (du.json) and formal (de_DE.json) variants
+- **Portal Widget**: Personal ticket tracking for all users with status overview, recent ticket feed, and quick actions
+- **Agent Widget**: Comprehensive operational dashboard for IT agents with workload metrics, SLA tracking, and change management
+- **Profile-Based Display**: Automatic widget selection based on iTop user profiles (Portal vs Agent)
+- **Enhanced Ticket Display**: State-specific SVG icons, status/priority emojis, and rich hover details
+- **Dashboard Backend**: New API endpoints for SLA warnings, team queue, and change management
+- **Mobile Optimization**: Responsive design with adaptive layouts for all screen sizes
+- **Dashboard Caching**: Separate cache layer for dashboard data (default: 2min TTL)
 
 ### Changed
-- **Admin Settings**: Refactored to PHP-rendered HTML for better translation support
-- **Search Provider**: Enhanced with CI class ranking and profile-aware filtering
-- **Reference Provider**: Extended to detect and preview CI URLs
-- **API Service**: New methods for CI queries with Person ID filtering
-- **Performance**: Reduced API calls by 60-80% with multi-layer caching
-
-### Technical Improvements
-- ProfileService with configurable cache (10s-1h, default 30min)
-- CacheService with 5 configurable TTL types
-- PreviewMapper with PhysicalDevice field alignment
-- CI class state management (disabled/forced/user_choice)
-- Improved mobile responsiveness for CI previews
+- **Dashboard Performance**: Optimized OQL queries for faster dashboard loading
+- **Visual Hierarchy**: Improved status differentiation and metric indicators
+- **Error Handling**: Graceful fallback when API unavailable
+- **Translation Coverage**: Added 45 new strings for dashboard widgets in all supported languages
+
+### Previous Release: v1.1.0 - Configuration Item (CI) Browsing
+
+**Highlights:**
+- CI Support in Search, Smart Picker, and Rich Previews (11 CI classes)
+- Profile Service with automatic Portal vs Power user detection
+- Admin CI Configuration with 3-state control
+- Multi-language support: French, German (Du/Sie)
+- 60-80% reduction in API calls with multi-layer caching
 
 See [CHANGELOG.md](CHANGELOG.md) for complete details.
 
@@ -425,10 +468,14 @@ curl -X POST https://itop.company.com/webservices/rest.php \
 
 ## 🗺️ Roadmap
 
-### v1.2.0 (Next Release)
-- [ ] Enhanced Dashboard Widget with charts and filters
-- [ ] Ticket activity timeline in previews
+### v1.2.0 (Released 2025-11-01) ✅
+- [x] Enhanced Dashboard Widget with charts and filters
+- [x] Dual dashboard system (Portal + Agent widgets)
+- [x] SLA tracking and team metrics
+
+### v1.3.0 (Next Release)
 - [ ] Advanced search filters (date ranges, custom fields)
+- [ ] Notification system
 
 ### Future
 - [ ] Ticket creation from Nextcloud

appinfo/info.xml

@@ -15,6 +15,19 @@ Seamlessly connect your Nextcloud collaboration platform with iTop IT Service Ma
 
 ### ✨ Key Features
 
+#### 📊 Dual Dashboard Widgets
+- **Portal Widget**: Personal ticket queue for all users with status breakdown (Open, Pending, Resolved)
+  - View 4 most recent tickets (Incidents + User Requests)
+  - Visual status indicators and priority badges
+  - Quick actions: Refresh and Create New Ticket
+  - Responsive design for mobile/desktop
+- **Agent Widget**: Comprehensive operational dashboard for IT agents only
+  - **My Work**: Assigned incidents and requests with real-time counts
+  - **Team Queue**: Team-wide ticket distribution and workload overview
+  - **SLA Tracking**: TTO/TTR warnings and breaches for proactive management
+  - **Change Management**: Upcoming changes with time windows and types
+  - Automatic visibility control based on user profile (agents vs portal users)
+
 #### 🔗 Dynamic Reference Provider
 - **Rich Link Previews**: Paste iTop ticket links in Talk, Deck, or Collectives for instant rich previews
 - **Detailed Information**: View ticket status, priority, assignee, and description at a glance  
@@ -67,8 +80,8 @@ Seamlessly connect your Nextcloud collaboration platform with iTop IT Service Ma
 
 #### Start streamlining your ITSM workflow - Connect iTop with Nextcloud and experience unified IT service management!]]></description>
 
-	<version>1.1.0</version>
-	<licence>agpl</licence>
+	<version>1.2.0</version>
+	<licence>AGPL-3.0-or-later</licence>
 
 	<author>iTop Integration Team</author>
 
@@ -83,7 +96,8 @@ Seamlessly connect your Nextcloud collaboration platform with iTop IT Service Ma
 	<bugs>https://github.com/lexioj/integration_itop/issues</bugs>
 	<repository>https://github.com/lexioj/integration_itop.git</repository>
 
-	<screenshot small-thumbnail="https://raw.githubusercontent.com/lexioj/integration_itop/main/docs/images/dynamic-reference-provider-thumb.png">https://raw.githubusercontent.com/lexioj/integration_itop/main/docs/images/dynamic-reference-provider.png</screenshot>
+   <screenshot small-thumbnail="https://raw.githubusercontent.com/lexioj/integration_itop/main/docs/images/dashboard1.png">https://raw.githubusercontent.com/lexioj/integration_itop/main/docs/images/dashboard1.png</screenshot>
+	<screenshot>https://raw.githubusercontent.com/lexioj/integration_itop/main/docs/images/dynamic-reference-provider.png</screenshot>
    <screenshot>https://raw.githubusercontent.com/lexioj/integration_itop/main/docs/images/unified-search.png</screenshot>
 	<screenshot>https://raw.githubusercontent.com/lexioj/integration_itop/main/docs/images/smart-picker.png</screenshot>
 	<screenshot>https://raw.githubusercontent.com/lexioj/integration_itop/main/docs/images/personal-settings.png</screenshot>

appinfo/routes.php

@@ -22,7 +22,9 @@
 		['name' => 'itopAPI#getTicket', 'url' => '/tickets/{ticketId}', 'verb' => 'GET'],
 		['name' => 'itopAPI#getAvatar', 'url' => '/avatar', 'verb' => 'GET'],
 		['name' => 'itopAPI#getCIs', 'url' => '/cis', 'verb' => 'GET'],
-		
+		['name' => 'itopAPI#getDashboardData', 'url' => '/dashboard', 'verb' => 'GET'],
+		['name' => 'itopAPI#getAgentDashboardData', 'url' => '/agent-dashboard', 'verb' => 'GET'],
+
 		// Search routes
 		['name' => 'itopAPI#search', 'url' => '/search', 'verb' => 'GET'],
 	]