Desenvolvimento

Roteiro da Plataforma e Arquitetura

SmartWMS — Sistema Moderno de Gestão de Armazém. Esta página documenta a arquitetura da nossa plataforma, recursos atuais e roteiro de desenvolvimento.

20+ Módulos159+ Permissões17 Idiomas44/50 Funcionalidades

Arquitetura do Sistema

A plataforma é composta por 6 componentes principais que funcionam juntos em 4 subdomínios.

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

Como Tudo Se Conecta

Fluxo de requisições do navegador pela API até os armazenamentos de dados e serviços externos.


  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)

Roteiro de Desenvolvimento

8 de 9 fases concluídas. Construindo a plataforma WMS mais completa para PMEs.

Phase 1 — Core Platform

Multi-tenant architecture, authentication, permissions, dashboard

CONCLUÍDO
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

CONCLUÍDO
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

CONCLUÍDO
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

CONCLUÍDO
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

CONCLUÍDO
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

CONCLUÍDO
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

CONCLUÍDO
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

CONCLUÍDO
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

PLANEJADO
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 Tecnológico

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

Pronto para Experimentar o SmartWMS?

Inicie seu teste gratuito de 30 dias e veja como o SmartWMS pode transformar suas operações de armazém.

Comece grátisFale conosco