V8 Central — Product & Technical Spec
  1. Docs
  2. Start here
  3. Findings summary

#Findings summary

Inspection date: 2026-10-03. Read-only, no product code changed.

#What I found

  1. The V8 product doesn't exist yet in code. frontend-2 is a Next.js scaffold (shadcn primitives only). sa-central-api-2 (backend-2) is a Laravel skeleton with zero API routes.
  2. 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.
  3. 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.
  4. 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 accepts CENTRAL_TOKEN. Central-only add-on routes run WordPress blueprints.
  5. The demo gives a good navigation and screen concept, but has no backend and some different formats (sm_ keys, level.name.view|manage permissions).

#What already exists

ExistsWhere
UI stack: Next.js 16, Tailwind v4, shadcn primitives, axios, zustand, zod, recharts, sonner, next-themesfrontend-2
V8 rules for auth, tokens (Passport 15d/30d), account features, code standardsV8 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 serversOSS 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

#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

#ConflictDecision
1Subscription per user (V7) vs per organization (request)D-3
2Permissions boolean (V7) vs none/view/manage (OSS, demo, request)D-7
3Plans 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 offlineD-11
5Session cookies (project rule) vs Passport bearer tokens (V8 doc)D-1 (BFF reconciles both)
6Existing users join without accepting (V7) vs an accept step (request)D-9
7Blueprints owned by user (V7) vs organization navigationD-14
8Requirement 3.17 "server alerts from OSS" vs no OSS alerts APID-17
9Disconnect can't revoke the key on OSS (admin session only)OSS change or user instruction
10doc.nip.io requested, but it can't resolveHosting

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

DeliverablePage
Product flow diagramUser journey, End-to-end flows
Architecture diagramArchitecture
User journey diagramUser journey
Module dependency diagramFeature dependencies
API dependency tableAPI architecture
Route mapRoute structure
Navigation mapNavigation
Permission matrixRoles & permissions
Edge-case matrixEdge cases
Frontend/backend responsibility matrixFrontend vs backend
V7 → V8 migration considerationsV7 migration
Phase-wise implementation planImplementation phases
Missing backend dependenciesMissing backend
Open questionsOpen questions
ServerAvatar V8 Central · prepared by central-app-2 (Pair 2 frontend) for Bhavik Jethwa · nothing in this spec is implemented yet · Built 2026-10-03 12:35 UTC