PARA

Schema reference

com.para.civic.defs

experimental

Indexed civic views for cabildeos, positions, option summaries, vote totals, outcomes, and viewer context.

Fields

cabildeoView

indexed object view

Required

Full indexed view of a civic deliberation including phase, options, summaries, vote totals, and viewer context.

positionView

indexed object view

Required

Indexed view of a user position tied to a cabildeo, including stance and text.

viewerContext

object

Optional

Per-viewer civic state such as current vote, delegation target, and grace-period metadata.

Metadata

Schema ID
com.para.civic.defs
Lexicon source
lexicons/com/para/civic/defs.json
Website source path
watx/lexicons/com/para/civic/defs.json
Product surfaces
Cabildeo detail, Cabildeo list, Delegated voting

Constraints

  • `cabildeoView` requires title, description, community, options, phase, createdAt, optionSummary, positionCounts, and voteTotals.
  • `positionView` requires cabildeo linkage, stance, text, and createdAt.

Relationships

  • Backs com.para.civic.getCabildeo and list-style civic queries.
  • Includes viewerContext for direct and delegated vote state.

Lifecycle

  • Records such as cabildeo, position, vote, and delegation are indexed into civic view objects.
  • Clients primarily consume the indexed view layer rather than stitching raw civic records together.

Writers

  • Backend indexing pipeline writes view materializations from civic records.

Readers

  • Cabildeo detail, cabildeo list, delegation UX, and community civic overlays.

Routes

  • /communities/cabildeos
  • /communities/cabildeos/:cabildeoUri
  • /communities/cabildeos/:cabildeoUri/delegate-vote

XRPC methods

  • com.para.civic.getCabildeo
  • com.para.civic.listCabildeos
  • com.para.civic.listCabildeoPositions

Indexing and moderation

Indexing

  • Aggregates options, votes, positions, and viewer context into cabildeoView.
  • Computes outcome and option summaries from indexed participation state.

Moderation

  • Community scope and viewer context shape which civic activity is shown to a user.

Examples

{"cabildeoView":{"title":"Water allocation reform","phase":"voting","optionSummary":[{"optionIndex":0,"label":"Approve","votes":82,"positions":16}]}}