Visão Geral

O que é o Muvien?

O Muvien é uma plataforma de gestão logística que permite configurar, organizar e otimizar operações de transporte e expedição. O sistema centraliza o gerenciamento de armazéns, docas, transportadoras, grades de entrega, regras de cálculo de frete e mapeamento de CEP em uma única interface multi-tenant e multi-idioma.

Objetivo

Fornecer às operações logísticas uma ferramenta completa para configurar toda a cadeia de transporte — desde o cadastro de hubs e docas até a simulação de frete — eliminando planilhas e processos manuais dispersos.

Escopo

Dentro do escopo:

• Gestão operacional: armazéns, docas, modalidades, tipos de carga, calendários e operações de doca
• Transporte: transportadoras, serviços, grades de entrega e regras de cálculo
• Comercial: plataformas de venda, categorias de produto e canais
• Cobertura geográfica: mapeamento de CEP e bases de referência
• Simulação de frete
• Gestão de usuários, convites, grupos e permissões por organização

Módulos do Sistema

Módulo	Responsabilidade
Operacional	Armazéns, docas, modalidades, tipos de carga, calendários, operações de doca
Transporte	Transportadoras, serviços, grades de entrega, regras de cálculo
Comercial	Plataformas de venda, categorias de produto, canais
CEP	Mapeamento de CEPs para regiões e bases de referência
Simulador de Frete	Simulação de custos com base nas configurações de transporte
Usuários e Grupos	Membros, convites, roles e permissões por organização

Contexto Técnico

• Front-end: Next.js 16 (App Router) com React 18, TypeScript e Tailwind CSS
• Back-end: API REST (endpoints sob /api/v1/)
• Multi-tenancy: Cada organização é um tenant isolado, identificado pelo businessID na URL e header Tenant-ID
• Internacionalização: Português, Inglês e Espanhol (next-intl)
• Autenticação: JWT com refresh automático (access + refresh tokens em cookies)
• Permissões: Sistema granular recurso:ação com verificação no front-end via componente <Can> e store Zustand