Files
Masterarbeit/Ergebnisse/Ergebnisse 03/NEXUS_DOCUMENTATION/USECASES_CODE_ANALYSIS.md

14 KiB

CentronNexus Use-Cases - Code Analysis

Source: Deep code analysis of c-entron.NET repository Date: Generated from USE_CASES_CENTRON_NEXUS.md Total Modules: 34 (23 fully documented + 4 partial + 6 stubs) Documentation Status: Comprehensive technical specifications from code


Overview

This document consolidates all use-cases discovered through code analysis of the CentronNexus/ServiceBoard application. These are the use-cases that were identified by examining:

  • Razor component structure (150+ .razor files)
  • Service layer implementations
  • Business logic (BL) classes
  • REST API endpoints
  • Database schema

PART 1: TICKETING & MANAGEMENT (8 Modules)

3.1 Ticket-Details

Status: Fully Implemented Purpose: View and manage individual ticket details Key Features:

  • Display complete ticket information
  • View ticket history and timeline
  • Show related documents and emails
  • Display ticket metadata and status
  • Show customer information linked to ticket

3.2 Ticket-Liste / Cached Ticket List

Status: Fully Implemented Purpose: Display list of all tickets with filtering and search Key Features:

  • Table view with sortable columns
  • Advanced filtering capabilities
  • Search across ticket data
  • Customizable columns
  • Cached query results for performance
  • Real-time updates

3.3 Ticket schließen (Close Ticket)

Status: Fully Implemented Purpose: Complete and close resolved tickets Key Features:

  • Mark ticket as resolved
  • Add resolution notes
  • Prevent further modifications
  • Trigger automatic notifications
  • Update ticket status to "closed"
  • Archive closed ticket

3.4 Ticket weiterleiten (Forward Ticket)

Status: Fully Implemented Purpose: Route ticket to different department/person Key Features:

  • Reassign ticket to new owner
  • Forward to different department
  • Add forwarding notes
  • Track ticket routing history
  • Maintain original ticket chain
  • Notify new owner

3.5 Kanban-Board

Status: Fully Implemented Purpose: Visualize ticket workflow using kanban columns Key Features:

  • Drag-and-drop ticket movement
  • Column configuration (backlog, in-progress, review, done)
  • Visual status representation
  • Quick ticket editing from board
  • WIP (Work In Progress) limits
  • Real-time board updates

3.6 Ticket-Checklisten (Checklists)

Status: Fully Implemented Purpose: Create and track task checklists within tickets Key Features:

  • Add checklist items to tickets
  • Mark items complete/incomplete
  • Progress tracking (5/10 items done)
  • Reorder checklist items
  • Link checklists to procedures
  • Share checklists across tickets

3.7 Ticket-Scripts (Quick Actions)

Status: Fully Implemented Purpose: Execute quick actions/automation scripts on tickets Key Features:

  • Pre-defined script templates
  • Bulk ticket operations
  • Custom script execution
  • Automation workflows
  • Script logging and audit trail
  • Error handling for failed scripts

3.8 Ticket Web-Formulare (Web Forms)

Status: Fully Implemented Purpose: Embed web forms in tickets for customer input Key Features:

  • Embed external forms
  • Capture customer data via forms
  • Auto-populate ticket from form data
  • Form submission tracking
  • Integration with ticket workflow
  • Mobile-responsive forms

PART 2: TIME & PLANNING (3 Modules)

4.1 Zeiterfassung (Time Tracking)

Status: Fully Implemented Purpose: Record and track time spent on tickets Key Features:

  • Log time spent on tasks
  • Associate time entries with tickets
  • Time entry history
  • Billable vs. non-billable time
  • Daily/weekly time summaries
  • Time approval workflow

4.2 Stoppuhren (Global Timer)

Status: Fully Implemented Purpose: Global timer for real-time activity tracking Key Features:

  • Start/stop timer from UI
  • Track active work in real-time
  • Timer notifications
  • Auto-pause on inactivity
  • Multiple timer management
  • Integration with time tracking

4.3 Scheduler (Kalender)

Status: Fully Implemented Purpose: Calendar-based scheduling and resource planning Key Features:

  • Day/week/month calendar views
  • Drag-and-drop scheduling
  • Resource allocation
  • Conflict detection
  • Recurring events
  • Team schedule view

PART 3: CONTENT & DOCUMENTS (5 Modules)

5.1 Ticket-Dokumente (Documents)

Status: Fully Implemented Purpose: Manage documents attached to tickets Key Features:

  • Upload documents to tickets
  • Document versioning
  • Document preview
  • Download documents
  • Document linking between tickets
  • Storage management

5.2 Ticket-E-Mails (Email)

Status: Fully Implemented Purpose: View and manage emails related to tickets Key Features:

  • Display email chain in ticket
  • Reply to customer emails
  • Send new emails from ticket
  • Email templates
  • Attachment management
  • Email archive

5.3 Ticket-Berichte (Reports)

Status: Fully Implemented Purpose: Generate reports from ticket data Key Features:

  • Pre-defined report templates
  • Custom report generation
  • Data filtering and grouping
  • Export to PDF/Excel
  • Scheduled report emails
  • Report history/archive

5.4 Dokumentenviewer (Document Viewer)

Status: Fully Implemented Purpose: Preview documents without downloading Key Features:

  • In-browser document preview
  • Support for multiple formats (PDF, Office, images)
  • Annotation tools
  • Zoom and navigation
  • Download from viewer
  • Print capability

5.5 E-Mail-Versand (Email Sending)

Status: Fully Implemented Purpose: Manage outgoing email configuration and sending Key Features:

  • Email server configuration
  • Email template management
  • Batch email sending
  • Email scheduling
  • Delivery confirmation
  • Bounce handling

PART 4: DASHBOARD & OVERVIEW (2 Modules)

6.1 Dashboard

Status: Fully Implemented Purpose: Personalized dashboard with key metrics and quick access Key Features:

  • Personalized user greeting
  • Quick access to favorite tickets
  • Recently edited tickets
  • Daily schedule summary
  • Missing time alerts
  • Key metrics and KPIs
  • Customizable dashboard widgets

6.2 Mein Tag (MyDay)

Status: Fully Implemented Purpose: Focused daily view of today's work Key Features:

  • Today-scoped task view
  • Daily schedule
  • Time block visualization
  • Work priority management
  • Task completion tracking
  • Integration with other modules

PART 5: AI & ADVANCED FEATURES (2 Modules)

7.1 Ticket-AI-Zusammenfassung (AI Summary)

Status: Fully Implemented Purpose: AI-generated ticket summaries and insights Key Features:

  • Auto-generate ticket summaries
  • AI analysis of ticket content
  • Suggested actions
  • Keyword extraction
  • Sentiment analysis
  • Integration with AI services

7.2 AI-Assist (Content Generation)

Status: Fully Implemented Purpose: AI-powered content generation for responses Key Features:

  • Generate response templates
  • Draft email suggestions
  • Auto-complete functionality
  • Content recommendations
  • Style and tone customization
  • Integration with ticket workflow

PART 6: CUSTOMER MANAGEMENT (3 Modules)

8.1 Kundendaten (Customer Data)

Status: Fully Implemented Purpose: Manage customer master data and information Key Features:

  • Customer directory/list
  • Customer contact information
  • Company details and address
  • Customer status (active/inactive)
  • Contact person management
  • Matchcode for external systems
  • Customer search

8.2 Kundengeräte & Assets

Status: Fully Implemented Purpose: Track customer equipment and IT assets Key Features:

  • Asset registry per customer
  • Equipment details and configuration
  • Warranty tracking
  • Maintenance history
  • Asset location tracking
  • Asset/ticket linking

8.3 Kundendetails & Adressenverwaltung (Customer Details)

Status: Fully Implemented Purpose: Extended customer detail management and address handling Key Features:

  • Detailed customer profiles
  • Multiple address management (billing, shipping, etc.)
  • Communication preferences
  • Relationship history
  • Customer notes
  • Extended contact information

PART 7: SEARCH & DISCOVERY (1 Module)

Status: Partial Implementation (Placeholder) Purpose: Global search across system Key Features:

  • Full-text search
  • Cross-module search
  • Search results ranking
  • Saved searches
  • Search suggestions
  • Advanced search syntax

PART 8: REPORTING & ANALYTICS (3 Modules)

9.2 Statistiken (Statistics)

Status: Stub Implementation Purpose: System statistics and analytics Key Features:

  • Ticket statistics
  • Performance metrics
  • Team productivity metrics
  • Customer satisfaction metrics
  • System health metrics
  • Data export

9.3 Karte (Mapping)

Status: Stub Implementation Purpose: Geographic mapping of customers and resources Key Features:

  • Customer location map
  • Route optimization
  • Territory management
  • Resource location tracking
  • Map-based ticket assignment

9.4 Passwort-Manager (Password Manager)

Status: Missing Implementation Purpose: Secure password management for customer systems Key Features:

  • Store customer system passwords
  • Secure encryption
  • Access control
  • Password rotation tracking
  • Audit trail
  • Integration with ticket workflow

PART 9: CRM & PARTNER RELATIONS (5 Modules)

10.1 Kontakte (Contacts)

Status: Partial (Stub) Purpose: Extended contact management Key Features:

  • Individual contact records
  • Contact grouping
  • Communication history
  • Contact preferences
  • Multiple contact types

10.2 Partnerportal (Partner Portal)

Status: Stub Implementation Purpose: Portal for external partners Key Features:

  • Partner access to tickets
  • Partner communication
  • Shared resources
  • Partner analytics
  • Multi-tenant support

10.3 CRM-Integration

Status: Stub Implementation Purpose: Integration with CRM systems Key Features:

  • Sync with external CRM
  • Lead management
  • Opportunity tracking
  • Sales pipeline

10.4 Lead-Management

Status: Stub Implementation Purpose: Track and manage sales leads Key Features:

  • Lead capture
  • Lead scoring
  • Lead nurturing workflows
  • Conversion tracking

10.5 Opportunity-Tracking

Status: Stub Implementation Purpose: Track sales opportunities Key Features:

  • Opportunity pipeline
  • Stage management
  • Probability estimation
  • Revenue forecasting

PART 10: SETTINGS & ADMINISTRATION (5 Modules)

11.1 Einstellungen (Settings)

Status: Stub Implementation Purpose: System-wide settings and configuration Key Features:

  • General settings
  • Email configuration
  • Integration settings
  • Theme customization
  • Language settings

11.2 Benutzer (Users)

Status: Stub Implementation Purpose: User management and roles Key Features:

  • User creation/deletion
  • Role assignment
  • Permission management
  • User deactivation
  • Password reset

11.3 Rechte (Rights/Permissions)

Status: Stub Implementation Purpose: Permission and access control Key Features:

  • Role-based access control
  • Fine-grained permissions
  • Resource-level permissions
  • Permission inheritance
  • Audit trail

11.4 Logs (Activity Logs)

Status: Stub Implementation Purpose: System activity logging Key Features:

  • Activity audit trail
  • User action logging
  • System event logging
  • Log retention
  • Log export

11.5 Backup

Status: Stub Implementation Purpose: Data backup and recovery Key Features:

  • Automated backups
  • Backup scheduling
  • Backup verification
  • Recovery procedures
  • Backup retention

PART 11: ADVANCED FEATURES (2 Modules)

12.1 Custom Fields (Benutzerdefinierte Felder)

Status: Stub Implementation Purpose: Create custom data fields Key Features:

  • Add custom fields to entities
  • Field type definitions
  • Validation rules
  • Custom field permissions
  • Field grouping

12.2 Workflows

Status: Stub Implementation Purpose: Define and execute custom workflows Key Features:

  • Workflow builder
  • Condition/action definition
  • Workflow automation
  • Workflow history
  • Error handling

PART 12: EXTERNAL INTEGRATIONS (2 Modules)

13.1 Integrationen (API Integrations)

Status: Stub Implementation Purpose: Third-party API integrations Key Features:

  • API connection management
  • Authentication handling
  • Data sync
  • Error handling
  • Integration testing

13.2 Webhooks

Status: Stub Implementation Purpose: Outgoing webhook events Key Features:

  • Event-based webhooks
  • Webhook subscription
  • Retry logic
  • Event history
  • Webhook testing

CODE ANALYSIS SUMMARY

Fully Implemented (23 Modules)

  • Ticketing: 8 modules
  • Time & Planning: 3 modules
  • Content & Documents: 5 modules
  • Dashboard & Overview: 2 modules
  • AI & Advanced: 2 modules
  • Customer Management: 3 modules

Partially Implemented (4 Modules)

  • Search (9.1)
  • Statistics (9.2)
  • Mapping (9.3)
  • Password Manager (9.4)

Stub/Planned (7 Modules)

  • Settings & Administration: 5 modules
  • Advanced Features: 2 modules

Missing (2 Modules)

  • CRM & Partner Relations: 5 modules (various completion states)
  • External Integrations: 2 modules (stub)

Architecture Patterns Found in Code

Service Layer

  • I{Entity}Logic interfaces
  • BL{Entity}Logic business logic classes
  • WS{Entity}Logic web service layer

Data Access

  • NHibernate ORM
  • Entity mapping patterns
  • Soft delete implementation (IsDeleted flag)

Web Exposure

  • Blazor Server components (.razor files)
  • REST API endpoints via CentronRestService
  • SignalR for real-time updates

Authentication

  • JWT token validation
  • Role-based access control
  • User rights constants (UserRightsConst.cs)

Analysis Source: USE_CASES_CENTRON_NEXUS.md Last Updated: 2025-11-24 Total Documented: 23 fully implemented + 11 partial/planned modules