Service
A Service is a Product that warrants an outcome, delivered by Agents and Humans under an Outcome Contract.
Properties
| Property | Type | Required | Description |
|---|---|---|---|
floor | string | The human floor: none, sign, or practice. |
Inherited from Product: 3 properties
| Property | Type | Required | Description |
|---|---|---|---|
name | string | required | The name of the Product. |
promise | text | required | What the Customer can rely on. |
status | string | required | One of draft, selling or retired, set by its Offers. |
Object
{
"$id": "https: //api.sb/ routewise.dev/ services/ service_1",
"$type": "Service",
"name": "RouteWise",
"promise": "A route plan for 500 stops in under two seconds.",
"status": "draft",
"floor": "none"
}Relationships
- A Service requires many Workers: a Service’s outcome is delivered by the Agents and Humans who fill its Roles.
requires, inversestaffs. - A Service is supplied by many Suppliers: Suppliers staff Services through the Startup’s human supply.
suppliedBy, inversedelivers.
Verbs
createCreates a Service.POST /{namespace}/servicesgetReturns one Service by id.GET /{namespace}/services/{id}listReturns Services, newest first, one page at a time.GET /{namespace}/servicesupdateChanges the given properties of a Service.PATCH /{namespace}/services/{id}deleteDeletes a Service; its history is kept.DELETE /{namespace}/services/{id}
Permissions
Which Access level may call each Verb. One-way Verbs wait their delay window.
| Operation | owner | admin | member | viewer |
|---|---|---|---|---|
Service.create | Yes | Yes | Yes | No |
Service.get | Yes | Yes | Yes | Yes |
Service.list | Yes | Yes | Yes | Yes |
Service.update | Yes | Yes | Yes | No |
Service.delete | Yes | Yes | Yes | No |
Call it
Add a service to LedgerLark.Example
A bookkeeping Service warrants a reconciled month by the fifth working day. Agents do the matching, and a Human accountant reviews exceptions.