Files
govoplan-poll/README.md

52 lines
1.8 KiB
Markdown

# GovOPlaN Poll
<!-- govoplan-repository-type:start -->
**Repository type:** module (domain).
<!-- govoplan-repository-type:end -->
`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.
## Development Install
```bash
cd /mnt/DATA/git/govoplan-core
./.venv/bin/python -m pip install -e ../govoplan-poll
```
Focused manifest verification:
```bash
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
```