WorkSpace ERP Demo — Developer Handoff

Interactive prototype aligned to production architecture. Use this portal to onboard backend (Spring Boot) and frontend (React + Node.js) teams.

Java Spring Boot React + Node.js Shared multi-tenant DB Optional dedicated DB Multi-company isolation UUID entity model Modular monolith Cloud agnostic

Open interactive app Version hub

Architecture

System context, tenancy models, modular monolith boundaries, cloud deployment.

docs/ARCHITECTURE.md

Handoff guide

Phase-by-phase bootstrap for backend and frontend repositories.

docs/HANDOFF.md

Entity model

Tenant-global unique IDs, scope columns, ERD, table naming.

docs/ENTITY-MODEL.md

Module map

Prototype modules → Spring packages → React feature folders.

docs/MODULE-MAP.md

OpenAPI contract

REST API v3.1 — finance, structure, approval, platform.

docs/openapi/ws-api-v3.yaml

Code manifests

Machine-readable architecture and entity schema registries.

js/core/architecture.js · entity-schema.js

Production scaffolds

Spring Boot and React starter repos aligned to Demo architecture — bootstrap Phase 1 from HANDOFF.md.

scaffold/ws-backend · scaffold/ws-frontend

API client (prototype → production)

Default mode uses localStorage. Switch to HTTP when Spring Boot API is available:

WSApp.config.apiMode = "http";
WSApp.config.apiBaseUrl = "https://api.dev.example.com/api/v1";

Context headers (production)

Authorization: Bearer <jwt>
X-WS-Tenant-Id: <uuid>
X-WS-Company-Id: <uuid>
X-Request-Id: <correlation-id>