Floorix

Floorix is a multi-tenant SaaS platform for factory operations management. It handles job tracking, worker wage calculation, article management, and dynamic per-tenant schemas — all with strict tenant isolation.

Components

Component	URL	Description
Client App	floorix.net	Factory floor app for workers and admins
Admin Dashboard	admin.floorix.net	Super Admin dashboard for tenant and schema management
API	api.floorix.net	REST backend (Node.js/Express/MongoDB)

Quick Links

• Architecture — system diagram, service boundaries
• API Reference — all endpoints with request/response shapes
• Workflows — job lifecycle, wage calculation, tenant provisioning
• Authentication — Supabase JWT, SSO, tenant context
• Getting Started — first-time setup guide

Platform Integration

Floorix is part of the DotEvolve platform. Authentication, tenant management, billing, and subdomain provisioning are all handled by the Central Portal — not by Floorix itself.

graph LR
    A[User] -->|Login| B[Supabase Auth]
    B -->|JWT with app_metadata| C[Floorix Client]
    C -->|Bearer JWT| D[Floorix API]
    D -->|activeTenantId from JWT| E[MongoDB Atlas]
    D -->|plan limits| F[Portal API]
    B -->|app_metadata| G[Admin Portal]
    G -->|manage tenants/users| F

Key Concepts

Concept	Description
TenantConfig	Per-tenant schema: job steps, article attributes, size range. Managed in the admin dashboard.
Job	A production batch with line items (article + sizes + attributes) and sequential steps.
Worker	A factory worker assigned to job steps; earnings tracked via ledger entries.
Article	A product type with per-step wage rates (stepRates).
Plan Limits	Fetched from Portal API at request time (Redis-cached). Controls max users, workers, job steps, article attributes.
Tenant Isolation	Every MongoDB query is automatically scoped to activeTenantId from the JWT.