Sviluppo

Roadmap della piattaforma e architettura

SmartWMS — Sistema moderno di gestione magazzino. Questa pagina documenta l'architettura della nostra piattaforma, le funzionalità attuali e la roadmap di sviluppo.

20+ Moduli159+ Permessi17 Lingue44/50 Funzionalità

Architettura del sistema

La piattaforma è composta da 6 componenti principali che lavorano insieme su 4 sottodomini.

Backend API

.NET 8 + EF Core + PostgreSQLapi.smartwms.one

Core REST API server handling auth, multi-tenant data, warehouse operations, analytics, IoT, and route optimization.

●Multi-tenant with TenantId isolation
●JWT auth with refresh tokens
●159+ role-based permissions
●SignalR for real-time notifications
●Putaway scoring algorithm
●HERE Routing API integration
●IoT telemetry & alert engine
●QC inspection workflow

Frontend App

React + TypeScript + RTK Queryapp.smartwms.one

Main warehouse management interface for operators, managers, and administrators.

●20+ modules (inventory, orders, warehouse, IoT, QC...)
●Widget dashboard (17 widgets, drag-and-drop)
●TanStack Table v8 with column visibility
●17 locale support (react-intl)
●HERE Maps for route visualization
●react-hook-form for all forms

Admin Panel

React + TypeScript + RTK Queryadmin.smartwms.one

Internal admin dashboard for platform management, tenants, plans, and content.

●Tenant & company management
●Plan & billing administration
●Blog, docs, careers CMS
●System settings & branding
●Light/dark/system theme

Landing Website

Next.js 14 + Tailwind CSSsmartwms.one

Public marketing website with pricing, features, blog, documentation, and registration.

●12 locale support (next-intl)
●Dynamic pricing from API
●Blog & documentation CMS
●Registration with business type
●SEO-optimized SSR pages

Database

PostgreSQL 15

Primary data store with multi-tenant isolation, JSON columns, and composite indexes.

●TenantId in all composite indexes
●Enums stored as strings
●JSONB columns for flexible data
●EF Core migrations (version-controlled)
●40+ tables across 10+ modules

External Services

HERE API + SignalR

External service integrations for maps, geocoding, route optimization, and real-time events.

●HERE Geocoding & Search API
●HERE Routing API v8 (matrix, route)
●Address autocomplete (5 forms)
●SignalR WebSocket hub

Come si collega tutto

Flusso di richieste dal browser attraverso l'API agli archivi dati e ai servizi esterni.


  Browser (User)             Browser (Admin)            Browser (Visitor)
      |                           |                          |
      v                           v                          v
  +-----------+            +-----------+              +-----------+
  | Frontend  |            |   Admin   |              | Landing   |
  | React     |            | React     |              | Next.js   |
  | app.*     |            | admin.*   |              | *.one     |
  +-----------+            +-----------+              +-----------+
      |                           |                          |
      |  RTK Query                |  RTK Query               |  fetch/SSR
      |  /api/v1/tenant/{id}/*    |  /api/v1/admin/*          |  /api/v1/*
      v                           v                          v
  +------------------------------------------------------------+
  |                    Backend API (.NET 8)                     |
  |                    api.smartwms.one                         |
  |                                                            |
  |  Auth | Inventory | Orders | Warehouse | IoT | QC |        |
  |  Traceability | Analytics | Reports | Routes | Roles       |
  +------------------------------------------------------------+
      |             |              |
      v             v              v
  +--------+   +---------+   +---------+
  |Postgres|   | SignalR  |   |HERE API |
  |  :5432 |   | WebSocket|   | Maps    |
  +--------+   +---------+   +---------+
      |
      v
  EF Core Migrations (version-controlled schema)

Roadmap di sviluppo

8 di 9 fasi completate. Stiamo costruendo la piattaforma WMS più completa per le PMI.

Phase 1 — Core Platform

Multi-tenant architecture, authentication, permissions, dashboard

COMPLETATO
Multi-tenant architecture with complete data isolation
JWT authentication with refresh token rotation
Role-based access control (159+ permissions)
Interactive dashboard with 14+ real-time endpoints
Inventory management (products, categories, stock levels)
Order management (sales, purchase, customers, suppliers)
Multi-warehouse & multi-site support

Phase 2 — Warehouse Operations

Full inbound/outbound workflow, zones, locations, transfers

COMPLETATO
Goods receiving with quality inspection
Putaway with scoring algorithm & auto-assign
Wave picking with optimized task sequencing
Packing & shipping management
Zone & location management (types, dimensions, capacity)
Inter-warehouse transfers & stock adjustments
Slotting optimization (ABC analysis)

Phase 3 — Analytics & Reports

ABC analysis, worker productivity, fulfillment rates, 5 report types

COMPLETATO
ABC analysis for inventory classification
Worker productivity analytics
Fulfillment rate reports
5 report types: inventory, movements, orders, receiving, utilization
Equipment asset management

Phase 4 — IoT & Monitoring

Device management, sensor telemetry, automated alerts

COMPLETATO
IoT device management with heartbeat monitoring
Sensor telemetry ingestion (temperature, humidity, etc.)
Alert rules with automatic evaluation
IoT dashboard with offline device tracking
25 API endpoints, 16 permissions

Phase 5 — Traceability & QC

Lot tracking, quality inspections, holds management

COMPLETATO
Lot traceability (quarantine, recall, release, FIFO)
Event timeline for complete lot history
Expiring lot alerts & recall search
QC inspection templates with dynamic checklists
Pass/Fail/NA checklist UI with auto-hold on defects
QC dashboard with inspection statistics

Phase 6 — Route Optimization

HERE Maps integration, TSP solver, delivery route management

COMPLETATO
HERE Routing API integration (geocoding, matrix, routing)
Nearest-neighbor TSP solver with time windows
Delivery route management UI with interactive maps
Address autocomplete in 5 forms (HERE API)
8 delivery permissions, full CRUD + optimize

Phase 7 — Dashboard & UX

Widget dashboard, column visibility, enhanced putaway scoring

COMPLETATO
Widget dashboard with 17 drag-and-drop widgets
Responsive grid layout (react-grid-layout, 5-col)
Column visibility toggle for all 53 data tables
Enhanced putaway scoring (dimensions, weight, capacity)
Layout persistence in localStorage

Phase 8 — Business Onboarding

Business type selector, auto-provisioning, Lite plan

COMPLETATO
Business type selector (E-commerce / Small Business)
Auto-provisioning for small business (site, warehouse, zones, locations)
Lite plan at 19/mo with reduced permission set (38 permissions)
Permission-based feature gating (automatic sidebar filtering)

Phase 9 — Mobile & Integrations

Mobile app, barcode scanning, automation rules, marketplace connectors

PIANIFICATO
Progressive Web App for warehouse floor operations
Camera-based barcode scanning (QR, EAN-13, Code-128)
Automation rules engine (triggers, conditions, actions)
Marketplace connectors (Amazon, eBay, Shopify)
Webhook system for real-time event notifications
Public REST API with API key management

Stack tecnologico

Backend

.NET 8

ASP.NET Core

Entity Framework Core

PostgreSQL

SignalR

ASP.NET Identity

Frontend

React 18

TypeScript

RTK Query

TanStack Table v8

react-hook-form

react-grid-layout

Landing

Next.js 14

Tailwind CSS

next-intl

Framer Motion

TypeScript

lucide-react

Infrastructure

PostgreSQL 15

systemd

PM2

nginx

HERE API

Linux

Auth & Security

JWT + Refresh Tokens

ASP.NET Identity

RBAC (159+ perms)

Multi-tenant isolation

GDPR compliant

DevOps

Git

rsync deploy

systemd services

EF Core migrations

webpack (UI)

dotnet publish

Pronti a provare SmartWMS?

Iniziate la vostra prova gratuita di 30 giorni e scoprite come SmartWMS può trasformare le operazioni del vostro magazzino.

Inizia gratisContattaci