Skip to content

Participant Profiles

Three participant types are already worked out in the shared Blue Dots schemas. An adaptor does not need to design these from scratch.

TypeWho they areDomain idItem schema
Job SeekerThe individual looking for workseekerprofile_1.0
Job ProviderThe employer posting a vacancyproviderjob_posting_1.0
Service ProviderAn organisation delivering a support service around the job-seeking process — training, counselling, assessment, placement assistanceservice_providerprofile_1.0

All three are declared in the reference network schema at examples/schemas/blue_dot/network.json in the Signals DPG repository.

Every participant type follows the same simple three-part structure, so profiles stay consistent and easy to extend:

  • Who I am — identity and contact details.
  • What I want — the need or opportunity being sought.
  • What I have — location, capacity, skills, or credentials on offer.

Only the details within each part differ by participant type. An adaptor can adjust or add fields as needed without rebuilding the structure itself.

The structure is not an abstraction layered over the schemas — it is how the shipped schemas are actually laid out. Mapping each part to the real field names:

Domain seeker, item schema profile_1.0.

PartFields
Who I amname, age, gender, phone, location, languageSpoken
What I wantnatureOfJobsInterestedIn, nameOfJobRolesInterestedIn, otherHelpNeeded
What I haveworkExperience, nameOfLastRoleHeld, educationCategory, itiTrade, itiInstitute, polytechnicDiploma, certificationDetails

Required at minimum: name, location, age, phone.

Domain provider, item schema job_posting_1.0.

PartFields
Who I amjobProviderName, jobProviderLocation, hiringManagerName, hiringManagerPhoneNumber, hiringManagerEmail
What I wantcandidateExperienceType, workExperienceYears, lastRoleHeld, the minQualification* family
What I haverole, positions, natureOfJob, salaryMin/salaryMax, stipendMin/stipendMax, taskRateMin/taskRateMax

A job provider’s What I have is the opportunity itself — the role, how many openings, and on what terms.

Domain service_provider, item schema profile_1.0.

PartFields
Who I amserviceProviderName, organisationType, contactPersonName, contactPhoneNumber, contactEmail, location
What I wantparticipantTypesServed, needsAddressed
What I haveservicesOffered, serviceMode, coverageArea, capacityPerMonth, costModel, accreditation, languagesSupported

Because registration and profile forms are schema-driven, adding or changing a field is a schema edit — no application code change:

  1. Edit the item schema in the network config (item_schemas for the domain).
  2. Add the new field to the domain’s x-form-layout sections so it renders in the right place.
  3. If it should show on the participant card, add it to card.default_fields.

See Schema-Driven Model for the mechanism and Configuration for where each file lives.