document user profiles for testing

docs/testing.md

@@ -0,0 +1,136 @@
+# TaleWeave AI Testing
+
+## Contents
+
+- [TaleWeave AI Testing](#taleweave-ai-testing)
+  - [Contents](#contents)
+  - [User Profiles](#user-profiles)
+    - [Staff](#staff)
+      - [Admin](#admin)
+      - [Moderator](#moderator)
+    - [Users](#users)
+      - [Player](#player)
+      - [Spectator](#spectator)
+    - [Developers](#developers)
+      - [ML Engineer](#ml-engineer)
+      - [Project Contributor](#project-contributor)
+      - [Third-Party Mod Developer](#third-party-mod-developer)
+
+## User Profiles
+
+### Staff
+
+#### Admin
+
+Goals:
+
+- to host a game world as a Discord bot and/or website
+- to set up automation, backups, and webhooks
+- to set up interaction with other bots
+- to moderate the world and remove inappropriate events and/or images
+
+Skills:
+
+- familiar with Docker containers
+- familiar with JSON and YAML
+- familiar with setting up Discord bots
+- basic knowledge of ComfyUI and Ollama
+- plenty of disk space and 1-2 GPUs
+
+Notes:
+
+- may be connected through Discord or web (mobile web should offer some admin options as well)
+- could also be a player
+
+#### Moderator
+
+Notes:
+
+- non-admin moderator
+- TBD
+
+### Users
+
+#### Player
+
+Goals:
+
+- to play as a character in the game world
+- may want to set up some automation, webhooks, or interaction between bots
+
+Skills:
+
+- may know some JSON
+- may be familiar with scripting Discord bots and/or REST APIs
+
+Notes:
+
+- could be playing in Discord, web, or mobile web
+- can interact with characters and items on their turn
+- needs to be prompted and notified when their turn starts
+
+#### Spectator
+
+Goals:
+
+- to watch the game world as events unfold
+- to render and visualize recent events
+
+Skills:
+
+- has a Discord account and/or web browser
+
+Notes:
+
+- could be watching in Discord, web, or mobile web
+- cannot interact with characters or items in the world
+- can browse and view the world
+- can render recent events
+
+### Developers
+
+#### ML Engineer
+
+Goals:
+
+- exporting prompts, actions, and results/replies as training data
+- analyzing character movements, interactions, and notes to find emergent behavior
+
+Skills:
+
+- familiar with Python and Jupyter
+- familiar with JSON, probably also YAML
+- familiar with LLMs and prompting
+- able to run Docker containers
+
+#### Project Contributor
+
+Goals:
+
+- to add new actions and features
+- to fix bugs in the game engine
+- to improve the web client
+
+Skills:
+
+- familiar with Python and/or Typescript
+- familiar with JSON and YAML
+- familiar with REST and websocket APIs
+- basic knowledge of Discord bots
+- basic knowledge of LLMs
+- able to run Docker containers
+- may be familiar with React and MUI (frontend)
+- may be familiar with Pydantic and other Python dependencies (backend)
+
+#### Third-Party Mod Developer
+
+Goals:
+
+- to develop new features as game systems
+- to develop new actions and logic using existing systems
+
+Skills:
+
+- familiar with Python
+- probably familiar with JSON and/or YAML
+- basic knowledge of LLMs, especially prompting