# GovOPlaN Evaluation

<!-- govoplan-repository-type:start -->
**Repository type:** module (domain).
<!-- govoplan-repository-type:end -->

`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

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

Focused manifest verification:

```bash
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
```