features
Last updated: 2025-07-19 01:07:42.377807 File source: link on GitLab
Acceptance Test Features Overview
This document outlines the defined features and scenarios used for acceptance testing of the NuNet platform, with a particular focus on the Device Management Service (DMS). It emphasizes user-facing behavior and system-level interactions across a range of operational contexts.
Notes:
No features or scenarios will be included for running the DMS process, enabling the service, or configuring its environment.
The stakeholder categories used in the matrix are defined here.
The environment definitions can be found here.
To update the test matrix, go to
tests/acceptance/scriptsdirectory and runpython3 update_test_matrix.py.To view the features and scenarios marked as @wip, go to
tests/acceptance/scriptsdirectory and runpython3 report_wip_features.py.
Test Matrix
Grant, revoke, and delegate behavior-level capabilities across users.
Resource Providers and Facilitators
Feature or Testnet
Implemented
Not started
Create and execute a contract.
Service and Resource Providers, Facilitators
Testnet
In progress
Not started
As a Service Provider I want to deploy my computation on other nodes So that I don't have to use my machine
Service Providers
Feature or Testnet
Implemented
In refactoring
This test is fully implemented but being refactored.
Cancel deployments in various lifecycle stages and error conditions.
Service Providers
Feature or Testnet
Implemented
Not started
Consider placement constraints such as location, edge proximity, or hardware specs to do a deployment.
Service and Resource Providers
Testnet - Requires infrastructure specific to each scenario.
Implemented
Not started
View, manage, and interact with active or failed deployments.
Service Providers
Feature or Testnet
Implemented
Not started
Support deployments that communicate via IP networking.
Service and Resource Providers
Feature or Testnet
Implemented
Not started
Support multiple container/runtime types such as Docker and Firecracker.
Feature or Testnet
Docker Implemented
Not started
Test different strategies and levels of failure recovery for nodes, allocations, ensembles, deployments etc.
Service Providers
Feature or Testnet
Part of it in open MRs
Not started
As a Service Provider I want deployments with location constraints to run only on eligible nodes So that deployments follow geographic policies
Services Providers
Testnet
Implemented
Not started
Usage of AI agent in public and private modes.
End Users
Testnet - Requires infrastructure as DDNS, Proxy, CA, GlusterFS.
In progress
Not started
Provide logs, metrics, and tracing for deployed services and system behavior.
Service and Resource Providers, Facilitators
Testnet - Requires infrastructure for storing and visualizing the generated data.
Implemented
Not started
Join, create, and manage private and public organizations.
Facilitators
Feature
Implemented
Not started
Launch Posemesh nodes.
Service Providers
Testnet - Requires infrastructure as DDNS, Proxy, CA.
In progress
Not started
As a Service Provider I want to launch a service on a peer So that I can send a request to it
Service Providers
Feature or Testnet
Implemented
In progress
Handle deployments with data persistence across reboots or environments.
Service Providers
Feature or Testnet - Requires GlusterFS infrastructure.
Implemented
Not started
Monitor and react to deployment or system failures automatically.
Service and Resource Providers
Feature or Testnet
Not implemented
Not started
View DMS status, peer information, and peer connectivity.
Resource Providers
Feature or TestNet
Implemented
Not started
As a Service Provider I want to deploy tasks across one or multiple peers So that I don't have to use my machine
Service Providers
Feature or Testnet
Implemented
In progress
Feature Coverage
Feature: Capabilities Management
Grant, revoke, and delegate behavior-level capabilities across users.
Scenarios:
Allow authorized users to invoke behaviors
Anchor a capability with require/provide/root conditions
Delegate a capability to another user
Grant a capability to a user
Prevent unauthorized users from invoking behaviors
Revoke a previously granted capability
Feature: Contract Management
Create and execute a contract.
Scenarios:
Create a contract with detailed resource requirements, payment terms, participant information, and custom terms
Digitally sign the contract by all relevant parties
Execute a deployment to analyze the contract's state transitions through to termination
Recover contract data in the event of a system failure or restart
Feature: Deployment
As a Service Provider I want to deploy my computation on other nodes So that I don't have to use my machine
Scenarios:
Retrieve output from execution
Feature: Deployment Cancellation
Cancel deployments in various lifecycle stages and error conditions.
Scenarios:
Attempt to cancel a deployment on an unavailable peer
Attempt to cancel a deployment that has already completed
Cancel an ongoing deployment
Feature: Deployment Constraints
Consider placement constraints such as location, edge proximity, or hardware specs to do a deployment.
Scenarios:
Launch a deployment considering edge constraints
Launch a deployment with geographic (location-based) constraints
Launch a deployment with minimum hardware specifications
Feature: Deployment Operations
View, manage, and interact with active or failed deployments.
Scenarios:
List all deployments
Restart a failed deployment
Shutdown/stop a running deployment
View a deployment’s current status
View deployment logs
View deployment manifest
Feature: Deployment in an IP Network
Support deployments that communicate via IP networking.
Scenarios:
Connect to a running deployment via SSH
Launch multiple deployments that communicate via IP network
Feature: Executor Types
Support multiple container/runtime types such as Docker and Firecracker.
Scenarios:
Deploy using a Docker executor
Deploy using a Firecracker executor
Feature: Failure Recovery
Test different strategies and levels of failure recovery for nodes, allocations, ensembles, deployments etc.
(Scenarios to be defined)
Feature: Geolocation
As a Service Provider I want deployments with location constraints to run only on eligible nodes So that deployments follow geographic policies
Scenarios:
Deployment fails when one or more nodes have no matching running nodes for geographic constraints
Deployment is distributed across two eligible nodes based on location constraints
Deployment is executed only on a node satisfying location constraints
Feature: NuNet Documentation AI Agent
Usage of AI agent in public and private modes.
Scenarios:
Launch a NuNet Documentation AI agent for public usage
Launch a NuNet Documentation AI private agent
Launch a WebUI or API interface for enabling end-user interaction with the model
Feature: Observability
Provide logs, metrics, and tracing for deployed services and system behavior.
(Scenarios to be defined)
Feature: Organization Management
Join, create, and manage private and public organizations.
Scenarios:
Attempt to join an unauthorized private organization/network
Create a private organization/network
Join NuNet’s public network
Join a private organization/network
View organizations the peer is part of
Feature: Posemesh
Launch Posemesh nodes.
Scenarios:
Launch a deployment with a Dynamic DNS Node
Launch a deployment with a Relay Node
Feature: Service Deployment
As a Service Provider I want to launch a service on a peer So that I can send a request to it
Scenarios:
Deploy a service and send a request
Feature: Stateful Deployment
Handle deployments with data persistence across reboots or environments.
Scenarios:
Attempt to restore data from an invalid or missing storage path
Launch a new deployment restoring from a local volume
Persist deployment data to a local volume (disk)
Feature: Supervision
Monitor and react to deployment or system failures automatically.
(Scenarios to be defined)
Feature: System and Peer Status
View DMS status, peer information, and peer connectivity.
Scenarios:
Ensure connected peers list reflects only active connections
Ping a connected peer
View DMS status (version, onboarding status, DMS DID)
View connected peers
View self peer information
Feature: Task Deployment
As a Service Provider I want to deploy tasks across one or multiple peers So that I don't have to use my machine
Scenarios:
Launch a deployment on a target peer
Launch a deployment on any available peer in the network
Launch multiple deployments on different peers
Launch multiple deployments on the same peer
Next Steps
Define scenarios that uses Failure Recovery, Supervision and Observability.
Identify other scenarios for DMS acceptance tests and NuNet platform.
Define features and scenarios for other projects like running external nodes, appliance, LLM use cases.
Implement the scenarios prioritizing the most frequently used functionalities as well as newly implemented features and use cases.
Last updated