Skip to content →
Build a worldOrganizations
GitHub
Build a world

Organizations

Model multiple branded businesses, their services, staff, and system-of-record usage.

Organization model

Organizations make a seeded world feel like a set of real businesses rather than one generic practice. Each record contains a public identity and an operational description.

FieldMeaning
IdentityName, type, website, initials, optional logo, typeface, and palette
OfferingShort and long descriptions, services, locations, and staff
PersonalityA compact voice and behavior cue for the organization
System of recordExplicit lists of what the business does and does not use the connected system for

Seed your own organizations

Pass organizations as part of the simulation config when you reset the world. The bundled organizations are examples only.

Request
curl -X POST http://localhost:3000/api/simulation \
  -H 'Content-Type: application/json' \
  -d '{
    "config": {
      "organizations": [{
        "id": "north-star",
        "name": "North Star Care",
        "type": "Primary care",
        "shortDescription": "Neighborhood primary care",
        "description": "A small practice serving local families.",
        "website": "https://north-star.example",
        "offering": "Same-day and continuity care",
        "initials": "NS",
        "typeface": "sans",
        "palette": { "bg": "#101010", "primary": "#fff", "accent": "#bbb", "ink": "#fff", "onPrimary": "#000" },
        "locations": ["Central"],
        "services": [],
        "staff": [],
        "personality": "Direct and calm",
        "systemOfRecord": { "used": ["appointments"], "notUsed": ["clinical notes"] }
      }]
    }
  }'

Routing work

Messages and appointment requests may carry an organizationId. If an assignee is not provided, Praxis chooses a clinician or practice-staff watcher affiliated with that organization.

This keeps actor-to-practice traffic and operational queues scoped to the right business while still allowing a world with several organizations and overlapping relationships.