H2: Hero-module (tabellen en migratie, beheer-API, publieke GET /hero, afbeeldingsupload met focus, opschoonservice, teksten) en OpenAPI-snapshot

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-11-16 15:46:55 +01:00
co-authored by Claude Sonnet 5.5
parent 43925cbf37
commit ae04120d8c
31 changed files with 4221 additions and 3 deletions
+845
View File
@@ -506,6 +506,40 @@
],
"type": "object"
},
"FocusDto": {
"properties": {
"x": {
"format": "double",
"pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$",
"type": [
"number",
"string"
]
},
"y": {
"format": "double",
"pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$",
"type": [
"number",
"string"
]
},
"zoom": {
"format": "double",
"pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$",
"type": [
"number",
"string"
]
}
},
"required": [
"x",
"y",
"zoom"
],
"type": "object"
},
"ForgotPasswordRequest": {
"properties": {
"email": {
@@ -517,6 +551,421 @@
],
"type": "object"
},
"HeroAdminDto": {
"properties": {
"buttons": {
"items": {
"$ref": "#/components/schemas/HeroButtonDto"
},
"type": "array"
},
"display": {
"type": "string"
},
"endsAt": {
"format": "date-time",
"type": [
"null",
"string"
]
},
"id": {
"type": [
"null",
"string"
]
},
"isActive": {
"type": "boolean"
},
"isLive": {
"type": "boolean"
},
"lead": {
"type": [
"null",
"string"
]
},
"maxPublishedSlides": {
"format": "int32",
"pattern": "^-?(?:0|[1-9]\\d*)$",
"type": [
"integer",
"string"
]
},
"slides": {
"items": {
"$ref": "#/components/schemas/HeroSlideAdminDto"
},
"type": "array"
},
"startsAt": {
"format": "date-time",
"type": [
"null",
"string"
]
},
"tagline": {
"type": [
"null",
"string"
]
},
"title": {
"type": "string"
},
"updatedAt": {
"format": "date-time",
"type": [
"null",
"string"
]
}
},
"required": [
"id",
"title",
"tagline",
"lead",
"display",
"buttons",
"isActive",
"startsAt",
"endsAt",
"slides",
"isLive",
"updatedAt",
"maxPublishedSlides"
],
"type": "object"
},
"HeroButtonDto": {
"properties": {
"label": {
"type": "string"
},
"target": {
"type": "string"
}
},
"required": [
"label",
"target"
],
"type": "object"
},
"HeroButtonRequest": {
"properties": {
"label": {
"type": [
"null",
"string"
]
},
"target": {
"type": [
"null",
"string"
]
}
},
"required": [
"label",
"target"
],
"type": "object"
},
"HeroFocusRequest": {
"properties": {
"focus": {
"$ref": "#/components/schemas/FocusDto"
},
"tall": {
"oneOf": [
{
"type": "null"
},
{
"$ref": "#/components/schemas/FocusDto"
}
]
},
"wide": {
"oneOf": [
{
"type": "null"
},
{
"$ref": "#/components/schemas/FocusDto"
}
]
}
},
"required": [
"focus"
],
"type": "object"
},
"HeroImageDto": {
"properties": {
"focus": {
"$ref": "#/components/schemas/FocusDto"
},
"height": {
"format": "int32",
"pattern": "^-?(?:0|[1-9]\\d*)$",
"type": [
"integer",
"string"
]
},
"id": {
"type": "string"
},
"src": {
"type": "string"
},
"tallFocus": {
"oneOf": [
{
"type": "null"
},
{
"$ref": "#/components/schemas/FocusDto"
}
]
},
"variants": {
"items": {
"$ref": "#/components/schemas/HeroVariantDto"
},
"type": "array"
},
"wideFocus": {
"oneOf": [
{
"type": "null"
},
{
"$ref": "#/components/schemas/FocusDto"
}
]
},
"width": {
"format": "int32",
"pattern": "^-?(?:0|[1-9]\\d*)$",
"type": [
"integer",
"string"
]
}
},
"required": [
"id",
"width",
"height",
"focus",
"wideFocus",
"tallFocus",
"src",
"variants"
],
"type": "object"
},
"HeroSaveRequest": {
"properties": {
"buttons": {
"items": {
"$ref": "#/components/schemas/HeroButtonRequest"
},
"type": [
"null",
"array"
]
},
"display": {
"type": [
"null",
"string"
]
},
"endsAt": {
"format": "date-time",
"type": [
"null",
"string"
]
},
"isActive": {
"type": "boolean"
},
"lead": {
"type": [
"null",
"string"
]
},
"slides": {
"items": {
"$ref": "#/components/schemas/HeroSlideRequest"
},
"type": [
"null",
"array"
]
},
"startsAt": {
"format": "date-time",
"type": [
"null",
"string"
]
},
"tagline": {
"type": [
"null",
"string"
]
},
"title": {
"type": [
"null",
"string"
]
}
},
"required": [
"title",
"tagline",
"lead",
"display",
"buttons",
"isActive",
"startsAt",
"endsAt",
"slides"
],
"type": "object"
},
"HeroSlideAdminDto": {
"properties": {
"alt": {
"type": "string"
},
"decorative": {
"type": "boolean"
},
"id": {
"type": "string"
},
"image": {
"$ref": "#/components/schemas/HeroImageDto"
},
"imageId": {
"type": "string"
},
"isActive": {
"type": "boolean"
},
"sortOrder": {
"format": "int32",
"pattern": "^-?(?:0|[1-9]\\d*)$",
"type": [
"integer",
"string"
]
}
},
"required": [
"id",
"imageId",
"alt",
"decorative",
"isActive",
"sortOrder",
"image"
],
"type": "object"
},
"HeroSlideRequest": {
"properties": {
"alt": {
"type": [
"null",
"string"
]
},
"decorative": {
"default": false,
"type": "boolean"
},
"id": {
"format": "uuid",
"type": [
"null",
"string"
]
},
"imageId": {
"format": "uuid",
"type": "string"
},
"isActive": {
"default": true,
"type": "boolean"
}
},
"required": [
"id",
"imageId",
"alt"
],
"type": "object"
},
"HeroVariantDto": {
"properties": {
"height": {
"format": "int32",
"pattern": "^-?(?:0|[1-9]\\d*)$",
"type": [
"integer",
"string"
]
},
"ratio": {
"type": "string"
},
"type": {
"type": "string"
},
"url": {
"type": "string"
},
"width": {
"format": "int32",
"pattern": "^-?(?:0|[1-9]\\d*)$",
"type": [
"integer",
"string"
]
}
},
"required": [
"ratio",
"width",
"height",
"type",
"url"
],
"type": "object"
},
"IFormFile": {
"format": "binary",
"type": "string"
},
"InviteUserRequest": {
"properties": {
"email": {
@@ -667,6 +1116,121 @@
},
"type": "object"
},
"PublicHeroDto": {
"properties": {
"buttons": {
"items": {
"$ref": "#/components/schemas/HeroButtonDto"
},
"type": "array"
},
"display": {
"type": "string"
},
"lead": {
"type": [
"null",
"string"
]
},
"slides": {
"items": {
"$ref": "#/components/schemas/PublicSlideDto"
},
"type": "array"
},
"tagline": {
"type": [
"null",
"string"
]
},
"title": {
"type": "string"
}
},
"required": [
"display",
"title",
"tagline",
"lead",
"buttons",
"slides"
],
"type": "object"
},
"PublicImageDto": {
"properties": {
"focus": {
"$ref": "#/components/schemas/FocusDto"
},
"focusByRatio": {
"additionalProperties": {
"$ref": "#/components/schemas/FocusDto"
},
"type": [
"null",
"object"
]
},
"height": {
"format": "int32",
"pattern": "^-?(?:0|[1-9]\\d*)$",
"type": [
"integer",
"string"
]
},
"src": {
"type": "string"
},
"variants": {
"items": {
"$ref": "#/components/schemas/HeroVariantDto"
},
"type": "array"
},
"width": {
"format": "int32",
"pattern": "^-?(?:0|[1-9]\\d*)$",
"type": [
"integer",
"string"
]
}
},
"required": [
"width",
"height",
"focus",
"src",
"variants"
],
"type": "object"
},
"PublicSlideDto": {
"properties": {
"alt": {
"type": "string"
},
"decorative": {
"type": "boolean"
},
"id": {
"type": "string"
},
"image": {
"$ref": "#/components/schemas/PublicImageDto"
}
},
"required": [
"id",
"alt",
"decorative",
"image"
],
"type": "object"
},
"PushStatusRequest": {
"properties": {
"disableMessage": {
@@ -2266,6 +2830,281 @@
]
}
},
"/api/v1/hero": {
"get": {
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PublicHeroDto"
}
},
"text/json": {
"schema": {
"$ref": "#/components/schemas/PublicHeroDto"
}
},
"text/plain": {
"schema": {
"$ref": "#/components/schemas/PublicHeroDto"
}
}
},
"description": "OK"
},
"204": {
"description": "No Content"
}
},
"tags": [
"Hero"
]
},
"put": {
"requestBody": {
"content": {
"application/*+json": {
"schema": {
"$ref": "#/components/schemas/HeroSaveRequest"
}
},
"application/json": {
"schema": {
"$ref": "#/components/schemas/HeroSaveRequest"
}
},
"text/json": {
"schema": {
"$ref": "#/components/schemas/HeroSaveRequest"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HeroAdminDto"
}
},
"text/json": {
"schema": {
"$ref": "#/components/schemas/HeroAdminDto"
}
},
"text/plain": {
"schema": {
"$ref": "#/components/schemas/HeroAdminDto"
}
}
},
"description": "OK"
},
"400": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ProblemDetails"
}
},
"text/json": {
"schema": {
"$ref": "#/components/schemas/ProblemDetails"
}
},
"text/plain": {
"schema": {
"$ref": "#/components/schemas/ProblemDetails"
}
}
},
"description": "Bad Request"
}
},
"tags": [
"Hero"
]
}
},
"/api/v1/hero/all": {
"get": {
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HeroAdminDto"
}
},
"text/json": {
"schema": {
"$ref": "#/components/schemas/HeroAdminDto"
}
},
"text/plain": {
"schema": {
"$ref": "#/components/schemas/HeroAdminDto"
}
}
},
"description": "OK"
}
},
"tags": [
"Hero"
]
}
},
"/api/v1/hero/images": {
"post": {
"requestBody": {
"content": {
"multipart/form-data": {
"schema": {
"properties": {
"file": {
"$ref": "#/components/schemas/IFormFile"
}
},
"type": "object"
}
}
},
"required": true
},
"responses": {
"201": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HeroImageDto"
}
},
"text/json": {
"schema": {
"$ref": "#/components/schemas/HeroImageDto"
}
},
"text/plain": {
"schema": {
"$ref": "#/components/schemas/HeroImageDto"
}
}
},
"description": "Created"
}
},
"tags": [
"HeroImages"
]
}
},
"/api/v1/hero/images/{id}": {
"delete": {
"parameters": [
{
"in": "path",
"name": "id",
"required": true,
"schema": {
"format": "uuid",
"type": "string"
}
}
],
"responses": {
"204": {
"description": "No Content"
},
"409": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ProblemDetails"
}
},
"text/json": {
"schema": {
"$ref": "#/components/schemas/ProblemDetails"
}
},
"text/plain": {
"schema": {
"$ref": "#/components/schemas/ProblemDetails"
}
}
},
"description": "Conflict"
}
},
"tags": [
"HeroImages"
]
}
},
"/api/v1/hero/images/{id}/focus": {
"put": {
"parameters": [
{
"in": "path",
"name": "id",
"required": true,
"schema": {
"format": "uuid",
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/*+json": {
"schema": {
"$ref": "#/components/schemas/HeroFocusRequest"
}
},
"application/json": {
"schema": {
"$ref": "#/components/schemas/HeroFocusRequest"
}
},
"text/json": {
"schema": {
"$ref": "#/components/schemas/HeroFocusRequest"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HeroImageDto"
}
},
"text/json": {
"schema": {
"$ref": "#/components/schemas/HeroImageDto"
}
},
"text/plain": {
"schema": {
"$ref": "#/components/schemas/HeroImageDto"
}
}
},
"description": "OK"
}
},
"tags": [
"HeroImages"
]
}
},
"/api/v1/offerings": {
"get": {
"responses": {
@@ -2685,6 +3524,12 @@
{
"name": "ContactSettings"
},
{
"name": "Hero"
},
{
"name": "HeroImages"
},
{
"name": "Auth"
},