Pular para o conteúdo
Samara Alanna.dev

CRUD

A tela de gestão de permissões de um portal administrativo era lenta, não dava feedback de carregamento e induzia a erro de configuração. Redesenhei do design system aos sete estados de interação, documentados para handoff. Aqui eu conto o processo, os estados e as decisões.

PAPEL
Design end-to-end, de requisito a handoff
CONTEXTO
Portal administrativo interno da TecSinapse
PERÍODO
2026
ENTREGAS
65 tokens, 10 estilos de texto, 7 componentes, 7 estados
TIME
PM, designer sênior e dev
Tela principal do projeto Remake do CRUD de permissões

CONTEXTO

O problema estava todo na segunda etapa

O portal gerencia o acesso de usuários a múltiplos produtos. Cada pessoa pode ter acesso a vários produtos, com perfis distintos por produto, entre gerencial, operacional e administrativo, e funcionalidades granulares configuráveis dentro de cada perfil.

A tela de edição tinha duas etapas. A primeira, de dados básicos, funcionava bem. A segunda concentrava os problemas: carregava devagar e sem nenhum feedback visual, listava todos os produtos juntos sem separação, mostrava módulos a que a pessoa nem tinha acesso, e levava a configuração incorreta por falta de clareza.

PROCESSO

Requisito antes de tela, referência antes de resposta

  1. requisitos
  2. referências
  3. design system
  4. 3 variações
  5. 7 estados
  6. handoff

Mapeei os requisitos a partir da gravação e da transcrição da reunião, e entreguei o documento antes de desenhar qualquer tela. Depois montei 65 tokens, 10 estilos de texto e 7 componentes, e apresentei três variações de layout ao time. A escolhida foi a de busca com chips no topo e duas colunas abaixo, que libera largura para as colunas de conteúdo. Construí boa parte do arquivo por script, operando a Plugin API do Figma, com uma auditoria de geometria para conferir sobreposição e vínculo de instância junto da conferência visual.

O gestor tinha explorado uma ferramenta de IA de design como ponto de partida. Aproveitei o que servia.

Analisei os exports e separei o que funcionava do que faltava. Funcionava a divisão entre biblioteca e selecionados, e os cards com dropdown de perfil. Faltava a configuração granular de funcionalidade, os estados de interação e o feedback de erro.

ESTADOS

Cada estado documentado com anotação de handoff

Com a variação escolhida aprovada, documentei os sete estados da tela. Cada um recebeu um bloco de anotação no próprio Figma, com o contexto, as regras de comportamento, os gatilhos de transição e as observações técnicas para o time. Abaixo, quatro deles.

Estado de lista vazia

Estado de carregamento

Estado de módulo sendo adicionado

Estado de erro de validação

DECISÕES

Cada decisão amarrada a um vetor de erro

A coluna de funcionalidades fica bloqueada até o perfil ser escolhido.

Esse era o principal vetor de erro da tela anterior: dava para marcar funcionalidade antes de definir o perfil, e a configuração saía incoerente. O checkbox fica em cinza até a escolha do perfil, o que fecha o caminho errado antes de a pessoa entrar nele.

Não coloquei nenhum selo de "perfil definido".

O card de módulo configurado certo não recebe indicativo visual positivo. O estado normal já comunica sucesso. Só o erro chama atenção, e isso reduz o ruído numa tela que pode ter muitos módulos ao mesmo tempo.

IMPACTO ESPERADO

Impacto esperado. A tela ainda não foi implementada.

O que dá para afirmar é o que cada decisão resolve: o carregamento sem feedback sai com o skeleton, o erro de configuração cai com o bloqueio e a validação antes do salvar, o tempo de configuração cai com os chips e a pré-seleção por perfil, e a manutenção futura fica viável com tokens, estilos e componentes reutilizáveis.

PRÓXIMO PROJETOMíriam Araújo