#Findings summary
Inspection date: 2026-10-03. Read-only, no product code changed.
#What I found
- The V8 product doesn't exist yet in code.
frontend-2is a Next.js scaffold (shadcn primitives only).sa-central-api-2(backend-2) is a Laravel skeleton with zero API routes. - The V8 requirements cover only the start. Rules R1–R7, Phase 1 Foundation, Phase 2 Authentication & Security, Phase 3 Account. Organizations, plans, subscriptions, billing, roles, members, servers, providers, blueprints and audit are not specified for V8 yet.
- V7 is a rich functional reference (62 route files): organizations with owner/admin/custom roles, ~92 boolean permissions gated by plan tier, members with email invitations, a per-user subscription, prepaid wallet credits with Stripe/PayPal/Instamojo, invoices, auto-recharge, 7 cloud providers, WordPress blueprints, activity log, notifications.
- The OSS panel is the real backend for servers. Its Central key (
sv_central_…) signs in as a machine administrator, so Central can use almost the whole OSS API (everything in Server Details). The installer acceptsCENTRAL_TOKEN. Central-only add-on routes run WordPress blueprints. - The demo gives a good navigation and screen concept, but has no backend and some different formats (
sm_keys,level.name.view|managepermissions).
#What already exists
| Exists | Where |
|---|---|
| UI stack: Next.js 16, Tailwind v4, shadcn primitives, axios, zustand, zod, recharts, sonner, next-themes | frontend-2 |
| V8 rules for auth, tokens (Passport 15d/30d), account features, code standards | V8 doc |
| All server-management APIs (facts, metrics, apps, databases, system users, services, firewall, cron, backups, PHP, Node, Fail2ban, settings, logs…) | OSS API |
| Central connect/rotate key, add-on runs (WP Toolkit blueprint, Log Monitoring) | OSS API |
| Install-with-key for new servers | OSS installer CENTRAL_TOKEN |
#What can be reused from V7 (as logic, never code — R1)
- Organization rules: first org = main; can't delete main/only/with servers; owner + admin roles on create.
- Invitation flow (existing user vs new email + token), role assignment, owner-only removal.
- Plan tiers/cycles/limits as the shape of a plan catalog; trial logic; expiry behaviour (block server actions except delete; 15-day grace on renew).
- Wallet + transaction + verify-before-credit payment flow; auto-recharge rules; invoice data.
- Provider list + per-provider validation rules; OAuth for DigitalOcean/Linode.
- Blueprint data model (OSS already accepts exactly that shape).
- 2FA / IP whitelist / login history behaviour (already adopted by the V8 doc).
#What backend APIs exist
- Central (sa-central-api-2): none.
- OSS: everything listed in Server details and API architecture.
#What backend APIs are missing
All Central APIs, see Missing backend dependencies. The most important: session contract, auth, organizations, permission map, members, audit writer, server link + OSS proxy, plan catalog (doesn't exist even in V7), subscription, billing, dashboard aggregation. On the OSS side: alerts API (requirement 3.17 has nothing to call) and key self-revoke.
#Conflicts
| # | Conflict | Decision |
|---|---|---|
| 1 | Subscription per user (V7) vs per organization (request) | D-3 |
| 2 | Permissions boolean (V7) vs none/view/manage (OSS, demo, request) | D-7 |
| 3 | Plans hard-coded in V7 vs "everything from the API" | Plan catalog needed |
| 4 | "Store minimum server data" (R5) vs lists/dashboard needing IP/OS/app counts when offline | D-11 |
| 5 | Session cookies (project rule) vs Passport bearer tokens (V8 doc) | D-1 (BFF reconciles both) |
| 6 | Existing users join without accepting (V7) vs an accept step (request) | D-9 |
| 7 | Blueprints owned by user (V7) vs organization navigation | D-14 |
| 8 | Requirement 3.17 "server alerts from OSS" vs no OSS alerts API | D-17 |
| 9 | Disconnect can't revoke the key on OSS (admin session only) | OSS change or user instruction |
| 10 | doc.nip.io requested, but it can't resolve | Hosting |
#Recommended implementation phases
0 Foundation → 1 Auth → 2 Account → 3 Organizations + Roles + Members → 4 Audit → 5 Servers → 6 Plans + Subscription + Billing → 7 Dashboard → 8 Providers → 9 Blueprints → 10 Search + Notifications + polish → 11 Production readiness. Details and blockers: Implementation phases.
#Final document index
| Deliverable | Page |
|---|---|
| Product flow diagram | User journey, End-to-end flows |
| Architecture diagram | Architecture |
| User journey diagram | User journey |
| Module dependency diagram | Feature dependencies |
| API dependency table | API architecture |
| Route map | Route structure |
| Navigation map | Navigation |
| Permission matrix | Roles & permissions |
| Edge-case matrix | Edge cases |
| Frontend/backend responsibility matrix | Frontend vs backend |
| V7 → V8 migration considerations | V7 migration |
| Phase-wise implementation plan | Implementation phases |
| Missing backend dependencies | Missing backend |
| Open questions | Open questions |