SOTER Platform Playbook

This playbook is the primary user and operations manual for SOTER. It consolidates instructions for system administrators, software developers, analysts, and business executives.

1. Quickstart & Onboarding Guide

Local Projections Pipeline Execution

To run a quick projection layout validation on local scenario configurations, run the following steps:

1. Verify environment status:

bash python3 soter.py diagnose

1. Compile view file:

bash python3 soter.py build workspace/acme/input/views/main.view

1. Execute layout projection: Runs the pipeline and outputs BPMN / PlantUML schema diagrams into the runtime folder:

bash python3 soter.py run workspace/acme/input/views/main.view --projector bpmn-io --output json

2. Administrator & Sysadmin Runbook

Deploying the Docker Stack on a VPS

Deploying the SOTER portal and Akasha database stack on a resource-constrained virtual private server (e.g., OVH VPS with 2-4 GB RAM) requires resource limiting to prevent host freeze.

JVM Heap Management for Elasticsearch

Elasticsearch JVM by default allocates half of physical memory. On small nodes, this triggers the Linux OOM Killer. Add explicit memory bounds in docker-compose.yml:

services:
  elasticsearch:
    image: elasticsearch:8.12.0
    environment:
      - "ES_JAVA_OPTS=-Xms512m -Xmx512m"
      - "discovery.type=single-node"
    deploy:
      resources:
        limits:
          memory: 1g

Rescue Mode Recovery

If the server freezes and SSH is unresponsive:

1. Boot into Rescue Mode via the VPS provider admin panel.
2. Mount the main system partition:

bash mount /dev/vda1 /mnt

1. Modify docker-compose.yml to cap heap size before rebooting into normal mode.

3. Executive Guide & Role Playbook

SOTER is structured around specific roles to enforce negentropy across organization processes:

• Executive: Reviews Ontological Dissonance metrics. Uses dashboards to check where real operations deviate from modeled genotype.
• Analyst: Models business processes in Logos using Subject-Verb-Object (SVO) statements.
• Developer: Integrates core system APIs, runs linter validations, and deploys projectors.

4. Troubleshooting & FAQ

Pyrefly Type Linting Errors

• Cause: Unannotated variables in user-defined plugins or custom functions.
• Fix: Annotate signatures using typing standards or run soter lint pyrefly to inspect configured type errors.

Projector Output Directory Missing

• Cause: Execution running before folder setup has run.
• Fix: Run python3 soter.py diagnose to auto-create standard folders (log/, data/, workspace/).