SWO Extension Playground

swo-extension-playground is a minimal SoftwareOne Marketplace extension built on top of mpt-extension-sdk and mpt-tool.

It is primarily a playground repository: it shows the baseline extension shape, a simple validation API endpoint, an event listener, a small fulfillment pipeline, and the development workflow used by extension repositories in this ecosystem.

Repository Layout

• swo_playground/ contains the extension package.
• tests/ contains the pytest suite.
• make/*.mk contains the repository make targets.
• compose.yaml defines the local Docker-based development environment.

Quick Start

Prerequisites:

• Docker with the docker compose plugin
• make

Recommended setup:

make build
make test
make run

The application runs on http://localhost:8080.

Common Commands

Shared meaning of common make targets is documented in:

• knowledge/make-targets.md
• knowledge/build-and-checks.md

Documentation

• AGENTS.md: entry point for AI agents
• docs/architecture.md: architecture placeholder for future repository-specific design
• docs/contributing.md: repository-specific development workflow
• docs/local-development.md: local setup and service startup
• docs/deployment.md: runtime configuration and deployment-facing settings
• docs/testing.md: testing strategy and commands
• docs/migrations.md: migration workflow and current constraints
• docs/documentation.md: repository documentation rules

Keep repository-specific workflow details in the documents under docs/, not in this file.