govoplan-evaluation/README.md

GovOPlaN Evaluation

Repository type: module (domain).

govoplan-evaluation owns structured evaluations: feedback questionnaires, surveys, rubrics, scoring, qualitative comments, recurring evaluations, aggregation, exports, and report-ready results.

Evaluation is heavier than Poll. Poll answers lightweight decision questions; Evaluation measures outcomes, quality, satisfaction, compliance, or performance after a process, appointment, event, campaign, service, or project.

Boundaries

Evaluation owns:

• evaluation templates, runs, questions, rubrics, and scoring models
• participant invitations and evaluation responses
• aggregated metrics and qualitative feedback summaries
• post-event, post-appointment, campaign, training, service, and project evaluation semantics

Evaluation does not own:

• lightweight option/date polls; those belong in govoplan-poll
• meeting scheduling decisions; those belong in govoplan-scheduling
• generic form rendering and submission runtime; those belong in govoplan-forms and govoplan-forms-runtime
• BI dashboards and long-term reporting infrastructure

Optional Access Integration

govoplan-access is optional. With Access installed, Evaluation can use identity resolution, permission checks, and role templates. Without Access, Evaluation remains usable for reduced flows such as public-link questionnaires, local participant lists, or tenant-local response collection.

Development Install

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

Focused manifest verification:

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