README.md

V2018 Scenario Generator

Generate a scenario based on a morphological box.

Live demo at https://tnocs.github.io/scenario-generator.

Prerequisites

Yarn classic or PNPM (npm i -g pnpm).

Install dependencies

Run yarn from the root folder of this project. The application uses Yarn workspaces to handle dependencies between packages.

Alternatively, run pnpm m i from the command line to install all dependencies.

Develop

Run yarn dev or npm run dev to start developing.

Build

Run yarn build or npm run build to build a release.

Creating a new configuration

The current version does not come with a full-blown configuration editor. Although you can edit object types, in case you want to limit or increase the number of categories, you need to edit the JSON file manually.

Step 1: Download the JSON file

Open the menu (top left, 3 horizontal lines) and select IMPORT/EXPORT. Export the current file.

Step 2: Renaming a category

Replace the capitalized names in the JSON below. The CATEGORY_NAME is displayed at the name of the tab. You can have multiple categories. Each category specifies the dimensions (columns or rows) that must be shown. You can choose from the following dimensions (which also includes the singular and plural form that is displayed in the GUI):

• Access: access | access
• Action: action | actions
• Actor: actor | actors
• AvailableBudget: budget | budget
• BehaviourDuringPreparation: behaviour during preparation
• Capabilities: capability | capabilities
• CompartmentsPresent: compartments present
• CriminalPhase: criminal phase
• Duration: duration | durations
• Equipment: equipment | equipment
• ExistingInfra: existing infra | existing infrastructures
• Impact: impact
• Intent: bystander intent
• Location: location | locations
• Means: means | means
• MeansWeapon: means/weapon | means/weapons
• ModusOperandiDuringExecution: mode of operation | modus operandi
• Motivation: motivation | motivations
• OpenCompartments: open compartment | open compartments
• PeopleDensity: person density | person densities
• Persons: person | persons
• PhysicalAngleOfAttackDuringExecution: physical angle of attack | physical angle of attacks
• PI: protected interest (target) | protected interests
• PrivacyAwareness: privacy awareness
• RelationOwnerObjectAndOwnerSecuritySystem: relation owner object and owner security system
• Responsibility: responsibility | responsibilities
• SecurityAwareness: security awareness
• TargetType: target type | target types
• ThreatDirection: threat direction | threat directions
• TypeOfEnvironment: environment type | environment types
• TypeOfObject: type of object | type of objects
• WeatherBehaviour: weather behaviour
• WeatherType: weather condition | weather conditions
• MeansWeapon: means/weapon | means/weapons
• MissionContext: mission context | mission contexts
• Adversary: adversary | adversaries
• C2HeadQuarters: C2-HQ location | C2-HQ locations
• Target: target | targets
• DeliberateAction: deliberate action | deliberate actions
• Means2: means of attack | means of attack
• Access2: means of access | means of access
• Means2access: means to access | means to acces
• Means3: means for action | means for action
• Means4: means for access | means for access

{
  "scenarios": {
    "current": {
      "inconsistencies": [],
      "narratives": [],
      "id": "ANY_ID",
      "type": "scenarios",
      "category": "SCENARIO",
      "name": "SCENARIO_NAME",
      "categories": {
        "CATEGORY_NAME": [
          "Actor",
          "Action",
          "Means",
          "Access",
          "TypeOfObject"
        ]
      }
    },
    "list": [
      {
        "inconsistencies": [],
        "narratives": [],
        "id": "ANY_ID",
        "type": "scenarios",
        "category": "SCENARIO",
        "name": "SCENARIO_NAME",
        "categories": {
          "CATEGORY_NAME": [
            "Actor",
            "Action",
            "Means",
            "Access",
            "TypeOfObject"
          ]
        }
      }
    ]
  },
  // ...
}

Step 3: Add the dimensions

For each dimension that you are using, you need to create an initial (optionally empty) placeholder. For example, if you include the dimension Actor, the JSON configuration needs to contain an Actor property:

  "Actor": { "list": [] },

Although you can pre-populate the list, as in the example below, it is much easier to edit these items via the GUI.

  "Actor": {
    "list": [
      { "name": "Activist", "type": "Actor", "id": "af0c21eb" }
    ]
  },

Step 4: Putting it all together

When you are done, save the JSON configuration and load it via the same menu (IMPORT|EXPORT) and you are ready to start. A very simple JSON file to get you going is:

{
  "scenarios": {
    "current": {
      "inconsistencies": [],
      "narratives": [],
      "id": "ts1",
      "type": "scenarios",
      "category": "SCENARIO",
      "name": "Threat scenario 1",
      "categories": {
        "Threat scenario": [
          "Actor",
          "PI",
          "Action",
          "MeansWeapon",
          "Access"
        ]
      }
    },
    "list": [
      {
        "inconsistencies": [],
        "narratives": [],
        "id": "ts1",
        "type": "scenarios",
        "category": "SCENARIO",
        "name": "Threat scenario 1",
        "categories": {
          "Threat scenario": [
            "Actor",
            "PI",
            "Action",
            "MeansWeapon",
            "Access"
          ]
        }
      }
    ]
  },
  "Actor": {
    "list": []
  },
  "PI": {
    "list": []
  },
  "Action": {
    "list": []
  },
  "MeansWeapon": {
    "list": []
  },
  "Access": {
    "list": []
  }
}