add-ideas/govoplan-poll
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
d0e68f5aa6d8b90f9353fe5b1b1d0e9aa5f13376
govoplan-poll/README.md

2.2 KiB
Raw Blame History

GovOPlaN Poll

Repository type: module (domain).

govoplan-poll owns lightweight decision and availability polls: date polls, option polls, yes/no decisions, single-choice, multi-choice, ranked choice, response visibility rules, anonymity settings, closing rules, and result summaries.

Poll is intentionally small and reusable. It provides polling primitives for modules such as Scheduling, Campaign, Portal, Calendar, and Evaluation without owning their domain workflows.

Boundaries

Poll owns:

  • poll definitions, options, invitations, responses, and result summaries
  • availability matrices for scheduling use cases
  • anonymity and result visibility semantics
  • closing, reopening, and decision outcome metadata

Poll does not own:

  • meeting scheduling workflows; those belong in govoplan-scheduling
  • post-event surveys, scoring, rubrics, and analytics; those belong in govoplan-evaluation
  • generic form rendering and submission runtime; those belong in govoplan-forms and govoplan-forms-runtime
  • mail, notification, and portal delivery infrastructure

Optional Access Integration

govoplan-access is optional. With Access installed, Poll can use identity resolution, permission checks, and role templates. Without Access, Poll remains usable for reduced flows such as anonymous participation, signed public links, or participant lists supplied by another adapter.

Current Backend Slice

The first backend implementation adds poll storage, option storage, response storage, validation, result aggregation, tenant summaries, module migrations, and authenticated API routes for:

  • single-choice, multiple-choice, yes/no, ranked-choice, and availability polls
  • opening, closing, and deciding polls
  • submitting and updating respondent answers
  • listing responses and reading result summaries

Development Install

cd /mnt/DATA/git/govoplan-core
./.venv/bin/python -m pip install -e ../govoplan-poll

Focused manifest verification:

cd /mnt/DATA/git/govoplan-poll
PYTHONPATH=src:/mnt/DATA/git/govoplan-core/src /mnt/DATA/git/govoplan-core/.venv/bin/python -m unittest discover -s tests