Indexer Contract

This document is the authoritative reference for all data the voting service sends to the indexer service, which makes resources searchable via the query service.

The voting service is a wrapper service — it ingests data from the legacy ITX system via NATS KV bucket events and republishes index messages to the LFX indexer. It does not own data directly.

Update this document in the same PR as any change to indexer message construction.

---

Resource Types

• Vote (Poll)
• Vote Response

---

Vote (Poll)

Object type: vote

Source struct: internal/domain/event_models.go — VoteData

Publisher: internal/infrastructure/eventing/nats_publisher.go — sendVoteIndexerMessage

NATS subject: lfx.index.vote

Indexed on: create, update, delete events from the ITX NATS KV bucket (poll data).

Data Schema

These fields are indexed and queryable via filters or cel_filter in the query service.

Field	Type	Description
vote_uid	string	Vote unique identifier (v2 primary key; same value as poll_id)
poll_id	string	ITX poll identifier (v1 primary key)
name	string	Vote/poll display name
description	string	Vote description
creation_time	string	Creation timestamp from ITX
last_modified_time	string	Last modified timestamp from ITX
end_time	string	Vote end time
status	string	Vote status (e.g., Open, Closed)
project_id	string	ITX project identifier (v1 SFID)
project_uid	string	LFX project UID (v2)
project_name	string	Project display name
committee_id	string	ITX committee identifier (v1 SFID)
committee_uid	string	LFX committee UID (v2)
committee_name	string	Committee display name
committee_type	string	Committee type
committee_voting_status	bool	Whether the committee has voting enabled
committee_filters	[]string	Committee filter values applied to this vote
total_voting_request_invitations	int	Total number of voting invitations sent
poll_questions	[]object	Poll questions (see Poll Question schema)
num_response_received	int	Number of responses received
poll_type	string	Poll type (e.g., election, general)
pseudo_anonymity	bool	Whether responses are pseudo-anonymous
num_winners	int	Number of winners for election-type polls
allow_abstain	bool	Whether abstaining is allowed

Poll Question Schema

Each element in poll_questions has:

Field	Type	Description
question_id	string	Question identifier
prompt	string	Question text
type	string	Question type (e.g., single_choice, multiple_choice, ranked_choice)
choices	[]object	Available choices (each has choice_id string and choice_text string)

Tags

Tag Format	Example	Purpose
committee_uid:{value}	committee_uid:061a110a-7c38-4cd3-bfcf-fc8511a37f35	Find votes for a committee
project_uid:{value}	project_uid:cbef1ed5-17dc-4a50-84e2-6cddd70f6878	Find votes for a project

Tags are only emitted when the corresponding UID is non-empty.

Access Control (IndexingConfig)

Field	Value
access_check_object	vote:{vote_uid}
access_check_relation	viewer
history_check_object	vote:{vote_uid}
history_check_relation	auditor

Search Behavior

Field	Value
fulltext	name, description (space-joined)
name_and_aliases	name (when non-empty)
sort_name	name
public	false (always)

Parent References

Ref	Condition
project:{project_uid}	Only when project_uid is non-empty
committee:{committee_uid}	Only when committee_uid is non-empty

---

Vote Response

Object type: vote_response

Source struct: internal/domain/event_models.go — VoteResponseData

Publisher: internal/infrastructure/eventing/nats_publisher.go — sendVoteResponseIndexerMessage

NATS subject: lfx.index.vote_response

Indexed on: create, update, delete events from the ITX NATS KV bucket (vote response data).

Data Schema

Field	Type	Description
uid	string	Vote response unique identifier (v2 primary key; same value as vote_id)
vote_id	string	ITX vote identifier (v1 primary key)
vote_uid	string	UID of the parent vote/poll (v2)
poll_id	string	ITX poll identifier (v1)
project_id	string	ITX project identifier (v1 SFID)
project_uid	string	LFX project UID (v2)
vote_creation_time	string	Time the vote response was created
user_id	string	Auth0 user identifier
user_email	string	User's email address
user_role	string	User's role at time of voting
user_name	string	User's display name
username	string	User's Auth0 username
profile_picture	string	URL to user's profile picture
user_voting_status	string	User's voting eligibility status
user_org_id	string	User's organization identifier
user_org_name	string	User's organization name
poll_answers	[]object	User's answers to poll questions (see Poll Answer schema)
vote_status	string	Vote response status
abstained	bool	Whether the user abstained
voter_removed	bool	Whether the voter was removed
ses_message_id	string	AWS SES message identifier
ses_message_last_sent_time	string	Timestamp of last SES email send
ses_bounce_type	string	SES bounce type (if any)
ses_bounce_subtype	string	SES bounce subtype (if any)
ses_delivery_successful	bool	Whether SES delivery succeeded
ses_complaint_exists	bool	Whether an SES complaint was filed
ses_complaint_type	string	SES complaint type (if any)
ses_complaint_date	string	Date of SES complaint (if any)
ses_email_opened	bool	Whether the email was opened
ses_email_opened_first_time	string	First time the email was opened
ses_email_opened_last_time	string	Last time the email was opened
ses_link_clicked	bool	Whether a link in the email was clicked
ses_link_clicked_first_time	string	First time a link was clicked
ses_link_clicked_last_time	string	Last time a link was clicked

Poll Answer Schema

Each element in poll_answers has:

Field	Type	Description
question_id	string	Question identifier
prompt	string	Question text
type	string	Question type
user_choice	[]object (optional)	Selected choices for non-ranked questions (each has choice_id and choice_text)
ranked_user_choice	[]object (optional)	Ranked choices for ranked questions (each has choice_id, choice_text, choice_rank int)

Tags

Tag Format	Example	Purpose
vote_uid:{value}	vote_uid:abc123-...	Find responses for a vote
project_uid:{value}	project_uid:cbef1ed5-...	Find responses for a project

Tags are only emitted when the corresponding UID is non-empty.

Access Control (IndexingConfig)

Field	Value
access_check_object	vote:{vote_uid}
access_check_relation	viewer
history_check_object	vote_response:{uid}
history_check_relation	auditor

Note: access checks are scoped to the parent vote object, not the response itself.

Search Behavior

Field	Value
fulltext	username
name_and_aliases	username (when non-empty)
sort_name	username
public	false (always)

Parent References

Ref	Condition
project:{project_uid}	Only when project_uid is non-empty
vote:{vote_uid}	Only when vote_uid is non-empty