Schema

Canonical data shapes returned by the portfolio API.

All data models are defined as Zod schemas and inferred to TypeScript types. These are the exact shapes returned by the REST API endpoints.

REST

A single professional role with company, dates, highlights and sector.

src/lib/schemas/experience.ts

Field	Type	Required	Notes
`company`	`string`	required	min(1)
`role`	`string`	required	min(1)
`startDate`	`string`	required	ISO datee.g. 2022-01-01
`endDate`	`string \| 'present'`	required	ISO date or literal 'present'
`summary`	`string`	required	min(1)
`highlights`	`string[]`	required	array min(1)
`sector`	`string`	required	min(1)
`logoSlug`	`string`	optional

REST

Metadata for a published article. Body content is not exposed via the API.

src/lib/schemas/article.ts

Field	Type	Required	Notes
`slug`	`string`	required	URL-safe identifier derived from filename
`title`	`string`	required	min(1)
`publishedAt`	`string`	required	ISO date
`summary`	`string`	required	min(1)
`category`	`ArticleCategory`	required	enum: PM Craft \| Strategy \| Regulation & Policy \| AI & Product
`tags`	`string[]`	required
`draft`	`boolean`	required	Draft articles are excluded from API responses
`featured`	`boolean`	optional
`readingTime`	`number`	required	Estimated minutes at 200 wpm

REST

Metadata for a project case study.

src/lib/schemas/project.ts

Field	Type	Required	Notes
`slug`	`string`	required
`title`	`string`	required
`summary`	`string`	required
`sector`	`string`	required
`type`	`'build-product' \| 'pm-proof' \| 'article' \| 'hybrid'`	required
`status`	`'concept' \| 'in-progress' \| 'live' \| 'archived'`	required
`tier`	`'1' \| '2' \| '3'`	required	Launch priority tier
`featured`	`boolean`	optional
`publishedAt`	`string`	required	ISO date
`tags`	`string[]`	required

REST

A grouped set of skills with proficiency levels.

src/lib/data/skills.ts

Field	Type	Required	Notes
`label`	`string`	required	Category name e.g. Platform & APIs
`skills`	`Skill[]`	required

REST

An individual skill within a SkillCategory.

src/lib/data/skills.ts

Field	Type	Required	Notes
`name`	`string`	required
`level`	`'expert' \| 'proficient' \| 'familiar'`	required

The SOAP service uses document/literal encoding with types defined in the WSDL XSD schema. Available at GET /api/v1/soap/experience.

SOAP

Field	Type	Required
`Index`	`xsd:integer`	required
`Company`	`xsd:string`	required
`Role`	`xsd:string`	required
`StartDate`	`xsd:string`	required
`EndDate`	`xsd:string`	required
`Summary`	`xsd:string`	required
`Highlights/Highlight`	`xsd:string[]`	required
`Sector`	`xsd:string`	required

SOAP

Field	Type	Required	Notes
`Name`	`xsd:string`	required
`Level`	`xsd:string`	required