poc-plattform-kit

Platform kit PoC: nine NestJS pillars + Next.js PWA SPA, PostgreSQL (Neon), Service Bus.

Engineering source of truth

Engineering work (features, bugs, infra, tech debt) is tracked as GitHub Issues in this repository, not ClickUp — see docs/github-source-of-truth.md for the full policy. Engineering technical documentation lives under docs/ (start at docs/architecture/overview.md).

ClickUp remains the system of record for private business/commercial planning only (ideas, commercial strategy, pricing, customer-private information) — it is not part of how engineering work is defined, sequenced, or claimed.

Stack

Layer	Choice
Web	Next.js PWA SPA, Tailwind, design tokens
Marketing	Astro SSG + Tailwind + Singleton SD tokens + Markdown + Decap (/admin); see docs/marketing-astro-decap.md
API	NestJS + Swagger
DB	PostgreSQL + Prisma (postgresql) — Neon PoC; Azure Flexible Server for shared
Messaging	Azure Service Bus
AuthN	Entra + Auth.js cookies (SingleSignOn)
AuthZ	Permissions pillar — OpenFGA (ReBAC) on ACA Consumption
Notifications	Forward Email · android-sms-gateway · Meta WhatsApp Cloud API
Secrets / config	Azure Key Vault · Azure App Configuration (KV refs)
CI	GitHub Actions — split ci-web / ci-api (path filters); SWA PR previews
Agents	READY FOR AI → REVIEW → HUMAN → COMPLETE; worktrees; humans merge

Pillars

tenant · single-sign-on · permissions · subscriptions · contact · support · audit · reporting · notifications

Quick start

pnpm install
pnpm sync:skills
pnpm dev:api
pnpm dev:web
pnpm dev:marketing

See SETUP.md, AGENTS.md, the client-facing changelog workflow, docs/pr-pipelines.md, and docs/marketing-astro-decap.md.