Search and Query Design

Fast search is important during a live continuity.

Basic Search

Users should be able to quickly search by name, summary, body text, tags, and entity type.

Examples:

Find "bridge"
Find characters in this town
Find factions connected to this guild
Find secrets known by this NPC

Structured Queries

The graph model should support structured questions.

Examples:

entities where kind = Character and status = Alive
relationships where relation_kind = knows and target = Secret X
paths from Character A to Faction B
events affecting Location C

Search Index

Start simple:

• Postgres full-text search
• trigram search for fuzzy names
• indexed entity type and project ID

Add a dedicated search engine later only when needed.

Useful Live Session Views

The UI should include fast views for:

• recently used entities
• active continuity threads
• secrets not yet revealed
• NPCs at current location
• faction relationships
• session chronology
• unresolved consequences

Design Warning

A large wiki is not enough. The system should answer questions from structure, not only from text search.