A · Portal Web do Tenant
Operação, telemetria, workflows e cadastro
- Cockpit do tenantKPIs acionáveis
- Operação — estado atualboard por área
- Telemetria — histórico e relatóriosabas
- Ordens de Serviço
- OS com múltiplos itens (OS-2026-01482)entrega parcial
- Criar OS (jornada guiada)
- Clientes
- Itens permanentes do tenant
- Item permanente — ficha e histórico
- Workflows (intake + processamento)
- Workflow Builder — versão publicada
- Workflow Builder — rascunho com validações
- Novo workflow / nova versão
- Etiquetas & QR — estoque por lote
- Etiquetas vinculadas a uma OS
- Equipe & Áreas
- Suporte — meus chamadosfiltros e permissões
- Abrir novo chamado
- Chamado com conversa completa
B · App Lumux Flow — modo Funcionário
QR-first, offline-first
C · App Lumux Flow — modo Cliente
Visão pública, aceite e itens permanentes
- Login por e-mail ou Google
- Seleção de empresa (multi-tenant)
- Home orientada a ações
- Minhas ordens
- Acompanhar OS (visão pública)
- Item em andamento
- Meus itens e cuidados
- Cadastrar item permanente
- Confirmar recebimento (aceite)
- Avaliação (não é consentimento publicitário)
- Endereços
- Perfil e troca de empresa
- Histórico
D · Portal Admin Lumux Flow
Superfície interna da Lumux — o tenant não acessa
- Dashboard global
- Tenants — busca e filtros
- Tenant ativo
- Tenant suspenso
- Tenant em offboarding / retenção
- Tenant descomissionado — exclusão em 60 dias
- Suporte — fila global de chamados
- Chamado no Portal Admin (mesmo thread)
- Criar tenant (8 etapas)
- Provisionamento e falhas
- Acesso excepcional time-bound
- Auditoria administrativa
- Produto: módulos, templates e configurações globais
Jornadas end-to-end
Jornada 1 — Novo cliente, novo item, OS completa
Cadastro no Portal → intake → vínculo de QR → operação → acompanhamento → entrega → aceite.
Jornada 2 — Item sem workflow definido
Nenhum workflow publicado serve; o item aguarda definição explícita. Publicar não associa nada sozinho.
Jornada 3 — Operação offline e sincronização
Eventos ficam locais, sincronizam ao reconectar, conflitos são resolvidos explicitamente.
Jornada 4 — Entrega parcial (3 itens)
Item A entregue e aceito, item B aguardando aceite, item C em processamento. Sem percentual único.
Jornada 5 — Retificação de entrega
O evento original permanece; um novo evento corrige. Aceite pode ser refeito.
Jornada 6 — Tenant suspenso e reativado
Impacto exibido antes, motivo obrigatório, auditoria append-only, dados preservados.
Jornada 7 — Suporte nativo (tenant ↔ Lumux)
Um único chamado, uma única conversa: os dois portais mostram o mesmo histórico cronológico.
Edge cases
Estados excepcionais que o protótipo precisa demonstrar
- Chamado resolvido que pode ser reaberto
- Chamado fechado (somente leitura)
- Retenção final: exclusão 60 dias após descomissionamento
- Item sem etiqueta vinculada
- Itens parados acima do limite
- Exceções operacionais
- Substituição de QR (código novo invalida o anterior)
- Casos do Workflow Builder
- Casos do App Funcionário
- Casos do App Cliente
- Falhas de provisionamento
- Acessos excepcionais ativos
O documento de handoff do protótipo está no repositório em docs/HANDOFF-PROTOTIPO.md: mapa de superfícies, rotas, componentes, jornadas, estados, decisões de UX, controles de demonstração e divergências abertas.