Market pillar · v0.16.0
lead Lead
Lead record.
$id · https://corpospec.com/schemas/v0.16.0/lead.schema.json
Fields
| Field | Type | Required | Description |
|---|---|---|---|
| contact_pseudonym | string | yes | Pseudonymised contact handle (hash of email / phone). |
| created_at | IsoDate | yes | ISO 8601 date (YYYY-MM-DD). |
| 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_.-]+)+$` |
| lawful_basis | string | yes | Lawful basis for processing (Art. 6 GDPR — required for any EU subject). |
| owner_sdr | PathRef | yes | Path-based cross-reference relative to .corpospec/ root. Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$` |
| pii_class | PiiClass | yes | Personal-data classification on every record carrying personal data, per BDR 0070 / BDR 0069 / BDR 0078. Used by `corpospec-report` to gate rendering and by the privacy pillar's RoPA records to determine safeguards. |
| qualification_framework | QualificationFramework | yes | Qualification framework + score (0-100). |
| source | LeadSource | yes | Lead source. |
| stage | LeadStage | yes | Lifecycle stage (Forrester demand-waterfall). |
| company_name | string? | — | Company name (free-form until linked to a Customer). |
| consent_ref | PathRef? | — | PathRef to consent record (if Art. 6(1)(a) is the basis). |
| converted_opportunity | PathRef? | — | Set when stage == Converted. |
| disqualification_reason | DisqualificationReason? | — | Set when stage == Disqualified. |
| job_title | string? | — | Job title (when known). |
| last_contacted_at | IsoDate? | — | |
| lia_ref | PathRef? | — | PathRef to LIA artefact (if Art. 6(1)(f) is the basis). |
| qualification_score | number? | — | |
| source_campaign | PathRef? | — | Campaign that generated the lead (PathRef into campaign.rs). |
Definitions
Shared types referenced within this schema.
DisqualificationReason
Disqualification reason.
IsoDate
ISO 8601 date (YYYY-MM-DD).
type: string
LeadSource
Lead source.
LeadStage
Lifecycle stage (Forrester demand-waterfall).
PathRef
Path-based cross-reference relative to .corpospec/ root.
Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$`
pattern: ^[a-z0-9_-]+(/[a-z0-9_.-]+)+$
PiiClass
Personal-data classification on every record carrying personal data, per
BDR 0070 / BDR 0069 / BDR 0078. Used by `corpospec-report` to gate
rendering and by the privacy pillar's RoPA records to determine
safeguards.
QualificationFramework
Qualification framework.
Reference in your YAML
# yaml-language-server: $schema=https://corpospec.com/schemas/v0.16.0/lead.schema.json