Service Provisioning
When an SVC (Service) or ENV (Environment) entitlement is created, the system provisions a service delivery structure: a Service record, a Contract, a CreditBalance, and a channel for Tickets. This page explains how that structure is built and how service delivery operates day to day.
SVC entitlement activation
Service types and lifecycles
Each Service has two key attributes:
- Lifecycle:
ongoing(continuous contract, renews periodically) orproject(defined start and end date). - Type: Categorizes the nature of work -- hosting, support, infrastructure, consulting, development, mobile apps, migration, upgrade, or project management.
What gets created
When an SVC entitlement is provisioned:
- Service -- A container for all work performed under this entitlement. Linked to the Organization and the entitlement.
- Contract -- Created automatically if the ProvisioningPolicy enables it. Contains SLA terms, billing value, start/end dates. See Contract Lifecycle.
- CreditBalance -- Initialized for UST-based consumption tracking. Even if the initial balance is zero, the record exists to measure cost from the start.
- Jira project link -- If the service maps to a Jira project, the
jira_project_keyis stored for two-way sync.
ENV entitlement activation
ENV entitlements follow a different pattern -- the system tracks the record, but infrastructure provisioning is a manual process:
- The system creates an Environment record linked to the entitlement and Organization.
- The admin receives a notification to provision the actual infrastructure.
- The admin configures: server, primary URL, staging URL, platform type (Moodle, WordPress, custom), backup schedule, DNS records.
- The environment status is set to
activeand becomes visible in the customer portal.
Environments are linked to contracts for SLA coverage. Service requests for maintenance are opened directly against the environment.
The UST consumption model
UST (Unit of Technical Service) is the standardized unit for measuring service work. Instead of billing by the hour, each service catalog item has a fixed credit cost:
| Concept | How it works |
|---|---|
| Credit | The commercial unit. 1 credit = 10 internal units |
| Catalog items | Each service type has a base credit cost |
| Complexity | Three levels: low (1x), medium (1.5x), high (2x) |
| Consumption | FIFO -- oldest credits are consumed first |
When a Ticket is opened, credits are reserved from the balance. When the request is completed, credits are debited. This prevents overspending while work is in progress.
The CreditPolicy governs expiration, grace periods, limits, and what happens when the balance runs out. See Policies for configuration details.
Ticket workflow
Service requests are the operational units of work within a Service or Environment:
Each Ticket has a unique code (SR-YYYYNNNN) and is linked to either a Service or an Environment. The workflow:
- Customer creates the request from the portal, selecting the service or environment, describing the work, and setting priority.
- Admin reviews the request and approves, rejects, or converts it to a quote if it exceeds the contract scope.
- Admin assigns a team member and moves it to in-progress.
- Work is performed with progress comments visible to the customer in real time.
- Customer approves the completed work.
- Credits are debited from the CreditBalance.
SLA tracking
SLA targets are determined by the support_class field on the entitlement (Free, Basic, Flex, Business, Enterprise, Government). Jira runs the SLA clocks; MIDDAG Account reads the state via webhooks and displays it in the portal.
| Metric | Where it runs | Where it displays |
|---|---|---|
| Response time | Jira | Portal + admin panel |
| Resolution time | Jira | Portal + admin panel |
| Uptime target | Monitoring | Admin panel (ENV only) |
The SLAPolicy allows customization per level -- response time, resolution time, support hours, escalation rules, and priority levels available to the customer.
Related pages
- Contract Lifecycle -- Contract creation, renewal, and amendment
- Entitlement Activation -- The provisioning pipeline
- Billing and Finance -- How service consumption translates to invoices
- Entitlement Classes -- Concept definitions for SVC and ENV