plan: rewrite Home.md as landing page hub

2026-06-24 14:07:59 +02:00
parent 59decf43b8
commit 35d37de186
1 changed files with 96 additions and 1 deletions
@@ -1 +1,96 @@
-Willkommen im Wiki.
+# plate-auth
+
+> A reusable auth + multi-tenancy library for the **plate-software** app family.
+> Spring Boot starter (backend) + npm package (frontend). One source of truth, every app consumes it.
+
+**Status:** Planning (Sprint 0 — extraction from InspectFlow) · **Wiki version:** Draft v1 · **Date:** 2026-06-24
+
+---
+
+## 🎯 What is plate-auth?
+
+plate-auth is the carve-out of [InspectFlow](https://git.plate-software.de/pplate/inspectflow)'s Sprint 14 auth & membership system into a standalone, versioned library. It ships two artifacts:
+
+| Artifact | Coordinate | Consumed by |
+|----------|-----------|-------------|
+| Spring Boot Starter | `de.platesoft:plate-auth-starter:0.1.0` | Java/Spring Boot 4 backends |
+| npm package | `@platesoft/auth:0.1.0` | Next.js 15+ frontends |
+
+**Provides:**
+
+- 🔐 **T1 — Auth core:** Google OAuth (via NextAuth v5), magic-link email, JWT issuance + filter, Spring Security config, NextAuth ↔ backend exchange protocol (HMAC-signed envelope, replay-protected)
+- 🏢 **T2 — Multi-tenancy:** `User` + `UserIdentity`, `Company`/`Membership` (or generic `Organization`), invitations, access requests, admin panel, login audit
+- 🔌 **T3 (stays in app):** App-specific onboarding, tenant auto-mapping rules, business-domain entities
+
+---
+
+## 📚 Wiki pages
+
+### Strategy
+
+| Page | Purpose |
+|------|---------|
+| [Vision](Vision) | What plate-auth is, who consumes it, what success looks like |
+| [Architecture](Architecture) | T1/T2/T3 tier model, package boundaries, public API, dependency diagrams |
+| [Roadmap](Roadmap) | v0.1 → v0.2 → v0.3 → v0.4 — speculative beyond v0.1 |
+
+### Sprint 0 (current — Extraction from InspectFlow)
+
+| Page | Purpose |
+|------|---------|
+| [Sprint-0-Assessment](Sprint-0-Assessment) | State of the InspectFlow auth code, what is reusable, risks, recommendation |
+| [Sprint-0-Plan](Sprint-0-Plan) | File-by-file extraction plan, package renames, Flyway consolidation, publishing pipeline |
+| [Sprint-0-Testplan](Sprint-0-Testplan) | Unit / integration / contract test coverage matrix |
+
+### Consumer guides
+
+| Page | Purpose |
+|------|---------|
+| [Integration-Guide](Integration-Guide) | How a NEW app (Sparkboard etc.) consumes plate-auth on day 1 |
+| [Migration-InspectFlow](Migration-InspectFlow) | Step-by-step refactor of InspectFlow to consume the library |
+
+### Open
+
+| Page | Purpose |
+|------|---------|
+| [Open-Questions](Open-Questions) | Parking lot for ❓ Ask phase — decisions Patrick must make |
+
+---
+
+## 🧬 Heritage
+
+plate-auth is not greenfield. It is the **fully battle-tested** auth system built across six sub-sprints in InspectFlow Sprint 14 (2026-06-22 → 2026-06-24):
+
+- 14.1 — Multi-provider auth foundation (🐙 Octopus Camouflage)
+- 14.2 — Membership model + MS tenant auto-mapping (🦠 Cell Membranes)
+- 14.3 — Invitation flow (🐜 Pheromone Trails)
+- 14.4 — Self-service access requests (🐝 Honeybee Quorum)
+- 14.5 — Onboarding UX (🐻‍❄️ Tardigrade Cryptobiosis)
+- 14.6 — Admin panel + login audit (🌳 Tree Rings)
+
+Sprint 0 is the **modularization sprint** — same code, repackaged, repointed, republished.
+
+---
+
+## 🚦 Sprint 0 pipeline
+
+```
+Planner (this wiki)
+   ↓
+Plan Reviewer  (quality gate)
+   ↓
+❓ Ask Phase   (Patrick answers Open-Questions)
+   ↓
+Planner v2     (revise)
+   ↓
+Code mode      (implementation — new plate-auth repo + InspectFlow refactor + Sparkboard consumption)
+```
+
+---
+
+## 🔗 External links
+
+- **Repo:** https://git.plate-software.de/pplate/plate-auth
+- **Wiki (this site):** https://git.plate-software.de/pplate/plate-auth/wiki
+- **Consumer 1 (existing):** [InspectFlow](https://git.plate-software.de/pplate/inspectflow)
+- **Consumer 2 (incoming, greenfield):** [Sparkboard](https://git.plate-software.de/pplate/sparkboard)