Infonetica - Workflow Management System

A lightweight workflow management system built with .NET 8.0 Minimal API, providing features for workflow definition, instance management, state transitions, and history tracking.

---

Technologies Used

• .NET 8.0 - Modern, fast framework
• ASP.NET Core Minimal API - For lightweight REST API
• C# - Primary programming language
• Swagger (Swashbuckle) - Interactive API documentation

---

Architecture: MVC Pattern

Built using the Model-View-Controller (MVC) architecture provided by ASP.NET Core:

• Model: Represents the data structures for workflow (States, Actions, WorkflowDefinition, WorkflowInstance).
• Controller: Defines API endpoints for workflows and instances using attribute routing.
• Service: Contains the core logic for creating workflows, managing state transitions, and persisting data.

---

Features

• Workflow Definition Management - Create and retrieve workflows
• Workflow Execution - Start instances and perform actions
• State Transitions - Configurable actions between states
• History Tracking - Keep track of transitions for audit
• RESTful API - Simple, clean endpoints with Swagger UI

---

Project Structure

InfoneticaTask/
├── Controllers/
│ ├── WorkflowController.cs    # Handles workflow definition endpoints
│ ├── InstanceController.cs    # Handles workflow instance endpoints
├── Models/
│ ├── State.cs                 # Workflow state model
│ ├── ActionTransition.cs      # Actions connecting states
│ ├── WorkflowDefinition.cs    # Workflow template
│ ├── WorkflowInstance.cs      # Instance of workflow
│ └── HistoryEntry.cs          # Transition history
├── Services/
│ └── WorkflowService.cs       # Core business logic
├── Program.cs                 # Application entry point
└── InfoneticaWorkflow.csproj  # Project configuration

---

API Endpoints

Workflows

Method	Endpoint	Description
POST	/workflows	Create a new workflow
GET	/workflows	Get all workflows
GET	/workflows/{id}	Get a workflow by ID

Workflow Instances

Method	Endpoint	Description
POST	/instances/{workflowId}	Start a workflow instance
GET	/instances	Get all instances
GET	/instances/{id}	Get instance details & history

Execution

Method	Endpoint	Description
POST	/instances/{instanceId}/actions/{actionId}	Execute an action

---

Setup Instructions

Prerequisites

• Install .NET 8.0 SDK → Download here

Installation & Run

# Clone the repository
git clone <repository-url>
cd Infonetica_Task

# Restore dependencies
dotnet restore

# Add Swagger support (if not installed)
dotnet add package Swashbuckle.AspNetCore --version 6.5.0

# Build and run
dotnet build
dotnet run

---

Access API & Documentation

API Base URL: http://localhost:5153

Swagger UI: http://localhost:5153/swagger

---

Important

Persistence

Uses JSON file persistence:

• workflows.json → Stores all workflow definitions
• instances.json → Stores all workflow instances

---

Future Enhancements

1. Timed / Scheduled Actions

• Automatically execute actions after a specified delay (e.g., escalate a ticket after 24 hours).
• How: Implement a background service (using IHostedService) to monitor workflow instances and trigger scheduled actions.

2. Authentication & Authorization

• Secure API endpoints with JWT-based authentication.
• Restrict workflow actions based on user roles.

---