People pillar · v0.16.0
engagement-survey EngagementSurvey
Engagement survey.
$id · https://corpospec.com/schemas/v0.16.0/engagement-survey.schema.json
Fields
| Field | Type | Required | Description |
|---|---|---|---|
| anonymity_floor | integer | yes | Minimum cohort size below which results are suppressed to protect anonymity (typical: 5). |
| close_at | IsoDate | yes | ISO 8601 date (YYYY-MM-DD). |
| cohort_results | CohortResult[] | yes | |
| entity | PathRef | yes | Path-based cross-reference relative to .corpospec/ root. Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$` |
| id | PathRef | yes | Path-based cross-reference relative to .corpospec/ root. Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$` |
| kind | SurveyKind | yes | Survey type. |
| name | string | yes | |
| open_at | IsoDate | yes | ISO 8601 date (YYYY-MM-DD). |
| population_size | integer | yes | |
| response_count | integer | yes | |
| retention_until | IsoDate | yes | Retention 3 years (BGB §195 default civil claims). |
| status | SurveyStatus | yes | Survey status. |
| enps | number? | — | Overall eNPS (only for kind == Enps). |
| methodology_ref | PathRef? | — | PathRef into the methodology / vendor description. |
Definitions
Shared types referenced within this schema.
CohortResult
Cohort breakdown (e.g. by tenure-band, role-family, region).
type: object
IsoDate
ISO 8601 date (YYYY-MM-DD).
type: string
PathRef
Path-based cross-reference relative to .corpospec/ root.
Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$`
pattern: ^[a-z0-9_-]+(/[a-z0-9_.-]+)+$
QuestionRollup
Per-question rollup (aggregate across respondents in a cohort).
type: object
SurveyKind
Survey type.
SurveyStatus
Survey status.
enum: "draft", "open", "closed", "analysed", "archived"
Reference in your YAML
# yaml-language-server: $schema=https://corpospec.com/schemas/v0.16.0/engagement-survey.schema.json