API-first: OpenAPI 3.0-spec för plattforms-API:t

- services/plattform/openapi.yaml dokumenterar hela ytan: auth
  (registrera organisation, logga in), användarhantering (admin),
  ärenden + append-only händelselogg (idempotent synk), arbetsledar-
  översikten, publik Live Share-delning och AI-orkestern — inklusive
  scheman för alla 15 händelsetyper, roller, JWT-anspråken och
  API:ts bärande principer (append-only, multi-tenant-404).
- Specen serveras live av plattformstjänsten på GET /api/openapi.yaml
  och följer med i containern.
- Verifierad i tre lager: maskinell validering (swagger-cli),
  paritetstest i vitest (varje dokumenterad väg finns i servern,
  händelsetyperna är kompletta) och integrationsteststeg som hämtar
  specen från den körande tjänsten.

Verifierat: integrationstestets 18 kontroller gröna mot Postgres 16,
29 vitest-tester gröna, produktionsbygge ok.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012EQg3rJsrQ1ZNTvkzmQAtt

This commit is contained in:

Claude

2026-08-03 07:22:05 +00:00

parent 04ab80a0b0

commit 12c5f1c617

7 changed files with 516 additions and 4 deletions

									
										services/plattform/Dockerfile
									
		+1
		-1
	
												View File
												
				@@ -4,7 +4,7 @@ FROM node:22-alpine

				WORKDIR /app

				COPY package.json ./

				RUN npm install --omit=dev --no-audit --no-fund && npm cache clean --force

				COPY server.mjs ./

				COPY server.mjs openapi.yaml ./

				ENV NODE_ENV=production PORT=8080

				USER node